传递访客资料

如果对话链接接入的网站或者 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 参数静态传值。
本篇目录