工单系统提供了「工单链接」部署方式,使企业外部的访客也可以自助提交工单。企业可以通过在工单链接中传递参数,实现顾客身份信息的同步。
「工单链接」同步顾客身份
如果你的产品有多种形式(网页、APP),且都使用了工单链接,那么可以通过在链接中添加 clientid 参数来传递顾客的唯一标识,从而同步顾客的身份(包括顾客信息等)。
注意: 「顾客的唯一标识」来自你自己的用户系统,长度不能超过 32。
示例:
https://xxxxx/?linkId=xxxx&clientid=myclientid
「工单链接」传递顾客信息
你可以通过给链接添加 encryptedMetadata 参数来传递顾客
传递顾客信息数据的时候,需要开发者先加密后,再通过 encryptedMetadata 字段来传递
示例:
1.准备待传递数据(待传递数据是一个 JSON 对象):
{"name":"value"}
2.加密数据(参考下面的加密算法,该示例中,密码 和 偏移量为:2bab953cb29e7a1e3be20ab97d5c675b),得到加密数据:
cd0caf04a1c6ff63d7951cd5e2016167066c6032e2fd2c8ae543a02d6145e897
3.在链接中添加 encryptedMetadata 参数来传递
https://xxxxx/?linkId=xxxx&encryptedMetadata=cd0caf04a1c6ff63d7951cd5e2016167066c6032e2fd2c8ae543a02d6145e897
「工单链接」传递 openid
openid是顾客的微信标识,如果需要将 openid 传递到工单系统中,那么可以通过在链接中添加 openid 参数来传递
示例:
https://xxxxx/?linkId=xxxx&openid=xxxx
加密算法
AES 加密模式:CBC
填充模式:PKCS7Padding
数据块:128
密码:(约定为企业 ID)
偏移量:(约定为企业 ID)
输出:Hex
字符集:UTF-8
企业 ID 在 工作台 – 设置 – 团队 – 团队管理 – ID 查询 中查看
在线加密测试:http://tool.chacuo.net/cryptaes
加密&解密参考:https://gist.github.com/ksxkq/00a21e18bcadb86512a023f95c4ecb13