不使用 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 // 备注
你也可以在工作台设置自定义联系人字段信息
非加密方式
- 聊天插件
通过 _MIXDESK('metadata', {})
接口,可以将这个工作自动化;需要等待mixdesk代码初始化成功之后,才能调用被执行。
<script type='text/javascript'>
function doSomething () {
// 传递联系人信息
_MIXDESK('metadata', {
name: 'test',
}
);
}
</script>
- 聊天链接
通过给链接添加 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');
}