Skip to content

获取聊天记录

GET /agent/message/get

获取指定访客的历史消息;默认包含该访客与所有客服的消息,传入限制参数后可只读取单个客服会话范围。

请求参数

字段位置类型必填用途
idquerystring访客 UID。
limitquerynumber默认 20,最大 100
midquerynumber向前翻页游标。
only_kfquerynumber | boolean非空时仅查询当前客服会话范围。
agent_idquerynumber指定客服会话范围;仅当前客服或管理员可使用。

成功响应

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"
    }
  ]
}
字段类型用途
dataarray时间正序消息列表。
data[].midnumber消息 ID。
data[].fromstring | number发送方 UID 或客服 ID。
data[].contentstring原始消息内容。
data[].translated_contentstring已保存译文;没有时为空字符串。
data[].authorstringvisitoragent
data[].readedstring已读状态。

查询成功后会清空当前客服在该访客会话中的未读计数。