用户基础信息对接 | 99客服使用手册

用户基础信息对接用于把业务系统中的用户身份传递给客服系统。支持传递用户 ID、昵称和头像，客服接待时可以直接识别访客身份。
正式网站建议使用安全传递方式。用于生成身份凭证的安全密钥只能保存在网站服务器中，不能写入网页代码。详细的配置方式请参阅 API 密钥。
普通传递直接在接入代码中填写用户基础信息：
使用普通传递前，在 客服端 → 菜单 → 功能设置 中开启“允许明文传输访客数据”，并保存设置。由于信息直接来自网页，客服系统无法确认这些资料是否经过用户身份验证。
安全传递时，网页不直接填写用户编号，而是向网站服务器请求身份凭证：
/api/visitor-token 由网站服务器实现：先根据当前登录状态取得用户资料，再使用安全密钥生成身份凭证并返回。网页将凭证交给客服系统完成身份校验，安全密钥始终留在服务器中。
令牌由 header.payload.signature 三部分组成：
系统收到令牌后会用同一业务的 API 密钥重新计算签名；签名一致后，才接受令牌中的用户 ID、昵称和头像。
以下示例使用 Jackson 的 ObjectMapper 生成 JSON：
普通传递和安全传递都可以传递以下基础信息：
接入基础信息后，客服端会在会话标题和访客资料区域显示访客昵称、头像及用户 ID，便于客服识别当前访客。
Copyright © 成都风禾网络科技有限公司