>[danger] **[點此進入芝麻小客服官網](https://xiaokefu.com.cn/?source=kanyun_mia_1343271)** <br> 芝麻小客服客服聊天插件，是專門為了電商、多商鋪等領域打造的一款使用簡單，功能強大的插件。使用本插件，你可以使用較少的開發量實現接近傳統電商客服的功能；特點概述： <br> ## **適用于**：**微信小程序** * **自動回復功能豐富**：打開客服回復、收到消息回復、關鍵詞回復、排隊中、離線后等等各種類型的自動回復，每個店鋪均可獨立設置。 * **回復類型豐富**：文字、圖片、智能菜單等類型的自動回復。 * **專為電商及多商戶設計**：快捷發送商品、快捷提示、打開提示菜單、客服對話獨立、商鋪之間會話獨立等。 * **提醒推送**：即時推送提醒給客服，不遺漏消息。 * **回復消息**：支持客服在網頁端及小程序內回復消息。 Demo下載：https://ossxkf.oss-cn-beijing.aliyuncs.com/pluginDemo-12.rar Demo內容： 1. 跳轉插件 2. 傳遞頭像昵稱 3. 傳遞openid 4. 傳遞場景值 5. 傳遞快捷方式 6. 傳遞客戶資料 7. 傳遞圖文模板 8. 代替C端傳遞一段文本 9. 同時傳遞openid+客戶資料 注意事項： 1. 請注意引用最新版本； 2. 如果插件后臺設定了跳轉小程序，路徑需要以/開頭，比如/pages/index/index 3. 為了保證用戶唯一，建議全部用戶均傳遞openid 4. **插件會受到全局樣式設置的影響。** 如果出現樣式異常，請檢查全局樣式設置。 * * * ------ >使用流程視頻演示 <video style="width: 100%; height: 100%; object-fit: fill" controls="controls" poster="https://box.kancloud.cn/67b3e862f9930f84f9b9629c8aa1dba5_1911x1072.jpg" > <source src="https://ossxkf.oss-cn-beijing.aliyuncs.com/chajianxin.mp4" type="video/mp4" /> </video> >多商鋪實現流程說明 <video style="width: 100%; height: 100%; object-fit: fill" controls="controls" poster="https://box.kancloud.cn/67b3e862f9930f84f9b9629c8aa1dba5_1911x1072.jpg" > <source src="https://ossxkf.oss-cn-beijing.aliyuncs.com/duoshangpuchajian.mp4" type="video/mp4" /> </video> ### 使用插件 #### 第一步：申請使用插件 在使用插件前，首先要在小程序管理后臺（[https://mp.weixin.qq.com](https://mp.weixin.qq.com/)）的“**設置-第三方設置-插件管理**”中添加插件。開發者可登錄小程序管理后臺，通過 wx1fdc8c9f3a3a05e4 查找插件并添加。 #### 第二步：引入插件 對于插件的使用者，使用插件前要在 app.json 中聲明 ~~~ { "plugins": { "ykfchat": { "version": "2.0.33", "provider": "wx1fdc8c9f3a3a05e4" } } } ~~~ #### 第三步：跳轉至插件 使用者可以在自身小程序內調用插件頁面(插件為單獨頁面，不支持使用者修改) 調用方法如下： ~~~ wx.navigateTo({ url: 'plugin://ykfchat/chat-page?wechatapp_id=103863&channel_id=5303&scene=p21865wbpl', }); ~~~ 其中plugin://ykfchat/chat-page?wechatapp_id=103863&channel_id=5303&scene=p21865wbpl為開發者在芝麻小客服后臺獲取的自己的場景路徑。  跳轉具體路徑請在第四步中獲取。 #### 第四步：注冊小客服賬號 進入芝麻小客服官網：[芝麻客服官網](https://xiaokefu.com.cn/)，右上角[注冊賬號](https://login.xiaokefu.com.cn/register?cookie=1&usertype=12&tab=default&refresh=https://xiaokefu.com.cn/)；注冊成功后，開始[一鍵接入](https://login.xiaokefu.com.cn//xkf/xkfLogin?tab=scan&cookie=1&usertype=12&refresh=http://xiaokefu.com.cn)。  選擇客服插件：  創建場景：  接入成功：  接入成功后，即可看到這個場景的路徑：  新增場景，如果你需要為多個場景（商鋪、來源或渠道等）創建不同的路徑，有以下兩個方法： 1：新增場景  2：添加場景客服，場景客服是指負責這個場景的客服，所有場景客服將共同負責這個場景； 要添加場景客服，需要先在后臺-多客服管理內添加客服。 每個客服，在這個場景下都有自己的客服路徑，使用客服路徑時，客戶咨詢將直接指定給該客服。  #### 第五步：使用 1. 填寫場景信息 2. 添加場景客服 3. 增加快捷方式 4. 設置自動回復；注意：自動回復僅對當前場景或渠道有效，每個渠道或場景均需要單獨設置； 5. 添加客服；在添加場景客服前，需要先添加客服； ---- ## 開發者文檔 一、客服聊天助手支持將指定的數據由小程序傳入，例如進入聊天訪客的頭像昵稱，當前跳轉聊天頁的場景信息，當前場景的快捷方式等。 1、首先在跳轉插件的js中最頂部，引入插件方法，例： `var plugin = requirePlugin("ykfchat")` 2、在跳轉插件的代碼之前注冊事件，例： ~~~ // 傳參 jump() { plugin.callback.on("getSessionFrom", this.session, this); // 事件名稱， 事件函數，this作用域 wx.navigateTo({ url: 'plugin://ykfchat/chat-page?scene=p1618ycpl' }) }, session(callback) { // 組裝數據 let data = { sessionFrom: { avatarUrl: 'http:xxxx.png',//需為網絡資源 nickName: '劉小二', city: '武漢', province: '湖北', weixin: 'weixinhao123', age: '22', sex: '1', source: '來自商品ID：123', note: '注意，這是一個VIP用戶', mobile:'13397121301', tag_id: '11' } } callback(data) }, ~~~ ``` 頭像：avatarUrl 昵稱：nickName 城市：city 省會：province 微信：weixin 電話：mobile 數字 年齡：age 數字 性別：sex 1或2 1是男 2是女 來源：source 地址：address 備注：note 標簽ID：tag_id ``` 傳入客戶資料后，客服端可以看到對應的數據：  ##### 插接函數對接列表： | 事件類型 | 函數名 | 參數 | 備注 | | --- | --- | --- | --- | | 傳入頭像昵稱 | getSessionFrom | {sessionFrom: {avatarUrl: 'http:xxxx.png', nickName:'李二' }} | | | 傳入場景信息 | get\_channel\_info | {channel\_info: {scene\_title: '傳來的標題',scene\_descr: '傳來的描述',mini\_url: '傳來的小程序跳轉路徑',scene\_type: '1',phone\_no: '傳來的撥打電話號碼',scene\_logo: 'http:xxxx.png',}} | scene\_type，標題可以執行的操作, 1、跳轉小程序。2撥打電話 | | 傳入快捷方式 | get\_shortcut | {short\_cut\_info: \[{content\_json: '{"miniprogram\_path":"/pages/index/index"}',rule\_status: '1',short\_cut\_name: '傳來跳轉小程序',short\_cut\_type: '1'}, {content\_json: '{"copy\_content":"傳來的復制內容","toast\_type":"1","toast\_content":"傳來的復制彈窗內容"}',rule\_status: '1',short\_cut\_name: '傳來復制功能1',short\_cut\_type: '2'}, {content\_json: '{"phone\_num":"13275261798"}',rule\_status: '1',short\_cut\_name: '傳來打電話功能1',short\_cut\_type: '3'}, {content\_json: '{"keyword":"619448572"}',rule\_status: '1',short\_cut\_name: '傳來關鍵詞回復',short\_cut\_type: '4'}\],short\_cut\_document: {content: '傳來的文案'}} | short\_cut\_info，快捷方式的信息，short\_cut\_type，1、跳轉小程序頁面2、復制文本（content\_json中的toast\_type為復制成功的彈窗形式，1,toast模式2,彈窗模式）3、撥打電話。4、觸發關鍵字。rule\_status是否在聊天頁顯示，short\_cut\_document，提示文案 | | 傳入openid | getOpenId | {openid:'openid'} | openid為小程序獲取的openid 需要在跳轉的url中的getOpenIdType參數為2 | | 動態傳入圖文模板 | get\_pic\_templates | {\_id: 4,title: '測試標題',description: '測試description,thumb: 'https://wx.qlogo.cn/mmopen/vi\_32/Q0j4TwGTfTKTMMUqibuotkoE5G5nTibVonoAC3A0vc7cUxt9tooSt8EJApnrJChvRqicYiarbPnOjH2lX7DwDUfEBA/132',value: '$654',url: '/pages/index/index?id=1'} | title是傳入的標題，description描述，thumb圖片(不能傳相對路徑),value價格，url點擊圖文模板的跳轉到小程序路徑（可帶參數），_id是后臺建立的圖文模板的id數字 | 二、插件獲取openid的方法 傳入方法請參考demo ~~~ wx.navigateTo({ url: 'plugin://ykfchat/chat-page?scene=p1618ycpl&getOpenIdType=1' //getOpenIdType為1時在第一次跳進小程序插件時會由客服聊天助手申請授權，然后從微信獲取openid。如果不傳則生成的不是微信獲取的openid }) ~~~ ----- ## 場景鏈接跟專屬鏈接的區別 場景鏈接：場景設置內的場景路徑 專屬鏈接：場景客服內的客服路徑 1：隔離 * 場景鏈接跟場景鏈接之間對話隔離；比如一個客戶咨詢了兩個場景，對話是相互隔離的； * 場景鏈接跟專屬鏈接之間對話隔離；比如一個客戶咨詢了渠道鏈接，又咨詢了場景內的專屬鏈接，這兩個對話也是相互隔離的，互不影響； * 專屬鏈接之間對話隔離；比如一個客戶咨詢了A專屬鏈接，又去咨詢了B專屬鏈接，這兩個對話也是相互隔離的，互不影響。 2：消息互通 * 從一個場景鏈接內咨詢的客戶，只能同時被一個客服接待，且無論被哪個客服接待，聊天記錄都是互通的；比如客戶1通過場景鏈接咨詢，第一天被客服A接待了，結束接待后，第二天被客服B接待了，那么B是可以看到之前跟客服A的對話的。 * 從一個專屬鏈接內咨詢的客戶，只能同時被一個客服接待，且無論被哪個客服接待，聊天記錄都是互通的；比如客戶咨詢了客服A的專屬鏈接，被客服A接待了，然后客服A轉接給了客服B，或者又自動轉接給了客服C，那么整個過程中的聊天記錄是互通的。 所以，如果希望對話有延續性，請使用同一個場景鏈接，這樣，無論客戶被哪個客服接待，通過同一個場景鏈接進行的咨詢，內部消息都是互通的。 如果你希望對話相互隔離，可以使用多個場景鏈接，或者專屬鏈接。 **在什么場景下要使用專屬鏈接呢？** 如果你有這樣的需求，可以使用專屬鏈接： * 要求對話隔離 * 要求客服之間可以轉接，假如專屬鏈接同屬一個場景，場景內的客服是可以相互轉接的。 **什么場景下使用場景鏈接呢？** 如果你有這樣的需求，可以使用場景鏈接； * 一個店鋪需要有多個客服負責 * 店鋪內的客服可以相互轉接，但是不能轉接給店鋪外的客服 * 店鋪與店鋪之間的對話隔離 ## 常見問題 1：為什么插件樣式顯示異常？ 請查看全局樣式設置，插件會受到小程序全局樣式的影響。 2：為什么在添加場景客服時，顯示已經添加全部客服？ 如果沒有其他客服，可以先去多客服管理內添加客服，然后再添加到場景客服內。 如果已經有客服，可以在多客服管理內編輯客服，使用其負責插件或某個渠道。 3：客戶咨詢：可以做到“多個店鋪，每個店鋪有多個客服，每個客服負責自己的那一塊。”，比如，用戶進了A商鋪，客服a負責基本信息的回答，但是此時用戶要進行售后，于是客服a轉接到了負責售后的客服b； 這位客戶的需求可以這樣實現： 原理：場景客服之間可以相互轉接 * 把需要互相轉接的客服1和2，加到同一個場景A下做場景客服； * 商鋪A入口，需要先給客服1，就填寫客服1的客服路徑，這樣就會指定給他。但是他又可以轉接給客服2。 4：客戶咨詢：我們希望能夠在自己的服務號內做通知，該如何處理？ 可以在開放接口內使用客服消息推送接口。這樣，我們會把需要提醒的信息推送到相關接口內，方便調用自己服務號的模板消息服務進行提醒。[離線消息推送](http://www.hmoore.net/wikizhima/wikixkf/1709436) 如果要使用這個接口，需要自行建立客服跟自己服務號的openid之間的對應關系，方便我們推送時及時提醒。 5：使用插件時，遇到一個問題：客戶離開后，沒辦法通知呢，該怎么解決？ 可以使用開放接口內的離線消息推送接口：在客戶離開咨詢頁時，我們會把客服回復的內容向填寫的接口推送，這樣就可以使用自己的手段進行提醒，比如模板消息、訂閱消息等。 6：我想傳遞其他參數怎么辦？ 可以在后臺--客戶中心--自定義客戶字段內創建自定義字段后，傳遞方法跟上面傳遞客戶字段的方法保持一致。 </h> </h> <br> <br> <br> >[danger] **[點此進入芝麻小客服官網](https://xiaokefu.com.cn/?source=kanyun_mia_1343271)** 您有問題需要咨詢的話，可以掃描下方二維碼： </h>  </h> </h>