传递访客资料
如果对话链接接入的网站或者 APP 有会员系统,可以在会员在线咨询客服时通过 URL 参数传递会员的头像、昵称、联系方式等资料,以便客服迅速识别访客以提供更高效的服务。
使用前提:本接口面向具备前端开发能力的技术人员,调用前请确保已获取客源多对话链接基础 URL(即含
appid 参数的链接)。接口能力概览
访客 id:visitorid=访客id
访客名称:visitorname=访客名称
访客头像:avatar=访客头像URL
自定义参数:extra=自定义参数值
位置:对话链接 URL 查询参数
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
visitorid |
string | 访客 id,由字母数字组成,长度大于 6 位,用于唯一标识访客身份 |
visitorname |
string | 访客名称,展示在客服端的访客昵称 |
avatar |
string | 访客头像 URL |
extra |
string | 自定义参数,主要应用于企业信息对接功能 |
示例代码
传递访客 id
// visitorid 参数,参数值为访客 id,由字母数字组成,长度大于 6 位
http://www.域名.net/chat?appid=######&visitorid=访客id
传递访客名称
// visitorname 参数,参数值为访客名称
http://www.域名.net/chat?appid=######&visitorname=访客名称
传递访客头像
// avatar 参数,参数值为访客头像 URL
http://www.域名.net/chat?appid=######&avatar=访客头像
传递自定义参数
// extra 参数,参数值为自定义传参,主要应用于企业信息对接功能
http://www.域名.net/chat?appid=######&extra=自定义参数值
相关文档:
如果是通过网页 JS-SDK 接入,请参考 网页 - 自定义客户资料。两者差异:网页 SDK 适合动态同步登录后的会员资料(字段更丰富);对话链接方式适合无 JS 环境,通过 URL 参数静态传值。