作為一名常年混跡imGeek開(kāi)發(fā)者社區(qū)的程序猿，本著響應(yīng)社區(qū)號(hào)召的“我為人人，人人為我”口號(hào)添谊，贈(zèng)人玫瑰刷喜，手留余香残制。本篇集成筆記主要參考環(huán)信官網(wǎng)移動(dòng)客服集成文檔 (地址：http://docs.easemob.com/doku.php?id=start:475mobilecs)。寫(xiě)這篇筆記主要是為了讓大家更直觀的了解和解決大家的常見(jiàn)問(wèn)題掖疮，比如：“環(huán)信移動(dòng)客服是什么?我能不能使用環(huán)信移動(dòng)客服?怎么集成環(huán)信移動(dòng)客服?”以及在集成過(guò)程中碰到的常見(jiàn)問(wèn)題初茶，歡迎大家一起交流研究。
環(huán)信移動(dòng)客服是全球首創(chuàng)的全媒體智能云客服平臺(tái)浊闪。支持全媒體接入恼布，包括網(wǎng)頁(yè)在線客服、社交媒體客服(微博搁宾、微信)和移動(dòng)端客服等多種渠道折汞。基于環(huán)信業(yè)界領(lǐng)先的IM長(zhǎng)連接技術(shù)保證消息必達(dá)猛铅，并通過(guò)獨(dú)創(chuàng)的智能機(jī)器人技術(shù)極大降低人工客服工作量字支。
環(huán)信移動(dòng)客服不僅支持PC端客服后臺(tái)，同時(shí)支持移動(dòng)端手機(jī)客服后臺(tái)操作，真正幫助商家做到隨時(shí)隨地7*24小時(shí)服務(wù)客戶堕伪。
全媒體接入集成文檔如下：
集成環(huán)信移動(dòng)客服前需注冊(cè)環(huán)信客服賬號(hào)揖庄，并登錄。(環(huán)信客服注冊(cè)地址：http://kefu.easemob.com/mo/register )
一欠雌，網(wǎng)頁(yè)在線客服集成：
網(wǎng)頁(yè)插件集成移動(dòng)客服是比較簡(jiǎn)單蹄梢，原理是在自己網(wǎng)站的標(biāo)簽之前加入一段由環(huán)信提供的js，即可完成環(huán)信在線客服的植入富俄，實(shí)現(xiàn)訪客在網(wǎng)頁(yè)端與在線客服的溝通禁炒。
這段js獲取步驟如下：管理員模式下==》渠道設(shè)置==》網(wǎng)頁(yè)插件
下面來(lái)講下網(wǎng)頁(yè)插件的功能介紹和自定義開(kāi)發(fā)(V4.1版本)：功能介紹可參考imgeek社區(qū)新產(chǎn)品發(fā)布：http://community.easemob.com/article/825307446
一些常見(jiàn)的自定義開(kāi)發(fā)：
Q:網(wǎng)頁(yè)插件怎么集成自定義按鈕?A:首先，將插件JS串中的hide=false修改為hide=true;其次霍比，在你網(wǎng)頁(yè)的目標(biāo)元素上添加如下超鏈接幕袱，例如：你的目標(biāo)元素，即可完成自定義客服按鈕悠瞬。
Q:網(wǎng)頁(yè)插件怎么區(qū)分技能組?A:JS串參考： http://kefu.easemob.com/webim/im.html?tenantId=xxxx&emgroup=技能組名稱(chēng)(注意：技能組名稱(chēng)外面沒(méi)有單引號(hào))
二们豌，移動(dòng)端客服集成：
移動(dòng)端客服(手機(jī)App)集成可分為以下兩步：
1：先在客服后臺(tái)創(chuàng)建一個(gè)關(guān)聯(lián)：管理員模式下==》渠道設(shè)置==》手機(jī)APP 右上角添加環(huán)信關(guān)聯(lián)。關(guān)聯(lián)名稱(chēng)由自己定義浅妆，AppKey望迎，ClientId，ClientSecret可以再環(huán)信開(kāi)發(fā)者后臺(tái)拿到(注冊(cè)環(huán)信開(kāi)發(fā)者賬號(hào)https://console.easemob.com/index_register.html 注冊(cè)完成創(chuàng)建應(yīng)用--查看應(yīng)用概況即可得到)凌外。
這里詳細(xì)介紹下im服務(wù)號(hào)辩尊，im服務(wù)號(hào)為自己應(yīng)用下的一個(gè)im賬號(hào)(不用為每個(gè)用戶創(chuàng)建，根據(jù)自己業(yè)務(wù)邏輯指定一個(gè)或者多個(gè))康辑。
2：客戶端寫(xiě)個(gè)聯(lián)系客服按鈕摄欲，點(diǎn)擊聯(lián)系客服，調(diào)用發(fā)消息方法晾捏，接收對(duì)象為客服后臺(tái)創(chuàng)建的關(guān)聯(lián)的im服務(wù)號(hào)蒿涎，消息就會(huì)到客服后臺(tái)，根據(jù)分配策略分配給對(duì)應(yīng)的客服(V4.1版本客服坐席分配策略為：max(客服坐席可接待人數(shù)-客服坐席已接待人數(shù))惦辛， 也就是說(shuō)劳秋，新來(lái)會(huì)話會(huì)分配給理論最閑的那個(gè)客服坐席)。
一些常見(jiàn)的自定義開(kāi)發(fā)：
指定客服胖齐、技能組玻淑、滿意度調(diào)查、顯示用戶信息可參考(原理為聯(lián)系客服時(shí)通過(guò)傳入擴(kuò)展屬性“鍵值對(duì)”呀伙，由客服后臺(tái)解析辨別补履。“鍵”是環(huán)信實(shí)現(xiàn)約定好的剿另，“值”是自定義箫锤。)文檔地址：http://docs.easemob.com/doku.php?id=start:475mobilecs:30msgextension
這里列舉幾個(gè)常見(jiàn)的用戶信息實(shí)現(xiàn)遇到的問(wèn)題：
Q:已經(jīng)按照文檔傳入用戶信息贬蛙，為什么客服后臺(tái)還是沒(méi)有看到用戶信息?A:客服關(guān)閉會(huì)話，再次聯(lián)系客服就行谚攒，已經(jīng)建立的會(huì)話目前沒(méi)有刷新訪客昵稱(chēng)阳准。
Q:之前傳入用戶信息在客服后臺(tái)顯示了，后來(lái)傳入新的用戶信息為什么客服后臺(tái)沒(méi)有更新?A:已經(jīng)在客服后臺(tái)顯示的用戶信息不會(huì)隨著擴(kuò)展屬性的更新而更新馏臭，目前的設(shè)計(jì)是訪客第一次進(jìn)入時(shí)展示信息給客服辨別野蝇，后續(xù)由客服手動(dòng)備注。
PS:如果自己APP 是基于H5開(kāi)發(fā)的括儒，或者不想集成環(huán)信im怎么使用環(huán)信的移動(dòng)客服绕沈，可以參考之前的網(wǎng)頁(yè)插件集成，將那段js中的tenantID填入以下網(wǎng)址中xxxx的位置：http://kefu.easemob.com/webim/im.html?tenantId=xxxx在自己APP中點(diǎn)擊聯(lián)系客服跳轉(zhuǎn)到這個(gè)H5會(huì)話窗口即可帮寻。
三乍狐，微信公眾號(hào)集成：
微信公眾號(hào)集成需要注意的是個(gè)人的訂閱號(hào)、測(cè)試公眾號(hào)等固逗，微信均沒(méi)有開(kāi)通客服接口的權(quán)限澜躺，所以粉絲收不到客服消息。
微信公眾號(hào)集成分以下幾類(lèi)：
1：直接授權(quán)(通過(guò)在客服后臺(tái)管理員模式==》渠道設(shè)置==》微信公眾號(hào) 添加微信公眾號(hào)即可)抒蚜。需要注意的是授權(quán)以后自己之前對(duì)微信公眾號(hào)所做的開(kāi)發(fā)都不能使用，微信用戶通過(guò)微信的輸入框直接聯(lián)系客服后臺(tái)坐席耘戚。
2：通過(guò)自定義菜單欄點(diǎn)擊聯(lián)系客服
可以在微信公眾號(hào)自定義菜單欄嗡髓，點(diǎn)擊跳轉(zhuǎn)到環(huán)信指定的網(wǎng)址(這個(gè)地址可參考之前的網(wǎng)頁(yè)插件集成，將那段js中的tenantID填入以下網(wǎng)址中xxxx的位置：http://kefu.easemob.com/webim/im.html?tenantId=xxxx )
3：回調(diào)集成(需要開(kāi)發(fā)者收津，涉及到服務(wù)端程序的集成)
實(shí)現(xiàn)原理為環(huán)信發(fā)消息給微信饿这，是通過(guò)環(huán)信的實(shí)時(shí)消息旁路接口。微信發(fā)消息給環(huán)信撞秋，是通過(guò)環(huán)信提供的REST API發(fā)消息接口长捧。
按照以下步驟：
1/在微信公眾號(hào)開(kāi)發(fā)者設(shè)置第三方服務(wù)器接收微信公眾號(hào)的消息進(jìn)行業(yè)務(wù)邏輯處理。
2/調(diào)用環(huán)信rest接口將消息發(fā)給客服后臺(tái)綁定的IM服務(wù)號(hào)(文檔地址http://docs.easemob.com/doku.php?id=start:100serverintegration:50messages)吻贿。
3/客服的回復(fù)消息是到環(huán)信服務(wù)器串结，通過(guò)回調(diào)接口把這消息轉(zhuǎn)發(fā)到用戶指定的服務(wù)器(需要符合環(huán)信格式，配置消息回調(diào)可聯(lián)系環(huán)信在線技術(shù)支持)舅列。
4/服務(wù)器拿到消息之后再推給微信粉絲就行肌割。
PS:需要注意的是消息格式的變化(V4.1視頻和位置暫不支持，會(huì)在后續(xù)版本提供支持)
四帐要，微博集成：
微博集成目前支持私信把敞、 @@ ，評(píng)論暫不支持(V4.1版本)榨惠。
集成方式:管理員模式下==》渠道設(shè)置==》微博公眾號(hào)奋早。
以上均為本人在集成環(huán)信移動(dòng)客服時(shí)所做的筆記以及碰到的問(wèn)題盛霎，同時(shí)，環(huán)信移動(dòng)客服也在不斷快速迭代更新耽装，如有遺漏或者錯(cuò)誤愤炸，請(qǐng)直接聯(lián)系本人：592087956@@qq.com，原文地址http://www.imgeek.org/article/825307476
