服务商可调用接口对企业的群会话名称进行搜索
权限说明
对于搜索会话名称,仅支持有命名的群聊,对于单聊和未命名的群聊不支持搜索
搜索会话名称时,基于当前最新的会话名称搜索
应用类型 | 权限要求 |
---|---|
自建应用 | 暂不支持 |
代开发应用 | 暂不支持 |
第三方应用 | 暂不支持 |
会话存档接口授权 | 需具备「会话存档接口权限- 使用展示组件」权限 |
请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/chatdata/search_chat?access_token=ACCESS_TOKEN
请求包体:
{
"query_word": "VIP",
"limit": 50,
"cursor": "CURSOR"
}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
query_word | 是 | 搜索的文本,要求大于等于2个UTF8字符。 |
limit | 否 | 用于分页查询,每次请求返回的数据上限。最大为100,不填默认为50 |
cursor | 否 | 用于分页查询的游标,字符串类型,由上一次调用返回,首次调用可不填 |
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"has_more": 1,
"next_cursor": "CURSOR",
"chat_list":[
{
"chatid": "CHATID1"
},
{
"chatid": "CHATID2"
}
]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 错误码 |
errmsg | 错误码说明 |
has_more | 是否还有更多数据未获取,不填默认为0 0: 否 1: 是 |
next_cursor | 下一次请求的cursor值 |
chat_list | 搜索结果的群列表 |
chatid | 群聊会话id |