## 不使用自帶的聊天按鈕 有時候，也許你不想要顯示自帶的聊天按鈕，那么你可以使用` 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位字符，請注意字符長度。 5. 限制每分鐘調用不超過3次。