1. Home
  2. Develop Docs
  3. JavaScript 网页插件

JavaScript 网页插件

传递联系人信息

默认联系人信息

tel // 电话,格式为:+国家区号加上号码,e.g:+86138XXXX1234,否则会传值失败。
name // 名字
email // 邮箱
comment // 备注

你也可以在工作台设置自定义联系人字段信息

非加密方式

  1. 聊天插件

通过 _MIXDESK('metadata', {}) 接口,可以将这个工作自动化;需要等待mixdesk代码初始化成功之后,才能调用被执行。

<script type='text/javascript'>
     function doSomething () {
         // 传递联系人信息
         _MIXDESK('metadata', {
            name: 'test',
            }
         );
     }
</script>
  1. 聊天链接

通过给链接添加 metadata 参数来传递联系人的信息到工作台

示例:

/standalone-priv.html?eid=我是企业ID&metadata=
{"name":"Test","email":"123456@mail.com"}

示例:

注意: metadata 中,key 和 value 都要添加双引号

/standalone-priv.html?eid=EnterpriseID&metadata=
{"name":"Test","email":"123456@mail.com"}

注意:如果你要在 metadata 中添加带有 & 或者 = 的数据,那么你应该先对它们进行转义

&  %26
=  %3D

正确:

/standalone-priv.html?eid=EnterpriseID&metadata=
{"name":"Test","email":"123456@mail.com","url":"http://mixdesk.com?a%3D1%26b%3D2"}

错误:

/standalone-priv.html?eid=EnterpriseID&metadata=
{"name":"Test","email":"123456@mail.com","url":"http://mixdesk.com?a=1&b=1"}

加密方式

加密算法

AES 加密模式:CBC
填充模式:PKCS7Padding
数据块:128
密码:(约定为企业 ID)
偏移量:(约定为企业 ID)
输出:Hex
字符集:UTF-8
验证加密结果的链接: http://tool.chacuo.net/cryptaes
加密&解密代码参考: https://gist.github.com/ksxkq/00a21e18bcadb86512a023f95c4ecb13

示例:

1.准备待传递数据(待传递数据是一个 JSON 对象):
 {"name":"value"}

2.加密数据(参考下面的加密算法,该示例中,密码 和 偏移量为:2bab953cb29e7a1e3be20ab97d5c675b),得到加密数据:
 cd0caf04a1c6ff63d7951cd5e2016167066c6032e2fd2c8ae543a02d6145e897

3.在聊天链接中添加 encryptedMetadata 参数来传递
 /standalone-priv.html?eid=EnterpriseID&encryptedMetadata=cd0caf04a1c6ff63d7951cd5e2016167066c6032e2fd2c8ae543a02d6145e897

4.在聊天插件中使用
 function setEncryptedmetadata () {
  _MIXDESK('encryptedMetadata', 'cd0caf04a1c6ff63d7951cd5e2016167066c6032e2fd2c8ae543a02d6145e897');
 }
Updated on 2024年9月23日
Was this article helpful?