Skip to content

分配客服

POST /visitor/chatting/find

为当前 Token 对应的访客分配一个客服。访客页在获取基础数据后调用;服务端会优先复用在线历史客服,再按机器人和分组候选规则选择客服。

请求参数

字段位置类型必填用途
groupidbodynumber客服分组 ID;默认分组传 0
langbodystring访客语言。未传时服务端按访客、客服和 Accept-Language 解析。
uniqueIdbodystring | number客户端关联标识,仅用于问候语实时事件关联。

成功响应

尖括号内字段为运行时值。机器人客服的部分字段由账户配置决定。

json
{
  "code": 0,
  "msg": "ok",
  "data": {
    "agent_id": "<客服 ID>",
    "nickname": "<客服昵称>",
    "signature": "<客服签名>",
    "state": "<online 或 offline>",
    "avatar": "<客服头像 URL 或相对路径>",
    "greeting": "",
    "translate": "<on 或 off>",
    "visitor_lang": "<客服面向访客的语言代码>",
    "level": "<客服角色>",
    "groupid": 0
  }
}
字段类型用途
data.agent_idstring | number后续获取消息、发送消息和输入状态必须传递的客服 ID。
data.nicknamestring客服展示昵称。
data.signaturestring客服签名;未设置时为空字符串。
data.statestring分配结果中的客服状态。
data.avatarstring客服头像地址。
data.greetingstring当前响应固定清空;问候语由 message.created 实时事件下发。
data.translatestring客服翻译开关。
data.visitor_langstring客服面向访客的语言偏好。
data.levelstring客服账户角色,例如普通客服或机器人。
data.groupidnumber本次会话所属分组。