1. 首页
  2. 开发指南
  3. JavaScript 网页插件

JavaScript 网页插件

不使用 Mixdesk 的聊天按钮

有时候,也许你不想要显示Mixdesk自带的聊天按钮,那么你可以使用 _ _MIXDESK('withoutBtn');

示例:

<!-- 这是Mixdesk的嵌入代码 -->
<script type='text/javascript'>
    (function(m, ei, q, i, a, j, s) {
        m[i] = m[i] || function() {
            (m[i].a = m[i].a || []).push(arguments)
        };
        j = ei.createElement(q),
            s = ei.getElementsByTagName(q)[0];
        j.async = true;
        j.charset = 'UTF-8';
        j.src = 'https://chat.mixdesk.com/entry.js';
        s.parentNode.insertBefore(j, s);
    })(window, document, 'script', '_MIXDESK');
    _MIXDESK('entId', '我是企业ID');
    // 在这里开启无按钮模式
    _MIXDESK('withoutBtn');
</script>

强制对话

如果你想加载成功后直接打开聊天窗口可以如下设置:

示例:

<script type='text/javascript'>
    (function(m, ei, q, i, a, j, s) {
        m[i] = m[i] || function() {
            (m[i].a = m[i].a || []).push(arguments)
        };
        j = ei.createElement(q),
            s = ei.getElementsByTagName(q)[0];
        j.async = true;
        j.charset = 'UTF-8';
        j.src = 'https://chat.mixdesk.com/entry.js';
        s.parentNode.insertBefore(j, s);
    })(window, document, 'script', '_MIXDESK');
    _MEIQIA('entId', '我是企业ID');
    // 初始化成功后调用 showPanel
     _MIXDESK('allSet', function(){
       _MIXDESK('showPanel');
    });
</script>

传递联系人信息

默认联系人信息

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');
 }
更新时间 2024年11月13日
这篇文章对您有帮助吗?