作為一名常年混跡imGeek開發(fā)者社區(qū)的程序猿，本著響應社區(qū)號召的“我為人人，人人為我”口號，贈人玫瑰，手留余香。本篇集成筆記主要參考環(huán)信官網移動客服集成文檔 (地址：http://docs.easemob.com/doku.php?id=start:475mobilecs)。寫這篇筆記主要是為了讓大家更直觀的了解和解決大家的常見問題，比如：“環(huán)信移動客服是什么?我能不能使用環(huán)信移動客服?怎么集成環(huán)信移動客服?”以及在集成過程中碰到的常見問題，歡迎大家一起交流研究。
環(huán)信移動客服是全球首創(chuàng)的全媒體智能云客服平臺。支持全媒體接入，包括網頁在線客服、社交媒體客服(微博、微信)和移動端客服等多種渠道?；诃h(huán)信業(yè)界領先的IM長連接技術保證消息必達，并通過獨創(chuàng)的智能機器人技術極大降低人工客服工作量。
環(huán)信移動客服不僅支持PC端客服后臺，同時支持移動端手機客服后臺操作，真正幫助商家做到隨時隨地7*24小時服務客戶。
全媒體接入集成文檔如下：
集成環(huán)信移動客服前需注冊環(huán)信客服賬號，并登錄。(環(huán)信客服注冊地址：http://kefu.easemob.com/mo/register )
一，網頁在線客服集成：
網頁插件集成移動客服是比較簡單，原理是在自己網站的標簽之前加入一段由環(huán)信提供的js，即可完成環(huán)信在線客服的植入，實現訪客在網頁端與在線客服的溝通。
這段js獲取步驟如下：管理員模式下==》渠道設置==》網頁插件
下面來講下網頁插件的功能介紹和自定義開發(fā)(V4.1版本)：功能介紹可參考imgeek社區(qū)新產品發(fā)布：http://community.easemob.com/article/825307446
一些常見的自定義開發(fā)：
Q:網頁插件怎么集成自定義按鈕?A:首先，將插件JS串中的hide=false修改為hide=true;其次，在你網頁的目標元素上添加如下超鏈接，例如：你的目標元素，即可完成自定義客服按鈕。
Q:網頁插件怎么區(qū)分技能組?A:JS串參考： http://kefu.easemob.com/webim/im.html?tenantId=xxxx&emgroup=技能組名稱(注意：技能組名稱外面沒有單引號)
二，移動端客服集成：
移動端客服(手機App)集成可分為以下兩步：
1：先在客服后臺創(chuàng)建一個關聯(lián)：管理員模式下==》渠道設置==》手機APP 右上角添加環(huán)信關聯(lián)。關聯(lián)名稱由自己定義，AppKey，ClientId，ClientSecret可以再環(huán)信開發(fā)者后臺拿到(注冊環(huán)信開發(fā)者賬號https://console.easemob.com/index_register.html 注冊完成創(chuàng)建應用--查看應用概況即可得到)。
這里詳細介紹下im服務號，im服務號為自己應用下的一個im賬號(不用為每個用戶創(chuàng)建，根據自己業(yè)務邏輯指定一個或者多個)。
2：客戶端寫個聯(lián)系客服按鈕，點擊聯(lián)系客服，調用發(fā)消息方法，接收對象為客服后臺創(chuàng)建的關聯(lián)的im服務號，消息就會到客服后臺，根據分配策略分配給對應的客服(V4.1版本客服坐席分配策略為：max(客服坐席可接待人數-客服坐席已接待人數)， 也就是說，新來會話會分配給理論最閑的那個客服坐席)。
一些常見的自定義開發(fā)：
指定客服、技能組、滿意度調查、顯示用戶信息可參考(原理為聯(lián)系客服時通過傳入擴展屬性“鍵值對”，由客服后臺解析辨別?！版I”是環(huán)信實現約定好的，“值”是自定義。)文檔地址：http://docs.easemob.com/doku.php?id=start:475mobilecs:30msgextension
這里列舉幾個常見的用戶信息實現遇到的問題：
Q:已經按照文檔傳入用戶信息，為什么客服后臺還是沒有看到用戶信息?A:客服關閉會話，再次聯(lián)系客服就行，已經建立的會話目前沒有刷新訪客昵稱。
Q:之前傳入用戶信息在客服后臺顯示了，后來傳入新的用戶信息為什么客服后臺沒有更新?A:已經在客服后臺顯示的用戶信息不會隨著擴展屬性的更新而更新，目前的設計是訪客第一次進入時展示信息給客服辨別，后續(xù)由客服手動備注。
PS:如果自己APP 是基于H5開發(fā)的，或者不想集成環(huán)信im怎么使用環(huán)信的移動客服，可以參考之前的網頁插件集成，將那段js中的tenantID填入以下網址中xxxx的位置：http://kefu.easemob.com/webim/im.html?tenantId=xxxx在自己APP中點擊聯(lián)系客服跳轉到這個H5會話窗口即可。
三，微信公眾號集成：
微信公眾號集成需要注意的是個人的訂閱號、測試公眾號等，微信均沒有開通客服接口的權限，所以粉絲收不到客服消息。
微信公眾號集成分以下幾類：
1：直接授權(通過在客服后臺管理員模式==》渠道設置==》微信公眾號 添加微信公眾號即可)。需要注意的是授權以后自己之前對微信公眾號所做的開發(fā)都不能使用，微信用戶通過微信的輸入框直接聯(lián)系客服后臺坐席。
2：通過自定義菜單欄點擊聯(lián)系客服
可以在微信公眾號自定義菜單欄，點擊跳轉到環(huán)信指定的網址(這個地址可參考之前的網頁插件集成，將那段js中的tenantID填入以下網址中xxxx的位置：http://kefu.easemob.com/webim/im.html?tenantId=xxxx )
3：回調集成(需要開發(fā)者，涉及到服務端程序的集成)
實現原理為環(huán)信發(fā)消息給微信，是通過環(huán)信的實時消息旁路接口。微信發(fā)消息給環(huán)信，是通過環(huán)信提供的REST API發(fā)消息接口。
按照以下步驟：
1/在微信公眾號開發(fā)者設置第三方服務器接收微信公眾號的消息進行業(yè)務邏輯處理。
2/調用環(huán)信rest接口將消息發(fā)給客服后臺綁定的IM服務號(文檔地址http://docs.easemob.com/doku.php?id=start:100serverintegration:50messages)。
3/客服的回復消息是到環(huán)信服務器，通過回調接口把這消息轉發(fā)到用戶指定的服務器(需要符合環(huán)信格式，配置消息回調可聯(lián)系環(huán)信在線技術支持)。
4/服務器拿到消息之后再推給微信粉絲就行。
PS:需要注意的是消息格式的變化(V4.1視頻和位置暫不支持，會在后續(xù)版本提供支持)
四，微博集成：
微博集成目前支持私信、 @@ ，評論暫不支持(V4.1版本)。
集成方式:管理員模式下==》渠道設置==》微博公眾號。
以上均為本人在集成環(huán)信移動客服時所做的筆記以及碰到的問題，同時，環(huán)信移動客服也在不斷快速迭代更新，如有遺漏或者錯誤，請直接聯(lián)系本人：592087956@@qq.com，原文地址http://www.imgeek.org/article/825307476
