本文将介绍您将在线客服链接嵌入 App 后,该在线客服链接可与 App 中用户昵称等相关参数进行对接,同时支持将自定义字段透传到企业业务系统。
1. 开发者页面登录请求
2. 开发者后台对开发者页面登录请求进行鉴权
3.
开发
者后台使用 创建用户数据签名 API 对用户数据进行签名,TCCC后台会返回 ClientDataUserSig4. 开发者后台将业务本身的登录票据、用户数据 ClientData 和用户数据签名 ClientDataUserSig 返回给开发者页面
5. 拉起 TCCCWEB 时传递 ClientData 和 ClientDataUserSig
6. TCCCWEB 将 ClientData 和 ClientDataUserSig 透传给 TCCC 后台
7. TCCC 后台通过 ClientDataUserSig 校验 ClientData
8. 注册成功
ClientData 是 JSON 字符串,通过 TCCC 后台传递到座席的 Web 端,TCCC 会对其中的固定字段进行解析,固定字段如下:
字段名 | 类型 | 说明 |
peerSource | 字符串 | 会话来源,开发者可以传递实际的业务名称,例如:xx商城 |
nickName | 字符串 | 用户昵称,例如:张三 |
uid | 字符串 |
注意
ClientData 请使用序列化后的 JSON 字符串,无需额外编码:
{"peerSource": "XX商城","nickName": "张三","uid": "zhangsan","extra_phoneNumber": "15813812110","extra_ID": "611551555111XXX","extra_questionGroup": "投诉"}
获取到签名之后将 ClientData 和 UserSig 通过 url 的 query string 传递给 TCCC,下面是一个典型的 TCCC WEB 页 URL:
https://tccc.qcloud.com/web/im/index.html#/chat?webAppId=9903496b6be2e67ad291dd2323f3ae9f&title=foo&clientData=%7B%22peerSource%22%3A%22%E4%BA%AC%E4%B8%9C%E5%95%86%E5%9F%8E%22%2C%22nickName%22%3A%22%E5%BC%A0%E4%B8%89%22%2C%22uid%22%3A%22zhangsan%22%2C%22extra_phoneNumber%22%3A%2215813812110%22%2C%22extra_ID%22%3A%22611551555111XXX%22%2C%22extra_questionGroup%22%3A%22%E6%8A%95%E8%AF%89%22%7D&userSig=eJxUkEtvm0AQx7-Lnut0WWArkHJw1qm82Os07rI8bhDWYcwjxJiXqn73CuMeMtLv8h-NTzPzB8n97wc9NnDRyDUpxt9uCWS6vsIJ9AW5SDLGVs*hPK5XPt*szN36k*bhr9V4L7TMtFmRNA1kyDUsjAm1iGHdO-COXDQ2PtDWUd-H3Vs9mJwOqt7k9md8wF68SQbzXbDJd9onyh-vyitUGrkGJRT-sB3iLGnX6kvanZCL9OQNcaAmnzjGW3Uo*fkD7JgJO4KUcnLiMEBalecE23ka*PAC*7LfbYqOF7BnnpEEr-ACnqW3*QLjLa*UlW29PDSfPlJil7JW16hS0*wWUlgLfBRSzI5Sb49TpBzvyDjl52gU0jdmDvJ5FCqPgi-On0YcHnASON3R9PosXM87VdCERW9jOL0*-j*9v72ePGD0918AAAD--2wfhLY_其中 clientData 通过 URLDecode 之后,{"peerSource":"XX商城","nickName":"张三","uid":"zhangsan","extra_phoneNumber":"15813812110","extra_ID":"611551555111XXX","extra_questionGroup":"投诉"}
完成后,在座席侧会展示xx商城张三投诉字样,便于座席识别。