Appearance
获取访客详情
GET /agent/visitor/get
在当前客服所属商户中查询一个访客,并返回基础资料、扩展属性、咨询上下文和标签。
请求参数
至少传入其中一个查询条件。
| 字段 | 位置 | 类型 | 必填 | 用途 |
|---|---|---|---|---|
uid | query | string | 否 | 访客 UID。 |
username | query | string | 否 | 访客用户名。 |
成功响应
data 是当前 visitor 表的访客资料(不含内部 id),并追加 attributes、contexts、tags:
json
{
"code": 0,
"msg": "ok",
"data": {
"uid": "<访客 UID>",
"nickname": "<访客昵称>",
"avatar": "<头像地址>",
"attributes": [],
"contexts": [],
"tags": []
}
}| 字段 | 类型 | 用途 |
|---|---|---|
data.uid | string | 访客 UID。 |
data.nickname | string | 服务端解析后的展示昵称。 |
data.avatar | string | 访客头像地址。 |
data.attributes | array | 访客扩展属性。 |
data.contexts | array | 访客咨询上下文。 |
data.tags | array | 访客当前标签。 |