Appearance
分配客服
POST /visitor/chatting/find
为当前 Token 对应的访客分配一个客服。访客页在获取基础数据后调用;服务端会优先复用在线历史客服,再按机器人和分组候选规则选择客服。
请求参数
| 字段 | 位置 | 类型 | 必填 | 用途 |
|---|---|---|---|---|
groupid | body | number | 是 | 客服分组 ID;默认分组传 0。 |
lang | body | string | 否 | 访客语言。未传时服务端按访客、客服和 Accept-Language 解析。 |
uniqueId | body | string | 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_id | string | number | 后续获取消息、发送消息和输入状态必须传递的客服 ID。 |
data.nickname | string | 客服展示昵称。 |
data.signature | string | 客服签名;未设置时为空字符串。 |
data.state | string | 分配结果中的客服状态。 |
data.avatar | string | 客服头像地址。 |
data.greeting | string | 当前响应固定清空;问候语由 message.created 实时事件下发。 |
data.translate | string | 客服翻译开关。 |
data.visitor_lang | string | 客服面向访客的语言偏好。 |
data.level | string | 客服账户角色,例如普通客服或机器人。 |
data.groupid | number | 本次会话所属分组。 |