谱蓝云 OpenAPI
  1. 客户群
谱蓝云 OpenAPI
  • 接入指南
    • 基本概念介绍
    • 开发前必读
    • 获取 access_token
      GET
  • 回调通知
    • 客户
    • 组织架构
    • 商机
  • 获客拉新
    • 渠道活码
    • 加微任务
  • 客户管理
    • 企微客户
      • 获取客户商机记录
      • 更新客户资料
      • 更新客户标签
      • 创建客户动态
      • 获取客户标签数据
      • 获取客户资料信息
      • 获取客户关系与所在群聊
      • 开发中心-客户业务线归属
      • 搜索客户列表
      • 更新同步客户信息
    • 客户群
      • 客户群分页查询
        POST
    • 标签任务
  • 客户运营
    • 客户群发
    • 企微朋友圈
    • 群群发
      • 创建群群发任务
  • 营销活动
    • 营销 SOP
    • 直播管理
  • 内容中心
    • 基础素材
      • 创建基础素材
    • 自定义表单
      • 获取指定表单数据
  • 销售管理
    • 线索管理
      • 创建线索
    • 商机管理
      • 创建商机
      • 跟进商机
    • 工作日历
      • 创建日程
  • 会话存档
    • 聊天记录
      • 查询员工与客户的记录
  • 数据中心
    • 客户联系统计
  • 组织架构
  • 应用通知
    • 创建应用通知
  • 内部标签
    • 获取企业内部标签库
    • 添加内部标签
    • 编辑内部标签
    • 删除内部标签
    • 给线索打标签
    • 移除线索身上的标签
    • 给客户打标签
    • 移除客户身上的标签
  1. 客户群

客户群分页查询

POST
/open-api/customer/chat-group/page
最后修改时间:2025-03-10 10:15:22
根据条件查询客户群列表。

请求参数

Header 参数
Authorization
string 
可选
默认值:
Bearer {{auth_token}}
Body 参数application/json
客户管理 - 查询客户群 Request VO
cursorId
integer <int64>
可选
游标ID, 传上次数据集中的最大GroupID进行分页查询
customerIds
array[integer <int64>]
客户ID
可选
>= 0 items<= 2000 items
ownerIds
array[integer <int64>]
群主id
可选
>= 0 items<= 2000 items
tags
array[string]
群标签名
可选
>= 0 items<= 2000 items
tagRelationship
boolean 
可选
标签条件关系, 且-true, 或-false, 默认为true
groupName
string 
群名
可选
示例
{
    "cursorId": 0,
    "customerIds": [
        0
    ],
    "ownerIds": [
        0
    ],
    "tags": [
        "string"
    ],
    "tagRelationship": true,
    "groupName": "string"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/open-api/customer/chat-group/page' \
--header 'Authorization: Bearer {{auth_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cursorId": 0,
    "customerIds": [
        0
    ],
    "ownerIds": [
        0
    ],
    "tags": [
        "string"
    ],
    "tagRelationship": true,
    "groupName": "string"
}'

返回响应

🟢200成功
application/json
Body
code
integer 
可选
data
object (OpenPlatformChatGroupRespVO) 
可选
开放平台 - 客户群查询
groupChatList
array[object (OpenPlatformChatGroupDetailRespVO) {8}] 
客户群列表
可选
hasNextPage
boolean 
是否还有下一页
可选
cursorId
integer <int64>
可选
游标id, 请求下一页数据时需要携带
msg
string 
可选
requestId
string 
可选
示例
{
    "code": 0,
    "data": {
        "groupChatList": [
            {
                "chatId": "string",
                "groupId": 0,
                "groupName": "string",
                "ownerId": "string",
                "ownerName": "string",
                "tags": [
                    "string"
                ],
                "memberCount": 0,
                "createTime": "2019-08-24T14:15:22Z"
            }
        ],
        "hasNextPage": true,
        "cursorId": 0
    },
    "msg": "string",
    "requestId": "string"
}
上一页
更新同步客户信息
下一页
创建群群发任务
Built with