多应用+插件架构,代码干净,二开方便,首家独创一键云编译技术,文档视频完善,免费商用码云13.8K 广告
## 不使用自带的聊天按钮 有时候,也许你不想要显示自带的聊天按钮,那么你可以使用` custom_config: ['withoutBtn'] `。 示例: ``` <!-- 这是知你的嵌入代码 --> <script type="text/javascript"> !function (e, t, n, a, i, r, c) { e[a] = e[a] || function () { (e[a].a = e[a].a || []).push(arguments); }; r = t.createElement(n); c = t.getElementsByTagName(n)[0]; r.async = !0; r.charset = "UTF-8"; r.src = "https://zhiniplugin.h5bqb.top/customer/widget/zhini.js?_=t"; c.parentNode.insertBefore(r, c); }(window, document, "script", "_ZHINI"); _ZHINI({ channel_id: "网页插件的渠道id", // 网页插件的渠道id client_id: "顾客的唯一标识", // 顾客的唯一标识,可为空; custom_config: ['withoutBtn'] // 自定义配置,withoutBtn表示不使用自带的聊天按钮 }); </script> ``` ## 初始化成功时的回调 有时候,也许你需要在知你网站插件加载成功后执行一些事件,那么可以使用`callback_actions{allSet: function}`。 示例: ``` !function (e, t, n, a, i, r, c) { e[a] = e[a] || function () { (e[a].a = e[a].a || []).push(arguments); }; r = t.createElement(n); c = t.getElementsByTagName(n)[0]; r.async = !0; r.charset = "UTF-8"; r.src = "https://zhiniplugin.h5bqb.top/customer/widget/zhini.js?_=t"; c.parentNode.insertBefore(r, c); }(window, document, "script", "_ZHINI"); _ZHINI({ channel_id: "5d382ff9a5ea64393a6cc9e9", // 网页插件的渠道id,已自动填写; callback_actions: { allSet: function () { console.log('网站插件初始化完毕。'); //_ZHINI({action: 'showPanel'}); // 可以在这里调用显示聊天窗的接口 } } }); ``` ## 显示和隐藏知你自带的聊天按钮 在某些需求下,你可能希望在自己编写的代码中掌控知你自带的聊天按钮。 【当然你可以「不使用知你自带的聊天按钮」,那样就可以随心掌控了】<br /> 在知你网站插件初始化成功的前提下, 调用`_ZHINI({action: 'showBtn'})`就可以打开知你自带的聊天按钮; 调用`_ZHINI({action: 'hideBtn'})`就可以隐藏知你自带的聊天按钮。 注意: * 如果你在知你插件还没有初始化成功的情况下调用了本接口,它将无法被正确执行。 * 隐藏知你自带的聊天按钮不会自动隐藏聊天窗口,如果要隐藏聊天窗口可以使用「打开和隐藏聊天窗口」接口来实现。 * 如果你不使用知你自带的聊天按钮,调用本接口不会有任何效果。 示例: ``` <!-- 你可以直接在 HTML 元素中绑定 showBtn、hideBtn --> <a href="javascript:void(0)" onclick="_ZHINI({action: 'showBtn'})">显示客服按钮</a> <a href="javascript:void(0)" onclick="_ZHINI({action: 'hideBtn'})">隐藏聊天按钮</a> <!-- 当然也可以在 Javascript 中调用 --> <script> _ZHINI({action: 'showBtn'}); //_ZHINI({action: 'hideBtn'}); </script> ``` ## 自定义访客唯一身份标识 如果您希望同一个用户无论何时何地通过知你网页在线客服咨询时,客服可以看到该用户之前的所有沟通记录,您需要按以下步骤实现: 第一步,先确认网站初始化页面中加入知你嵌入的JS代码。详见知你 - 【设置】-【网页在线客服】-【接入代码】 第二步,根据业务需要生成当前用户的唯一标识 client_id。(注意:client_id需要您自行生成,确保同一用户在不同浏览器访问时,使用的 client_id 保持一致)。 代码示例: ``` function initWebplugin(clientId) { _ZHINI({ action:"init", // 初始化开始指令; client_id:clientId // 用户的唯一标识,由您自行生成,必填且不能为无效字符,否则不生效; }); }; let clientId="自定义ID"; // 此处为需要传递的用户自定义ID; initWebplugin(clientId); // 此处为调用初始化; ``` 注意: 1. 此方法需要在加载完成第一步(原知你嵌入的JS代码)之后调用,否则无法生效。 2. 如调用此方法会根据您传入的 clientId 建立聊天会话窗口,用户唯一身份标识即为您传入的 clientId 。 3. 传入的 clientId 不能为空,为空则自定义的clientId不生效。 4. 传入的 clientId 字符长度最长为32位,超出将会为自动截取前32位字符,请注意字符长度。