wecomteam--wecom-cli/skills/wecomcli-msg/references/get-msg-chat-list.md

get_msg_chat_list API

获取指定时间范围内有消息的会话列表，支持分页查询。

参数说明

参数	类型	必填	说明
begin_time	string	✅	拉取开始时间，格式：YYYY-MM-DD HH:mm:ss
end_time	string	✅	拉取结束时间，格式：YYYY-MM-DD HH:mm:ss
cursor	string	❌	分页游标，首次请求不传，后续传入上次响应的 next_cursor，最大长度 256

请求示例

wecom-cli msg get_msg_chat_list '{"begin_time": "2026-03-11 00:00:00", "end_time": "2026-03-17 23:59:59"}'

分页请求：

wecom-cli msg get_msg_chat_list '{"begin_time": "2026-03-11 00:00:00", "end_time": "2026-03-17 23:59:59", "cursor": "NEXT_CURSOR"}'

返回字段

字段	类型	说明
errcode	integer	返回码，0 表示成功
errmsg	string	错误信息
chats	array	会话列表
chats[].chat_id	string	会话 ID
chats[].chat_name	string	会话名称
chats[].last_msg_time	string	最后一条消息时间，格式：YYYY-MM-DD HH:mm:ss
chats[].msg_count	integer	消息数量
has_more	boolean	是否还有更多数据
next_cursor	string	分页游标，用于下一次请求

响应示例

{
    "errcode": 0,
    "errmsg": "ok",
    "chats": [
        {
            "chat_id": "CHAT_ID",
            "chat_name": "张三",
            "last_msg_time": "2026-03-17 15:30:45",
            "msg_count": 128
        },
        {
            "chat_id": "CHAT_ID_2",
            "chat_name": "项目讨论群",
            "last_msg_time": "2026-03-16 09:12:33",
            "msg_count": 56
        }
    ],
    "has_more": true,
    "next_cursor": "NEXT_CURSOR"
}