<small id="aimcq"></small>
  • # 微信小程序

    # 1、第三方應用授權對接

    ? 之前對接小程序只提供了開發者授權的方式,這種方式的弊端是,如果客戶同時對接了其他的系統,會產生access token沖突,導致消息發不過來。因此新增第三方平臺授權的方式,客戶可以在智齒后臺直接掃二維碼授權對接。流程如下:

    # 1.1、選擇授權方式,進入配置頁

    點擊綁定小程序時選擇授權方式,默認推薦第三方平臺授權:

    圖片

    點擊確定進入配置頁:

    圖片

    # 1.2、掃描授權二維碼

    點擊“微信公眾號授權登錄”,跳轉到微信公眾平臺的二維碼頁面:

    圖片

    用管理員微信掃描二維碼,選擇想要綁定的小程序,確認即可。

    # 2、開發者授權對接

    # 2.1、獲取小程序ID和小程序密鑰

    小程序管理員登錄小程序后臺,在【設置-開發設置-開發者ID】中,可以獲取AppID,如下圖:

    圖片

    點擊“重置”,管理員掃描二維碼確認身份后,可以獲取AppSecret,如下圖:

    # 2.2、設置-綁定小程序賬號

    管理員登錄智齒客服平臺,打開【設置-支持渠道-小程序-綁定微信小程序-公眾號開發者授權】,如下圖:

    圖片

    圖片

    點擊綁定微信小程序后會彈出小程序配置對話框,輸入上一步獲取的小程序ID小程序密鑰和,并輸入名稱,系統會自動生成用于與小程序對接的URL,點擊右側的復制按鈕復制URL,如下圖:

    圖片

    # 2.3、小程序消息推送配置

    在小程序后臺【設置-開發設置-消息推送】中,點擊“啟用”。

    管理員掃描二維碼確認身份后,進入消息推送配置頁面。將上一步生成的URL復制到輸入框,自己設置一個Token,點擊“隨機生成”生成一段EncodingAESKey,如下圖:

    圖片

    注意:消息加密方式和對接格式一定要選擇“安全模式”和“XML”。

    在智齒后臺綁定小程序的彈窗里輸入設置的Token和生成的EncodingAESKey,點擊“確定”;然后在小程序后臺點擊“提交”,即可完成配置,如下圖:

    圖片

    # 2.4、智齒后臺設置接待模式

    進入高級設置tab,可對綁定的賬號設置特定的客服模式、多機器人模式下可指定機器人接待等,如下圖:

    圖片

    # 3、咨詢按鈕配置

    # 3.1、小程序獲取用戶昵稱和頭像代碼

    注:請一定要嵌入這段代碼,否則無法獲取到用戶的昵稱和頭像!

    將這一段代碼嵌入小程序的代碼中即可(咨詢按鈕的樣式可以通過代碼自定義)。

        <button 
          type="primary" 
          size="40"
          session-from="sobot|{{userInfo.nickName}}|{{userInfo.avatarUrl}}|{{params}}"
          open-type="contact"
        >聯系客服</button>
    

    注:

    1)獲取昵稱和頭像,需要首先獲取小程序userInfo

    2)定義params字段,類型為字符串,格式為:{"key":"value",……}

    # 3.2、小程序指定接待對接代碼

    一、參數配置

    1、定義

      params: '{"name":"sobot","age":18}',
      transfer_action: '[{"actionType":"to_group","deciId":"xxx","optionId":"3","spillId":"4"},{"actionType":"to_group","deciId":"xxx","optionId":"4"}]',
      platform_action: '{"customerCode":"xxx","flowGroupId":"xxx"}',
      partnerid:"xxx", //對接id
      robotid:1 // 機器人id
    

    2、參數說明

    params 用戶自定義字段
    transfer_action 轉人工指定技能組設置(支持傳入三級溢出策略,即第四級默認為不溢出)
    platform_action 電商平臺版小程序對接參數信息
    partnerid 客戶系統中用戶唯一標識
    robotid 機器人id

    transfer_action參數值說明:

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

    platform_action參數值說明:

    字段 說明
    customerCode 商戶在平臺里面的唯一id
    flowGroupId 指定主賬號下的技能組id

    2)內嵌示例

    <button 
      session-from="sobot|{{userInfo.nickName}}|{{userInfo.avatarUrl}}|{{params}}|transfer_action={{transfer_action}}|platform_action={{platform_action}}|partnerid={{partnerid}}|robotid={{robotid}}"
      open-type="contact"
    >客服會話</button>
    

    注:1.session-from設置長度限制1000

    2.各字段以"|"隔開,會對應不同的參數值;"sobot|昵稱|頭像|自定義字段" 為固定字段,即使不傳入也需要留出字段空間,例如sobot||||;transfer_action, platform_action, partnerid,robotid為選填字段,不受順序、空間限制,用戶可根據自己的業務需要選擇性傳入。

    # 4、小程序卡片對接文檔

    # 4.1、客戶發送卡片

    支持客戶在小程序原生對話中發送小程序卡片。需要在客服會話消息button中增加幾個字段,show-message-card顯示會話內消息卡片, send-message-title會話內消息卡片標題,send-message-path會話內消息卡片點擊跳轉小程序路徑,send-message-img會話內消息卡片圖片。添加后,訪客接入會話時,會出現會話頁的小程序卡片的提示。 具體信息參考官方文檔

    <button type="primary" size="40"
      <!-- 使用小程序卡片功能時原有配置不變,需要添加以下配置項 -->
      show-message-card="true"
      send-message-title="{{miniprogrampage_title}}"
      send-message-path="{{miniprogrampage_path}}"
      send-message-img="{{miniprogrampage_img}}"
      open-type="contact">
            點我給客服發送消息
    </button>
    
    
    

    # 4.2、客服發送卡片接口

    需在智齒新版工作臺的iframe頁面發送postMessage消息,智齒新版工作臺進行接收發送

    //消息格式如下:
    {
      cid: cid, //對接頁面地址中獲取的cid
    ??uid:uid,//對接頁面地址中獲取的uid
    ??msgType: 26, //固定值26
    ??miniPage: {
        headimg: "https://img.sobot.com/console/common/face/admin.png",   //小程序頭像,用于工作臺展示
        name: "小程序名字",   // 小程序名字,用于工作臺展示
        thumbUrl:"https://ss1.baidu.com/6ONXsjip0QIZ8tyhnq/it/u=1667994205,255365672&fm=5",   // 小程序封面圖片,用于工作臺展示
        title: "小程序標題",
        pagepath: "pages/index/index",      //跳轉地址
        thumbMediaId:"nI3DlJZsXd7h0JVZ-LklyzjWtZY4Q-lNAacBe50Chl0k9Zs5PR_p2_jV2na2o3_P" // 小程序的media_id
      }
    }
    
    
    //發送示例
    window.parent.postMessage({
    ? cid: cid,
    ? uid: uid,
    ? msgType: 26,
    ? miniPage: miniPage: {
        headimg: "https://img.sobot.com/console/common/face/admin.png", 
        name: "小程序名字",
        title: "小程序標題",
        pagepath: "pages/index/index",
        thumbMediaId:"nI3DlJZsXd7h0JVZ-LklyzjWtZY4Q-lNAacBe50Chl0k9Zs5PR_p2_jV2na2o3_P" , // 小程序id
        thumbUrl:"https://ss1.baidu.com/6ONXsjip0QIZ8tyhnq/it/u=1667994205,255365672&fm=5", 
      }
    }, '*');
    
    

    # 5、測試綁定成功

    進入小程序點擊咨詢按鈕,跳轉到微信的聊天頁面。輸入文字,測試是否有對應回復。

    如下圖:

    圖片

    大星彩票 <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <文本链> <文本链> <文本链> <文本链> <文本链> <文本链>