Skip to content

获取访客详情

GET /agent/visitor/get

在当前客服所属商户中查询一个访客,并返回基础资料、扩展属性、咨询上下文和标签。

请求参数

至少传入其中一个查询条件。

字段位置类型必填用途
uidquerystring访客 UID。
usernamequerystring访客用户名。

成功响应

data 是当前 visitor 表的访客资料(不含内部 id),并追加 attributescontextstags

json
{
  "code": 0,
  "msg": "ok",
  "data": {
    "uid": "<访客 UID>",
    "nickname": "<访客昵称>",
    "avatar": "<头像地址>",
    "attributes": [],
    "contexts": [],
    "tags": []
  }
}
字段类型用途
data.uidstring访客 UID。
data.nicknamestring服务端解析后的展示昵称。
data.avatarstring访客头像地址。
data.attributesarray访客扩展属性。
data.contextsarray访客咨询上下文。
data.tagsarray访客当前标签。