登录
基础
连接微信
办公
第三方应用开发 服务端API 会话内容存档 会话搜索 会话名称搜索
会话名称搜索
最后更新：2024/01/25
服务商可调用接口对企业的群会话名称进行搜索
权限说明
对于搜索会话名称，仅支持有命名的群聊，对于单聊和未命名的群聊不支持搜索
搜索会话名称时，基于当前最新的会话名称搜索
| 应用类型 | 权限要求 |
|---|---|
| 自建应用 | 暂不支持 |
| 代开发应用 | 暂不支持 |
| 第三方应用 | 暂不支持 |
| 会话存档接口授权 | 需具备「会话存档接口权限- 使用展示组件」权限 |
请求方式： 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 |
- 会话名称搜索
本节内容
