<small id="aimcq"></small>
  • # 接入說明

    智齒客服網頁端接入提供兩種方式部署對接

    1、鏈接部署方式

    2、JS-SDK部署方式

    兩種部署方式功能上的差異可以點擊此處查看文檔

    # 相關限制及注意事項

    # 桌面網站對接

    客戶端瀏覽器如果是IE,則需要是IE 7及以上

    # 移動網站對接

    # 安卓

    (1)安卓6.0以下

    推薦使用低版兼容鏈接進行部署

    (2)安卓6.0及以上

    推薦使用高版本鏈接進行部署(v2版本)

    # iOS

    推薦高版本鏈接部署(v2版本)

    # APP內嵌入H5對接

    1、推薦使用鏈接部署對接

    2、關于輸入框遮擋問題,主要解決如下:

    (1)主流手機在瀏覽器、微信、釘釘內打開不出現遮擋,極個別使用第三方輸入法出現例外

    (2)App內嵌H5頁面出現對接問題,我們會提供Demo包,第三方開發人員請進行參考開發

    # 移動網站、微信、微信商城、公眾號中使用H5對接

    移動網站、微信、微信商城、公眾號等可直接使用瀏覽器打開的即可以采用鏈接也可以采用組件的形式部署

    # 鏈接部署方式

    1、管理員獲取接入代碼

    智齒控制臺-設置-支持渠道-移動網站-部署設置

    2、對接示例

    <!DOCTYPE html>
    <html>
      <head>
        <title>聊天客戶端</title>
      </head>
      <body>
        <!--html標簽-->
        <!-- ***為您的自定義域名 -->
        <a href="https://***.sobot.com/chat/h5/v2/index.html?sysnum=4c349791a07b46c1a70b8ac88aa23257" target="_blank">歡迎咨詢</a>
        <!--html標簽-->
      </body>
    </html>
    

    聊天鏈接提供和網頁組件相同的客服功能,它是通過鏈接的形式打開一個新頁面進行咨詢訪問,企業可通過在URL后追加特定參數,實現個性化的客服方案配置,詳細請參考章節<附件-參數一覽>。

    # JS-SDK部署方式

    1、管理員獲取接入代碼

    智齒控制臺-設置-支持渠道-移動網站-部署設置

    2、完整代碼接入示例

    <!DOCTYPE html>
    <html>
      <head>
        <title>聊天客戶端</title>
      </head>
      <body>
      <!--html標簽-->
        <script>
          (function (w, d, e, x) {
            w[e] = function () {
              w.cbk = w.cbk || []
              w.cbk.push(arguments);
            }
            x = d.createElement("script");
            x.async = true;
            x.id = "zhichiScript";
            // ***為您的自定義域名
            x.src = "https://***.sobot.com/chat/frame/v2/entrance.js?sysnum=3542411be2184c8cb6b48d66ca1b2730";
            d.body.appendChild(x);
          })(window, document, "zc");
        </script>
      <!--html標簽-->
      </body>
    </html>
    

    該示例為最簡單的智齒接入,通過組件接入智齒客服咨詢組件,企業的用戶可快捷聯系到企業客服獲取幫助。智齒客服網頁組件提供強大的用戶行為采集能力和系統對接能力。當對接成功以后,訪客訪問頁面時會在頁面右下角自動出現訪問客服的入口,按鈕可自定義,當點擊按鈕后會進入到聊天頁面。詳細請參考章節<附件-參數一覽>。

    # 部署約定

    示例:

    1、代碼方式添加

    zc("config",{
      "color":"04babc",
      "uname":"智齒客服"
    })
    

    2、所支持的參數可能不會逐一介紹到,但您可以在文末的參數一覽表中找到,并會附有所有參數的功能介紹。

    # 組件對接

    # 自動初始化

    直接把智齒后臺生成的組件鏈接放到您的網站的標簽之前,即完成自動初始化。

    示例如下:

    <!DOCTYPE html>
    <html>
      <head>
        <title>聊天客戶端</title>
      </head>
      <body>
      <!--html標簽-->
        <script>
          (function (w, d, e, x) {
            w[e] = function () {
              w.cbk = w.cbk || []
              w.cbk.push(arguments);
            }
            x = d.createElement("script");
            x.async = true;
            x.id = "zhichiScript";
            // ***為您的自定義域名
            x.src = "https://***.sobot.com/chat/frame/v2/entrance.js?sysnum=3542411be2184c8cb6b48d66ca1b2730";
            d.body.appendChild(x);
          })(window, document, "zc");
        </script>
      <!--html標簽-->
      </body>
    </html>
    

    # 手動初始化咨詢組件

    示例如下:

    //第一步
    zc("config", {
      "manual": true, //設置成手動初始化
    })
    
    //第二步 通過事件手動初始化
    document.getElementById("customBtn").addEventListener("click",function(){
       zc("frame_manual", function (res) {
        console.log("初始化成功")
      }
    })
    

    # 自定義客戶端

    示例如下:

    zc("config",{
      "color":"04babc", //客戶端主題色 (格式為 0-9 a-f 之間的六位有效字符 不用加#)
      "location":1, //咨詢入口位置 1-右下角 2-左下角 (默認右下角)
    })
    

    # 不使用默認咨詢入口

    智齒聊天組件默認會生成一個咨詢按鈕,若想自定義咨詢按鈕。需設置?custom=true?,同時在自定義按鈕標簽上添加組件對應的?class?即可。

    示例如下:

    <!DOCTYPE html>
    <html>
      <head>
        <title>聊天客戶端</title>
      </head>
      <body>
        <!--自定義按鈕 第三步-->
        <button class="zhiCustomBtn">歡迎咨詢</button>
        <!--html標簽-->
        <script>
          (function (w, d, e, x) {
            w[e] = function () {
            w.cbk = w.cbk || []
            w.cbk.push(arguments);
            }
            x = d.createElement("script");
            x.async = true;
            x.id = "zhichiScript";
            x.className="zhiCustomBtn"; //該class綁定到自定義按鈕上 第一步
            // ***為您的自定義域名
            x.src = "https://***.sobot.com/chat/frame/v2/entrance.js?sysnum=3542411be2184c8cb6b48d66ca1b2730";
            d.body.appendChild(x);
          })(window, document, "zc");
          zc("config",{
            custom:true, //設置自定義生效 第二步
          })
        </script>
        <!--html標簽-->
      </body>
    </html>
    

    # 創建動態自定義咨詢入口

    有時候使用自定義按鈕時,很多頁面元素都是動態生成的,此時要使用動態綁定自定義事件,才能讓自定義咨詢入口生效

    示例如下:

    <script>
      document.getElementById("dynBtn").addEventListener("click",function(){
        //模擬動態插入數據
        document.getElementById("root").innerHTML = '<button class="zhiCustomBtn">咨詢</button>';
        //動態創建自定義按鈕
        zc("dynamic_ready")
      })
    </script>
    

    # 未讀消息、離線消息

    # 獲取未讀消息

    示例如下:

    注意:只有在用戶將聊天窗口收起且客服給用戶發送消息時,這個事件才會觸發。也可監聽zhichiReceive,功能與receive_message一致。

    zc('receive_message',function(res){
      //返回格式:{ img:"客服頭像", name:"客服名稱", msg:"客服發送的內容",t:"發送消息時間"}
    })
    

    # 獲取離線消息

    獲取離線客服發的消息數,當用戶與客服聊天的會話結束之后。用戶離開頁面,客服可以給用戶發送離線消息。當用戶再次進入頁面時,我們會通過這個事件,推送用戶未讀的離線消息數值。

    示例如下:

    zc("offline_message_count",function(res){
      console.log(res)
    })
    

    # 適配多語言

    英文版/中文版

    //en-英文, cn-簡體中文,tw-繁體中文(默認簡體中文) 后續會支持更多語種
    zc("config",{
      locale:"en",
    })
    

    # 商品卡片鏈接(僅H5支持)

    通過網頁組件可設置需要展示的商品信息展示到用戶端

    參數 類型 參數描述 適用范圍
    card_title String 商品標題(必傳) 組件、鏈接
    card_url String 商品信息的商品鏈接地址(必傳)(建議使用encodeURIComponent轉義一下,防止鏈接中帶有特殊符號導致參數獲取失?。?/td> 組件、鏈接
    card_desc String 商品信息的簡述內容(選傳) 組件、鏈接
    card_note String 2000元 商品標簽例:價格(選傳) 組件、鏈接
    card_picture String 商品的縮略圖(選傳)(建議使用encodeURIComponent轉義一下,防止鏈接中帶有特殊符號導致參數獲取失?。?/td> 組件、鏈接

    示例如下:

    zc("config",{
      card_title:"云客服_智齒客服",
      card_url:encodeURIComponent("http://www.gene-tech.cn"),
      card_desc:"云客服,在線客服系統,云呼叫中心,機器人客服,工單客服,智能客服",
      card_note:"1500,2000",
      card_picture:encodeURIComponent("https://img.sobot.com/console/common/face/admin.png")
    })
    

    例圖:

    圖片

    # 訂單卡片(用戶發給客服,僅H5)

    通過網頁組件可設置需要展示的商品信息展示到用戶端

    參數 類型 參數描述 適用范圍
    order_status Number 訂單狀態,1: '待付款',2: '待發貨',3: '運輸中', 4: '派送中',5: '已完成', 6: '待評價',7: '已取消', 組件、鏈接
    create_time Number 創建時間(毫秒) 組件、鏈接
    order_code Number 訂單編號 組件、鏈接
    order_url String 訂單鏈接(建議使用encodeURIComponent轉義一下,防止鏈接中帶有特殊符號導致參數獲取失?。?/td> 組件、鏈接
    goods_count Number 商品數量 組件、鏈接
    total_fee Number 訂單金額(以分為單位,total_fee=1000相當與total_fee=10.00元,不支持小數) 組件、鏈接
    goods String 商品詳情數組 組件、鏈接

    goods數據結構

    參數 類型 參數描述
    name String 商品名稱
    pictureUrl String 商品圖片鏈接(建議使用encodeURIComponent轉義一下,防止鏈接中帶有特殊符號導致參數獲取失?。?/td>

    示例如下:

    1. 組件調用:
    var goods = [{"name":"saaadad","pictureUrl":encodeURIComponent("https://img.sobot.com/console/common/face/admin.png")}];
    zc("config", {
      order_status: 1,
      create_time: "1586414406391",
      order_code: 11111,
      order_url: encodeURIComponent("http://www.gene-tech.cn"),
      goods_count: 2,
      total_fee: 1000, //(以分為單位,total_fee=1000相當與total_fee=10.00元,不支持小數)
      goods: JSON.stringify(goods),
    });
    
    1. 鏈接調用:
    <!-- ***為您的自定義域名 -->
    <a href='https://***.sobot.com/chat/h5/v2/index.html?sysnum=4c349791a07b46c1a70b8ac88aa23257&order_status=1&create_time=1586414406391&order_code=121212&order_url=http://www.gene-tech.cn&goods_count=2&total_fee=1000&goods=[{"name":"saaadad","pictureUrl":"https://img.sobot.com/console/common/face/admin.png"}]' target="_blank">歡迎咨詢</a>
    

    例圖:

    圖片

    # 訂單卡片鏈接(客服發給用戶)

    通過IFrame對接的客戶訂單系統頁面發送postMessage到客服工作臺的方式將訂單卡片發送給客戶,示例如下:

    ...
    <button id="send">發送訂單信息</button>
    ...
    <!-- 
    /**
    *orderStatus 訂單狀態枚舉值(前端傳對應的數字):
    *待付款: 1,
    *待發貨: 2,
    *運輸中: 3,
    *派送中: 4,
    *已完成: 5,
    *待評價: 6,
    *已取消: 7
    **/
    /**
    *  goods 數據結構
    *[{
    *  "name":"商品名稱1",					
    * "pictureUrl":"http://goodsPicture1"   			
    *  },{
    *  "name":"商品名稱2",					
    *  "pictureUrl":"http://goodsPicture2"   			
    *  }]
    **/
    -->
    <script>
    document.getElementById("send").addEventListener("click",function () {
        var data = {
            orderStatus:1,//訂單狀態
            createTime:+new Date(),//下單時間  時間戳
            orderCode:'88888888',//訂單編號
            orderUrl:'http://order.com/1',//訂單鏈接
            totalFee:'100',//訂單金額(以分為單位,total_fee=1000相當與total_fee=10.00元,不支持小數)
            goodsCount:2,//商品數量
            goods:JSON.parse(getValue('goods'))
        };
        window.parent.postMessage({
            cid: '111111',
            uid: '222222',
            msgType: 25,  //固定值
            miniPage:JSON.stringify(data)
        }, '*');
    },false);
    </script>
    

    例圖: 圖片

    # 商品卡片鏈接(客服發給用戶)

    通過IFrame對接的客戶商品系統頁面發送postMessage到客服工作臺的方式將商品卡片發送給客戶,示例如下:

    ...
    <button id="send">發送商品信息</button>
    ...
    <script>
    document.getElementById("send").addEventListener("click",function () {
        window.parent.postMessage({
          cid: "",
          uid: "",
          msgType: 24, // 固定值
          miniPage:JSON.stringify({"title":"北京智齒科技股份有限公司吧嗒嘿北京智齒科技股份有限公司吧嗒嘿","url":"https://www.baidu.com","description":"我是放羊的,你是砍柴的。 咱倆來玩一會兒,誰的損失大?","label":"100元","thumbnail":"https://img.sobot.com/chatres/dd67a23fdac54b8082b2dea3c5c30e82/msg/20190620/9583a4709ae147a690b459399d4afe57.png"})
        }, '*');  
    },false);
    </script>
    

    # CRM對接

    # 基本信息對接

    企業可以通過調用config接口配置企業客戶信息,以便在客服系統中將會話與企業CRM系統中的客戶關聯起來。

    示例如下:

    zc("config",{
      uname:"小丁哥", //客戶名稱
      realname:"丁丁貓", //客戶真實姓名
      tel:"18888888888", //客戶電話,
      email:"dingmao@163.com", //客戶郵箱
      qq:"2345678", //客戶qq號
      face:'https://img.sobot.com/console/common/face/admin.png', //客戶頭像
      remark:"vip客戶,每次響應不能超過5秒鐘" //客戶備注信息
    })
    

    # 客戶自定義字段對接

    # params

    params?是自定義字段,通過該字段客戶可傳入任何想傳到工作臺進行展示的屬性,它接收的值是一個json格式的字符串。展示在客服工作臺的客戶咨詢模塊中最下方的自定義字段區域,該自定義字段可在后臺會話統計中通過關鍵字查詢檢索到,并且可以通過導出會話信息導出。

    示例如下:

    var args = {
      等級:"Boss",
      慣稱:"智齒sobot",
      來自:"北京"
    };
    zc("config",{
      params:JSON.stringify(args)
    })
    

    # customer_fields

    customer_fields?是自定義字段,區別于?params?的是它需要在客服后臺進行配置后才能使用,它也是接收一個json格式的字符串。展示在客服工作臺的客戶咨詢模塊中

    示例如下:

    var args= {
      customField4:"北京智齒科技",
      customField5:"小智呀"
    };
    zc("config",{
      customer_fields:JSON.stringify(args)
    })
    

    # 接待模式

    示例如下:

    zc("config",{
      // 1 : 僅機器人客服模式
      // 2 : 僅人工客服模式
      // 3 : 機器人客服優先模式
      // 4 : 人工客服優先模式
      type:3,
      //機器人id 多機器人模式下,可配置不同場景下不同機器人客服接待
      //請到后臺【設置】->【機器人信息】查看
      robotid:2,
      agentid:'1q2w3e4r', //人工客服id 指定客服接待
      groupid:'4r3e2w1q', //配置技能組 當客戶咨詢人工客服時,會先選擇需要咨詢的業務
    })
    

    # VIP智能路由接待

    參數說明

    • actionType 執行動作類型:
      • to_group 指定技能組;
      • to_service 指定客服。
    • deciId 指定技能組或客服id
    • optionId 溢出標記
      • 1:溢出;指定客服時
      • 2:不溢出;指定客服時
      • 3:溢出;指定技能組時
      • 4:不溢出;指定技能組時
    • spillId 溢出條件
      • 1:客服不在線;指定客服時
      • 2:客服忙碌;指定客服時
      • 3:智能判斷;指定客服時
      • 4:技能組無客服在線;指定客服組時
      • 5:技能組所有客服忙碌;指定客服組時
      • 6:技能組不上班;指定客服組時
      • 7:智能判斷;指定客服組時

    示例如下:

      // action數組中前一個數組元素溢出時會自動把客戶交到后一個數組元素中
      var action = [
        {
          "actionType":"to_group",
          "optionId":"3",
          "deciId":"162bb6bb038d4a9ea018241a30694064",
          "spillId":"4"
        },
        {
          "actionType": "to_group",
          "optionId": "4",
          "deciId": "cae6834444ac43e39d95b1725d2ae454"
        }
      ];
      var payload = JSON.stringify(action);
      zc("config",{
        transfer_action:payload,
      })
    

    # 是否為VIP用戶

    企業可以通過標記用戶是否為VIP以及用戶的VIP等級,在線智能路由會把VIP等級作為觸發條件,依據傳入的VIP等級字段進行客戶分配。

    企業可在管理后臺“設置-自定義字段-客戶字段”中的“已設置字段-VIP等級”來設置VIP級別。

    企業可在管理后臺“設置-自定義字段-客戶字段”中的“已設置字段-VIP等級”來設置VIP等級以及編輯VIP等級的參數名。傳入客戶VIP等級時,既可以傳VIP等級的參數名,也可以傳VIP等級的value值。

    示例如下:

    zc("config",{
      is_vip:1, // 是否是VIP客戶 0: 普通客戶,1: VIP客戶 默認普通客戶
      vip_level: "05bcdc56e68149d1841962caf593d077", // VIP等級對應的id或參數名(id值或參數名通過上方  管理后臺“設置-自定義字段-客戶字段”中的“已設置字段-VIP等級”   獲得),若傳入為普通客戶字段則即使傳入了VIP等級字段也無效
    })
    

    # 客戶標簽

    企業可以設置不同客戶的客戶標簽,依據傳入的客戶標簽字段進行客戶分配。

    企業可在管理后臺“設置-自定義字段-客戶字段”中的“已設置字段-客戶標簽”來設置客戶標簽。

    企業可在管理后臺“設置-自定義字段-客戶字段”中的“已設置字段-客戶標簽”來設置客戶標簽以及編輯客戶標簽的參數名。傳入客戶客戶標簽時,既可以傳客戶標簽的參數名,也可以傳客戶標簽的value值。

    示例如下:

    zc("config",{
      user_label: "05bcdc56e68149d1841962caf593d077", // 客戶標簽對應的id或參數名(id值或參數名通過上方  管理后臺“設置-自定義字段-客戶字段”中的“已設置字段-客戶標簽”  獲得)
    })
    

    # 多種邀請方式

    通過邀請用戶功能,企業可直接增加和用戶溝通的機會,增加獲取營銷線索的可能。需要注意的是,此功能通常需要和“五、調整接待方式”配合使用,以實現不同特征的訪客接受邀請由特定客服模式、指定機器人、指定客服組接待。

    設置自動邀請訪客

    # 主動彈屏邀請用戶

    示例如下:

    zc("config",{
      invite:1, //是否開啟自動邀請 1開啟 0關閉 默認不開啟
      tip_title:'歡迎咨詢', //主動邀請文案
      submit_title:'開始聊天吧', //接受邀請按鈕
      first_timeout:2, //第一次加載延遲邀請時間 時間:s
      over_timeout:10, //拒絕后再次邀請時間 時間:s
      invite_count:5, //一天之內共邀請多少次
    })
    

    # 設置自動強制彈窗

    企業可以通過在關鍵頁面開啟自動強制彈窗功能,當用戶進入該頁面后,會話窗口會自動展開并完成初始化。

    示例如下:

    zc("config",{
      auto_expand:true, //true 自動打開,默認不開啟
    })
    

    # 允許客服主動邀請會話

    企業需要添加此API或在“管理后臺-設置-支持渠道-桌面網站”中開啟“主動邀請會話”功能,客服在工作臺才能手動邀請瀏覽網站中的用戶。企業可根據自己的需要,在部分關鍵頁面開啟此項功能,以避免所有網站訪客都進入邀請列表導致客服的工作難度增大。

    示例如下:

    zc("config",{
      invite_flag:true, //true關閉,默認開啟
    })
    

    # 網站訪問統計

    管理員可在“設置-客服工作臺”中開啟客服工作臺顯示用戶瀏覽軌跡的功能

    # 開啟瀏覽軌跡采集

    智齒默認不采集用戶瀏覽軌跡,企業可通過此API實現在特定頁面下,對特定用戶群體開啟瀏覽軌跡采集功能。在調用以下方法開啟用戶瀏覽軌跡采集后,當用戶瀏覽網頁時,智齒將自動采集瀏覽網站的信息,包括當前訪問頁和當前訪問頁的來源頁(當前訪問頁的上一頁)。

    需要注意的是,智齒會采集三類用戶瀏覽:著陸行為(用戶從哪兒進入網站)、瀏覽行為(用戶進入網站后瀏覽了哪些頁面)、發起咨詢行為(用戶從哪個頁面發起咨詢)。用戶每次訪問網站,智齒都會記錄這三類行為,如果用戶發起了咨詢,這些行為將自動關聯到此次咨詢會話。

    接下來智齒會逐步上線瀏覽軌跡數據查看、統計分析和原始數據導出功能,以便企業充分利用用戶行為數據進行推廣策略的結果評估、分析和調優。

    zc("config",{
      man_trace:true, //開啟收集用戶方訪問軌跡 默認不收集 也可在后臺直接開啟
    })
    

    # 自定義采集內容

    企業可自定義瀏覽軌跡采集內容,保證客服看到的瀏覽軌跡消息能體現關鍵業務信息,如電商場景下的商品ID、商品分類、商品價格等。 若不自定義瀏覽軌跡參數,則系統自動收集訪問頁面的 URL鏈接和網頁標題信息。

    示例如下:

    zc("config",{
      //上一頁信息
      pre_visit_args:{
        'pre_abstract':'來源頁的摘要 沒有 則不傳',
        'pre_visit_url': '來源頁的url 沒有 則不傳',
        'pre_visit_title':'來源來的標題 沒有 則不傳',
        'pre_thumbnail': '來源頁的縮略圖 沒有 則不傳',
        'pre_tags':'來源頁的標簽 沒有 則不傳'
      },
      //當前頁信息
      cur_visit_args:{
        'cur_abstract':'當前頁的摘要 沒有 則不傳',
        'cur_visit_url': '當前頁的url 沒有 則不傳',
        'cur_visit_title':'當前頁的標題 沒有 則不傳',
        'pcur_thumbnail': '當前頁的縮略圖 沒有 則不傳',
        'cur_tags':'當前頁的標簽 沒有 則不傳'
      }
    })
    

    # 手動發送瀏覽軌跡

    有些時候可能需要在特定的頁面多次傳送用戶瀏覽軌跡。比如在單頁應用中用戶在瀏覽商品時,希望滾動到頁面指定商品位置時觸發該事件,從而發送瀏覽軌跡。

    示例如下:

    document.getElementById("traceBtn").addEventListener("click",function(){
      zc("trace",{
        //上一頁信息
        pre_visit_args:{
          'pre_abstract':'來源頁的摘要 沒有 則不傳',
          'pre_visit_url': '來源頁的url 沒有 則不傳',
          'pre_visit_title':'來源來的標題 沒有 則不傳',
          'pre_thumbnail': '來源頁的縮略圖 沒有 則不傳',
          'pre_tags':'來源頁的標簽 沒有 則不傳'
        },
        //當前頁信息
        cur_visit_args:{
          'cur_abstract':'當前頁的摘要 沒有 則不傳',
          'cur_visit_url': '當前頁的url 沒有 則不傳',
          'cur_visit_title':'當前頁的標題 沒有 則不傳',
          'pcur_thumbnail': '當前頁的縮略圖 沒有 則不傳',
          'cur_tags':'當前頁的標簽 沒有 則不傳'
        }
      })
    })
    

    # 留言、評價、附件等功能

    示例如下:

    zc("config",{
      leave_msg_flag:true //輸入框菜單區域的留言按鈕 true開啟 false關閉
      msg_flag:false, //系統提示的留言引導和會話結束后的留言入口 false開啟 true關閉
      feedback_flag: true,//建立會話后的評價按鈕 true開啟 false關閉
      photo_flag: true,//建立人工會話后是否允許上傳附件 true開啟 false關閉
      show_evaluate: 0, //點擊關閉是否開啟評價,show_evaluate=1開啟,默認不開啟
    })
    

    # 多機器人客服接入

    示例如下:

    zc("config",{
      robotid:1, //機器人id
    })
    

    # 常用功能配置

    # 控制顯示歷史聊天記錄的時間范圍

    通過該接口可控制顯示歷史聊天記錄的時間范圍,超過時間范圍的聊天記錄將不對用戶顯示。

    示例如下:

    // time 顯示歷史聊天記錄的時間范圍,需傳入分鐘數,有效值10-2880(10分鐘-48小時)
    zc("config",{
      time:15
    })
    

    # 轉人工時跳轉指定URL

    支持通過該接口設置用戶點擊轉人工時跳轉指定URL,實現在機器人優先模式下,特定用戶從特定網站的特定入口發起咨詢時,用戶點擊轉人工時可跳轉到指定的URL頁面。建議將URL進行encode編碼,盡量使用HTTPS地址。

    示例如下:

    zc("config",{
      to_customsys_flag:true,
      to_customsys_url:'http://www.gene-tech.cn'
    })
    

    # 新窗口打開咨詢頁

    支持通過JS-API配置特定場景的特定用戶點擊咨詢入口時是打開懸浮窗咨詢頁還是新窗口打開咨詢頁。 示例如下:

    // true 新窗口打開咨詢頁 false 打開懸浮窗咨詢頁(默認值)
    zc("config",{
      anchor:true
    })
    

    # 手動控制展開和收起聊天頁面

    示例如下:

    document.getElementById("btn").addEventListener("click",function(){
    //可以拿到當前聊天窗體的狀態 expand展開 collapse收起
      zc('frame_status', function(data) {
        console.log(data)
      })
    })
    

    # 獲取聊天頁面加載完成后的回調

    示例如下:

    //獲取iframe加載完成的回調函數
    zc("frame_ready", function() {
      console.log('iframe加載完成')
    })
    

    # 關閉聊天頁面時的回調

    關閉聊天頁面時,會向外發送?postmessage?請求,監聽該postmessage即可獲取當前聊天頁的狀態。

    示例如下:

    window.onmessage = function(e){
      if(e&&e.data){
        const {name,data} = JSON.parse(e.data);
        if(name==='zc_post_message'){
          const {action,} = data;
          //監聽 action 為 chat_collapse_window 的postmessage
          switch(data.action){
            case 'chat_collapse_window':
            // your code here...
            break;
          }
        }
      }
    }
    

    # 每次展開聊天頁面是否重新加載

    zc('config', {
        'reload': true  //默認false不設置  建議不開啟該功能
    })
    

    # 是否隱藏轉人工后的emoji按鈕

    zc("config", {
      "emoji_state": "hide" // 默認不隱藏,設置為"hide"時隱藏
    })
    

    # 是否自動跳轉聊天中的網址

    PC和H5控制聊天中的鏈接是否能夠自動跳轉,默認可以跳轉

    zc("config", {
      "is_link": 1, // 0為不可跳轉,不為0的時候默認可跳轉
    })
    

    # H5是否顯示頭像

    H5支持顯示客服和客戶頭像,show_face 1:顯示客服頭像,show_face=1并且配置了face參數,顯示客戶頭像

    zc("config", {
      "show_face": 1
    })
    

    # pc/h5安全校驗

    1、開啟“安全密鑰”功能后,桌面網站或移動網站必須傳partnerId參數。且桌面網站或移動網站對接時傳參增加參數“sign”,sign=“MD5(sysnum+密鑰+partnerid)”;
    2、傳入參數后智齒會對sign進行解密,驗證傳入的partnerid與sign中傳入的partnerid是否一致,若一致則正常接入智齒系統,若不一致則彈出提示框“經驗證當前用戶為非法用戶,不予接入客戶服務中心”。若客戶沒有傳partnerid或sign,則視同非法用戶,也彈出提示框“經驗證當前用戶為非法用戶,不予接入客戶服務中心”;
    3、“安全密鑰”的功能開啟和關閉,生效范圍的設置是實時生效的;

    # 獨立接入留言頁

    公眾號對接、小程序對接、IM原生對接等接入方式可以支持客戶選擇模板后進行留言

      http://www.gene-tech.cn/chat/h5/v2/leavemessage.html?sysnum=ed22902866fb4f6e9bc7f0fa259aaa74&uid=xxx&source=9&uname=xxx&templateid=xxx&groupid=xx&locale=cn&t=xxx
    

    source:值固定為9,其它參數根據實際情況拼寫。
    uid:通過客戶中心查詢客戶信息接口獲得,接口返回對應的參數為userid。
    templateid:留言模板id需要在智齒后臺的設置-留言模板設置模塊,通過接口查看。

    # 工單插件接入

    # 添加自定字段或者使用默認字段

    pastedGraphic.png

    pastedGraphic_1.png

    # 設置對應的工單插件

    pastedGraphic_6.png

    在工單插件中生成鏈接后,需要自己在鏈接后面加上params參數,例如

    &params={"card_title":"云客服_智齒客服","card_url":"http://www.gene-tech.cn","card_desc":"云客服,在線客服系統,云呼叫中心,機器人客服,工單客服,智能客服","card_note":"1500元","card_picture":"https://img.sobot.com/console/common/face/admin.png"}
    

    同樣params必須符合JSON格式,定義的字段也必須在工單自定義字段->對接型字段中存在。

    實現的效果:

    pastedGraphic_7.png

    pastedGraphic_5.png

    # 參數一覽表

    # 用戶身份和資料字段

    參數 類型 參數描述 適用范圍
    partnerid String 用戶id 鏈接、組件
    uname String 昵稱 鏈接、組件
    realname String 真實姓名 鏈接、組件
    email String 郵箱賬號 鏈接、組件
    tel String 手機或電話 鏈接、組件
    face String 用戶頭像 鏈接、組件
    qq String qq號 鏈接、組件
    remark String 備注 鏈接、組件
    params String 自定義字段 鏈接、組件
    customer_fields String 自定義字段(后臺控制) 鏈接、組件
    is_vip Number 是否為VIP客戶 0: 普通客戶,1: VIP客戶 默認普通客戶 鏈接、組件
    vip_level String VIP等級對應的id(id值通過上方'查詢客戶固定字段信息'接口獲得),若傳入為普通客戶字段則即使傳入了VIP等級字段也無效 鏈接、組件
    user_label String 客戶標簽對應的id(id值通過上方'查詢客戶固定字段信息'接口獲得) 鏈接、組件

    # 系統字段

    參數 類型 參數描述 適用范圍
    color String 聊天頁主題色 鏈接、組件
    locale String 多語言 en英文 cn簡體中文 tw繁體中文 鏈接、組件
    show_manual String 機器人遇未知問題延遲顯示轉人工按鈕,延遲的次數在后臺設置,開關可在url上配置 1開啟 0關閉 鏈接、組件
    type String 客服接待模式 1僅機器人客服 2僅人工客服 3機器人客服優先 4人工客服優先 鏈接、組件
    agentid String 客服id 鏈接、組件
    groupid String 技能組id 鏈接、組件
    robotid Int 機器人客服id 鏈接、組件
    msg_flag String 結束會話后是否顯示留言入口 1關閉 0開啟 鏈接、組件
    leave_msg_flag String 控制面板中的留言按鈕 1開啟 0關閉 鏈接、組件
    feedback_flag String 評價按鈕 1開啟 0關閉 鏈接、組件
    photo_flag String 上傳附件按鈕 僅H5 1開啟 0關閉 鏈接、組件
    show_evaluate String 點擊關閉是否開啟評價,show_evaluate=1開啟,默認不開啟 鏈接、組件
    to_customsys_flag String 轉人工時跳轉第三方頁面的開關 1開啟 0關閉 鏈接、組件
    to_customsys_url String 轉人工時跳轉第三方頁面的地址 鏈接、組件
    to_customsys_open_style String 轉人工時跳轉第三方是新窗口打開還是當前頁打開 1新頁打開 0當前頁打開 鏈接
    leave_customsys_flag String 是否開啟留言轉第三方系統 僅H5 1開啟 0關閉 鏈接、組件
    leave_customsys_url String 留言轉第三方系統的地址 僅H5 鏈接、組件
    agent_mode_flag String 指定客服接待模式 1客服不在線則正常提示 0客服不在線則接到其他在線客服 鏈接、組件
    top_bar_flag String 是否顯示聊天頁面頂部返回欄 僅H5 1開啟 0關閉 鏈接
    title_flag String 控制title內容的三種顯示方式:
    1:顯示管理后臺設置的企業名稱。
    2:顯示1到30字符的固定文案。
    3:顯示當前客服昵稱。
    (配合現有參數(top_bar_flag)一起使用的,top_bar_flag=1的時候才生效)僅H5
    鏈接、組件
    custom_title String title顯示的自定義文案,結合title_flag使用,當title_flag=2時,頂部將顯示該值。
    top_bar_flag=1的時候才生效 僅H5
    鏈接、組件
    guide_flag String 是否開啟機器人引導問題 1開啟 0關閉 鏈接、組件
    cut_flag String 用于pc聊天頁是否開啟或隱藏截圖工具 hide關閉 默認開啟 鏈接、組件
    time String 用戶可查看聊天記錄的時間段 單位:分鐘 鏈接、組件
    queueFirst String 該客戶是否為指定客戶(指定客戶優先時使用) 鏈接、組件
    transfer_action String 智能路由策略 鏈接、組件
    summaryparams String 服務總結字段 鏈接、組件
    reload Boolean 每次展開聊天頁面是否重新加載 默認false不設置,建議不開啟該功能 鏈接、組件
    emoji_state String 是否隱藏轉人工后的emoji按鈕 默認不隱藏,設置為"hide"時隱藏 鏈接、組件
    source String 來源 0:桌面網站,1:微信,2:APP,3:微博,4:移動網站,9:企業微信,10:微信小程序 鏈接、組件
    is_link Number 0為不可跳轉,不為0的時候默認可跳轉 鏈接、組件
    show_face Number show_face 1:顯示客服頭像,show_face=1并且配置了face參數,顯示客戶頭像 鏈接、組件
    anchor String 新窗口打開咨詢頁 組件
    async String 頁面進入時自動加載JS組件 默認0 1開啟 0關閉 組件
    invite String 是否開啟自動邀請 1開啟 0關閉 組件
    tip_title String 邀請文案 組件
    submit_title String 接受邀請按鈕 組件
    first_timeout String 第一次加載延遲邀請時間 時間:秒 組件
    over_timeout String 拒絕后再次邀請時間 時間:秒 組件
    invite_count String 一天之內共邀請多少次 組件
    invite_imgsrc String 邀請彈屏的logo圖片 組件
    container_style String PC組件聊天窗體自定義樣式(不支持設置height,width) 組件
    height String PC組件聊天窗體自定義高度 組件
    width String PC組件聊天窗體自定義寬度 組件
    platformUnionCode String 指定平臺id 組件
    refresh Boolean 是否每次展開聊天組件都刷新 默認false 組件
    faq Number 指定機器人的常見問題組 鏈接、組件

    # 消息字段

    參數 類型 參數描述 適用范圍
    card_title String 消息卡片名稱 鏈接、組件
    card_url String 消息卡片地址 鏈接、組件
    card_note String 消息卡片描述 鏈接、組件
    card_desc String 消息卡片詳情 鏈接、組件
    card_picture String 消息卡片圖標 鏈接、組件
    order_status Number 訂單卡片訂單狀態,1: '待付款',2: '待發貨',3: '運輸中', 4: '派送中',5: '已完成', 6: '待評價',7: '已取消', 組件、鏈接
    create_time String 訂單卡片創建時間(毫秒) 組件、鏈接
    order_code String 訂單卡片訂單編號 組件、鏈接
    order_url String 訂單卡片訂單鏈接 組件、鏈接
    goods_count Number 訂單卡片商品數量 組件、鏈接
    total_fee Number 訂單卡片訂單金額(以分為單位,total_fee=1000相當與total_fee=10.00元,不支持小數) 組件、鏈接
    goods String 商品詳情數組(數據結構見下表) 組件、鏈接
    robot_hello_word String 機器人歡迎語 鏈接、組件
    agent_hello_word String 人工客服歡迎語 鏈接、組件
    agent_offline_title String 人工客服不在線提示語 鏈接、組件
    pre_abstract String 來源頁摘要 組件
    pre_visit_url String 來源頁url 組件
    pre_visit_title String 來源頁標題 組件
    pre_thumbnail String 來源頁縮略圖 組件
    pre_tags String 來源頁標簽 組件
    cur_abstract String 當前頁摘要 組件
    cur_visit_url String 當前頁url 組件
    cur_visit_title String 當前頁標題 組件
    cur_thumbnail String 當前頁縮略圖 組件
    cur_tags String 當前頁標簽 組件

    goods數據結構

    參數 類型 參數描述
    name String 商品名稱
    pictureUrl String 商品圖片鏈接
    大星彩票 <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <文本链> <文本链> <文本链> <文本链> <文本链> <文本链>