1. 首页
  2. 工单系统
  3. 在工单链接中传递参数

在工单链接中传递参数

工单系统提供了「工单链接」部署方式,使企业外部的访客也可以自助提交工单。企业可以通过在工单链接中传递参数,实现顾客身份信息的同步。

「工单链接」同步顾客身份

如果你的产品有多种形式(网页、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

Updated on 2023年12月18日

本文是否有帮助?

您可能想了解