获取会话列表

GET

/chat/list

📌

使用场景
此接口用来批量拉取对应小组内的所有会话数据，因为数据量比较大，且系统内的数据库是读写分离的，因此这个接口拉取到的数据可能会有延迟不准确的情况，

请求参数

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://zan-api.xiaoshunai.com/chat/list?token=669dc78a7*****3e04351d6&iterator=686e4ed1bae448bf1f0ca055&pageSize=5'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "data": {
        "chats": [
            {
                "chatId": "686e4ed0b****bf1f0c9f47",
                "assigneeId": "",
                "botId": "686e4e9bd****f7b98919e69",
                "type": 0,
                "wxid": "78813****347451",
                "avatarUrl": "",
                "name": "test",
                "extraInfo": null,
                "contactType": 3,
                "coworker": false,
                "corporation": "测试科技",
                "externalUserId": "wmrRhyBgAAvw*****AoGkAYsUo6XzCQ"
            }
        ],
        "nextIterator": "686e4ecfbae448bf1f0c9ecf"
    }
}

修改于 2025-07-10 06:11:00

会话ai状态切换

会话事件回调