获取会话内容(智能专区模式)
最后更新:2025/2/14获取企业在智能专区模式下的会话内容(智能专区模式下仅可获取会话内容记录信息,无法获取会话原文)
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/chatdata/list
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数
{
"start_time": 1725288444517,
"end_time": 1725288444517,
"page_size": 5,
"cursor": "1725288444517",
"chat_id": "wrDkH9EAAAEHN0fQiW3gQRHqfXiRsKSA",
"sender_id": "woDkH9EAAAlQHoHTPdcAVExavwL88z2g",
"receiver_id": "wmDkH9EAAAlQHoHTPdcAVExavwL77z2g",
"chat_type": 1,
"sender_type": 1,
"receiver_type": 1,
"location_down_msg_time": 1725288444517,
"order_type": 1
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
start_time | long | 是 | 开始时间 |
end_time | long | 是 | 结束时间,最多查询31天范围内的时长 |
page_size | int | 否 | 列表返回长度.最小值为1,最大值为1000,不传默认10 |
cursor | string | 否 | 上一页消息的发送时间sendTime(翻页游标) |
chat_type | int | 否 | 会话关系类型:1:单聊;2:群聊(查群聊记录时不传接收人信息) |
sender_id | string | 否 | 发送人id(三方应用下的用户id) |
sender_type | int | 否 | 发送人类型 1、内部联系人;2、外部联系人 |
receiver_id | string | 否 | 接收人id (三方应用下的用户id,查群聊会话记录时不传) |
receiver_type | int | 否 | 接收人类型 1、内部联系人;2、外部联系人 (查群聊时,不传接收人信息) |
chat_id | string | 否 | 群聊id(支持内部群和外部群) |
order_type | int | 否 | 排序方式 降序1(按会话发送时间倒序,最新的在第一条) 升序2(按会话发送时间正序,最早的在第一条),默认降序 |
返回值:
{
"code": "00000",
"msg": "OK",
"data": [
{
"id": "1796471473112658433",
"msg_id": "mALT0UaUleX-Vo_0D4ZYpmLsogmstXyCIRVOLlhxy6t4T",
"sender_type": 2,
"sender_id": "wmDkH9EAAA_hFWcF36wd6SGeKvqH6Isw",
"receiver_id_list": [
"woDkH9EAAASHMu5R5FlG62Ux-BWtX-WQ"
],
"receiver_type_list": [
1
],
"chat_id": null,
"send_time": "1717147125000",
"msg_type": 1,
"relation_id": "1697879520252508141_wmDkH9EAAA_hFWcF36wd6SGeKvqH6Isw_woDkH9EAAASHMu5R5FlG62Ux-BWtX-WQ_1",
"chat_type": 1
},
{
"id": "1796471340094501377",
"msg_id": "mALT0UaUleX-Vo_0D4ZYpmLsiE5m81F4uXK8o0ZVwGFKe",
"sender_type": 2,
"sender_id": "wmDkH9EAAA_hFWcF36wd6SGeKvqH6Isw",
"receiver_id_list": [
"woDkH9EAAASHMu5R5FlG62Ux-BWtX-WQ"
],
"receiver_type_list": [
1
],
"chat_id": null,
"send_time": "1717147117000",
"msg_type": 1,
"relation_id": "1697879520252508141_wmDkH9EAAA_hFWcF36wd6SGeKvqH6Isw_woDkH9EAAASHMu5R5FlG62Ux-BWtX-WQ_1",
"chat_type": 1
}
]
}
返回说明:
参数 | 类型 | 说明 | |
---|---|---|---|
msg | string | 返回码描述 | |
data | list | 集合对象 | |
id | long | id | |
msg_id | string | 会话id | |
sender_type | int | 消息发送者身份类型。1:员工;2:外部联系人; 3:机器人 | |
sender_id | string | 消息发送者的id | |
chat_id | string | 群聊消息的群id(仅群聊里的消息有此信息) | |
receiver_id_list | array | 消息接收方id列表 | |
receiver_type_list | array | 消息接收方类型列表 1:员工;2:外部联系人; 3:机器人 | |
send_time | long | 消息发送时间戳 | |
msg_type | int | 消息类型 | |
chat_type | int | 会话关系类型:1:单聊;2:群聊 |
消息类型说明
消息类型 | 说明 |
---|---|
0 | 暂不支持的消息类型 |
1 | 文本 |
2 | 图片 |
3 | 表情 |
4 | 链接 |
5 | 小程序 |
6 | 语音 |
7 | 视频 |
8 | 文件 |
9 | 名片 |
10 | 转发消息 |
11 | 视频号 |
12 | 日程 |
13 | 红包 |
14 | 地理位置 |
15 | 快速会议 |
16 | 待办 |
17 | 投票 |
18 | 在线文档 |
19 | 图文消息 |
20 | 图文混合消息 |
21 | 音频存档 |
22 | 音视频通话 |
23 | 微盘文件 |
24 | 同意会话存档 |
25 | 拒绝会话存档 |
26 | 群接龙 |
27 | markdown |