获取指定客户的单聊列表

请求方式

GET

请求地址

https://nbd-api.myscrm.cn/open-nbd-qw-msgaudit/v1/single-chat/list-by-external-user

请求参数

示例

https://xxxx.com/xxxx?app_id=xxxx&external_userid=xxxx&cursor=xxxx&qw_user_ids=xx,xxx&sort_type=2

说明

参数	类型	必须	说明
app_id	string	是	企微中台应用 id
external_userid	string	是	外部联系人 id
cursor	string	否	分页游标，上一次请求返回的 next_cursor，第一页传空
qw_user_ids	string	否	企微成员id列表，多个id之间用英文逗号分割，支持最大数量100个
sort_type	int32	否	排序类型，默认值为0; 0-按照聊天时间降序 1-按照总聊天消息数降序 2-按照员工聊天消息数降序 3-按照外部联系人消息数降序

返回参数

示例

{
  "errcode": 0,
  "errmsg": "ok",
  "next_cursor": "xxxx",
  "list": [
    {
      "qw_user_id": "a1",
      "chat_id": "39febb6a-81f3-0b9a-5698-79041b85d947",
      "has_agreed_msgaduit": true,
      "last_chat_at": "1547087894783",
      "msg_count": "10",
      "external_user_msg_count": "4",
      "qw_user_msg_count": "6"
    }
  ]
}

说明

参数	类型	必须	说明
next_cursor	string	是	下一页游标，当记录数超过一定数量时返回，为空时表示已没有更多数据可获取
list	object[]	是	客户的会话列表，按最近聊天时间倒序返回
list.qw_user_id	string	是	员工 id
list.chat_id	string	是	聊天 id
list.is_agree_msgaduit	bool	是	是否同意会话存档
list.last_chat_at	string	是	最近聊天时间，毫秒时间戳
list.msg_count	string	是	聊天总消息数（外部联系人+成员聊天消息数，含撤回消息数）
list.external_user_msg_count	string	是	外部联系人消息数（含撤回消息数）
list.qw_user_msg_count	string	是	成员消息数（含撤回消息数)