Appearance
获取聊天记录
GET /agent/message/get
获取指定访客的历史消息;默认包含该访客与所有客服的消息,传入限制参数后可只读取单个客服会话范围。
请求参数
| 字段 | 位置 | 类型 | 必填 | 用途 |
|---|---|---|---|---|
id | query | string | 是 | 访客 UID。 |
limit | query | number | 否 | 默认 20,最大 100。 |
mid | query | number | 否 | 向前翻页游标。 |
only_kf | query | number | boolean | 否 | 非空时仅查询当前客服会话范围。 |
agent_id | query | number | 否 | 指定客服会话范围;仅当前客服或管理员可使用。 |
成功响应
json
{
"code": 0,
"msg": "ok",
"data": [
{
"mid": 1024,
"from": "<访客 UID 或客服 ID>",
"nickname": "<发送者昵称>",
"avatar": "<发送者头像>",
"timestamp": 1730000000,
"content": "<消息正文>",
"translated_content": "<译文或空字符串>",
"sub_type": "message",
"author": "visitor",
"readed": "readed"
}
]
}| 字段 | 类型 | 用途 |
|---|---|---|
data | array | 时间正序消息列表。 |
data[].mid | number | 消息 ID。 |
data[].from | string | number | 发送方 UID 或客服 ID。 |
data[].content | string | 原始消息内容。 |
data[].translated_content | string | 已保存译文;没有时为空字符串。 |
data[].author | string | visitor 或 agent。 |
data[].readed | string | 已读状态。 |
查询成功后会清空当前客服在该访客会话中的未读计数。