一 . APP接入
您已拥有一款Android或iOS版手机APP,只需要集成环信IM SDK,并在环信移动客服系统关联您的手机APP,就可以轻松处理来自您的APP用户的咨询。
为了帮助您快速集成环信IM SDK,我们为您准备了 “商城”Demo及其源码。您可以先使用商城Demo体验客服功能,然后参考“商城”Demo源码进行集成。
注意:环信只提供消息收发功能,APP的UI界面需要自定义。
第1步:注册移动客服账号
在移动客服 注册页面,填写您的邮箱、密码等信息,注册移动客服账号。
第2步:注册环信开发者账号
在环信 管理后台注册页面,填写您的企业ID、用户名、密码等信息,注册环信开发者账号。
第3步:创建应用和IM用户
登录环信管理后台,为您的手机APP创建一个应用,获取AppKey、ClientId、ClientSecret。注册一个IM用户,获取用户名和密码。第4步:将您的APP绑定移动客服
打开环信移动客服,进入“管理员模式 >渠道管理 >手机APP”。点击“+添加APP关联”。填写关联名称(您的APP名称)、AppKey、ClientId、ClientSecret、IM服务号(IM用户的用户名)、IM Password(IM用户的密码),并保存。第5步:验证该APP关联的消息收发
您可以通过“商城”Demo验证该APP关联的消息收发。打开“商城”Demo,点击“设置”,将设置页面的“AppKey”和“IM服务号”修改为上述APP关联的“AppKey”和“IM服务号”,即可先行体验通过您自己的AppKey发送的消息和留言。
验证步骤:
将demo中的 “AppKey”和“IM服务号”修改为上述APP关联
跟踪到要修改的代码的类中 为
—————-运行查看收发效果——————
第6步:为您的APP集成用户体系
您需要为您的已有用户和新增用户创建环信ID,并关联起来,才可以在环信移动客服上正确显示访客信息(您的用户信息)。请参考 用户和好友体系集成。
注:集成过程中有任何技术问题,请联系环信技术支持。
第7步:为您的APP集成消息和留言功能
参考“商城”Demo的开源代码,集成消息和留言功能。
iOS版demo源码下载地址: https://github.com/easemob/helpdeskdemo-ios
Android版demo源码下载地址:https://github.com/easemob/kefu-android-demo
注:源码使用的SDK版本为v2.x,集成过程中有任何技术问题,请联系环信技术支持。
后续操作
集成IM SDK后,您可以 使用APP扩展集成,实现更多个性化功能。
APP渠道集成
客户只需要将手机APP集成环信即时通讯云IM SDK,并在环信移动客服系统关联该手机APP,即可轻松实现APP接入。
APP SDK集成
前提:您需要拥有一款自己的手机APP,Android版或iOS版。
第 1 步:注册环信IM开发者账号并登录。注册地址:https://console.easemob.com/index_register.html
第 2 步:添加您的手机APP,获取AppKey、ClientId、ClientSecret。
第 3 步:注册一个IM用户,获取用户名和密码(即IM服务号和IM password)。
第 4 步:下载IM SDK v2.x并集成。
下载地址:http://www.easemob.com/download/im
具体集成方法可参考“商城demo”中的开源代码。
iOS版demo源码下载地址:https://github.com/easemob/helpdeskdemo-ios
Android版demo源码下载地址:https://github.com/easemob/kefu-android-demo
注:集成过程中有任何技术问题,请联系环信技术支持。
第 5 步:使用管理员账号登录环信移动客服,进入“管理员模式→渠道管理→手机APP”。
第 6 步:点击“添加APP关联”,添加一个关联名称(一般为APP名称或咨询入口名称),并将APP的注册信息(AppKey、ClientId、ClientSecret、IM服务号、IM密码)填入关联项,点击保存。
若验证状态和应用状态均为绿色,则表明APP关联已添加成功。
第 7 步:返回客服模式,等待APP访客发起会话。
打开手机APP,点击“联系客服”,发起一个新会话,开始与客服聊天。
APP扩展集成 和 集成留言功能##
由于扩展集成 和 集成留言功能 依个人所需 进行扩展 这里给出官方地址自行集成即可
http://docs.easemob.com/cs/300visitoraccess/10nativeapp#app_sdk%E9%9B%86%E6%88%90
以上步骤 app接入就完成了 下面介绍一下
二 . 微信接入
您已拥有一个通过微信认证的微信公众号,只需将您的微信公众号绑定到环信移动客服系统,就可以轻松处理来自微信网友的咨询。
注意:未通过微信认证的服务号或订阅号无法使用环信移动客服的完整功能。使用环信移动客服时,需停用微信多客服,并关闭多客服客户端上的自动回复功能。
第1步:注册移动客服账号
在移动客服 注册页面,填写您的邮箱、密码等信息,注册移动客服账号。
第2步:绑定微信公众号
登录环信移动客服,进入“管理员模式 >渠道管理 >微信”。点击“+微信公众号”,添加微信公众号。进入微信公众平台,扫描二维码授权环信移动客服。第3步:设置自定义菜单
绑定成功后,微信公众号菜单将暂时失效,需重新设置自定义菜单。点击微信公众号,选择“自定义菜单”进行设置。
绑定微信公众号后,当微信网友向该微信公众号发送消息时,可以在环信移动客服的会话面板查看并回复。
后续操作
您可以设置粉丝首次关注自动回复功能。当微信网友首次关注您的微信公众号时,自动回复欢迎信息。
如果您是一位开发者,您也可以使用回调模式集成环信移动客服,或者,您可以为您的微信公众号菜单添加客服系统的H5网页聊天地址,请参考微信渠道集成。
三 . 微信渠道集成
请参考微信渠道集成 这里将不再细说。
首次在微信渠道使用环信移动客服系统时,需要先在环信移动客服系统绑定微信公众号。
授权模式
通过微信公众号授权,直接与微信公众号绑定,客服可以直接与公众号的粉丝对话。
注意:
123第 1 步:使用管理员账号登录环信移动客服,进入“管理员模式→渠道管理→微信”,点击“+微信公众号”。
微信渠道
第 2 步:点击“微信公众号登录授权”。
添加微信公众号
第 3 步:使用微信公众号绑定的个人微信号扫描网页中的二维码(下图为示例)。
授权环信移动客服
第 4 步:绑定成功。可以设置微信公众号的自定义菜单。
设置微信公众号的自定义菜单
授权成功后:
12345注意:
12回调模式
针对有开发者的公众号,需要首先将公众号设置为开发者模式,微信会将粉丝发送的信息及事件推送到设定的服务器地址上。在开发者中心中设置的第三方服务器接收到微信推送过来的粉丝消息后,根据需要有选择的将消息发送给环信指定的API,环信会将该粉丝消息发送给客服人员,客服回复后环信会将消息推送给第三方提供的API(符合环信格式),由第三方将客服回复消息发送给终端的粉丝用户。
回调模式集成包含如下步骤:
该集成方式主要针对有开发者的公众号集成,需要涉及到服务端程序的集成,因此需要首先将公众号设置为开发者模式,微信会将粉丝发送的信息及事件推送到设定的服务器地址上。
123456第 1 步:关联IM系统和客服系统
登录环信管理后台。若您还没有账号,点击“立即注册”,注册成为环信开发者并登录。注册环信开发者账号
进入我的应用,并点击“创建应用”,创建一个应用,并获取APP的AppKey、ClientId、ClientSecret(下图应用为示例)。创建应用 获取APP的AppKey、ClientId、ClientSecret
点击刚创建的应用,选择“IM用户→注册IM用户”,注册两个IM用户。例如:kefu001、kefu001_callback。注册IM用户
使用管理员账号登录环信移动客服,进入“管理员模式→渠道管理→手机APP”,点击“添加APP关联”。手机APP渠道
在“新增APP关联”窗口,填写关联名称、AppKey、ClientId、ClientSecret、IM服务号、IM Password,并点击“保存”,创建APP关联。其中:“AppKey、ClientId、ClientSecret”对应您创建的APP的AppKey、ClientId、ClientSecret;“IM服务号、IM Password”对应您注册的其中一个IM用户的用户名和密码,如用户名kefu001与对应的密码。
添加APP关联
注:此关联成功启动之后,代表IM系统与客服系统成功关联起来。
第 2 步:关联IM系统和第三方服务器
使用APP的ClientId和ClientSecret获取APP管理员Token,并记录下来。详情请参考:获取APP管理员token。
联系环信技术支持,开通实时消息回调。需要向环信提供如下配置信息:
123456详情请参考:实时消息回调。
注:开通实时消息回调后,代表IM系统与第三方服务器成功关联起来。
第 3 步:设置消息投递到环信
在开发者中心中设置的第三方服务器接收到微信推送过来的粉丝消息后,根据需要有选择的将消息发送给环信指定的API,环信会将该粉丝消息发送给客服人员,坐席回复后环信会将消息推送给第三方提供的API(符合环信格式),由第三方将客服人员回复消息发送给终端的粉丝用户。
投递到环信的消息格式及API使用方式可以参见 发送消息,需要额外注意的只有消息格式的变化,需要在消息的扩展信息中添加上至少如下信息:
目前支持文本消息、图片消息、语音消息类型。
文本消息:
12345678910111213141516171819图片消息:
123456789101112131415161718192021语音消息:
123456789101112131415161718192021说明:
目前环信移动客服系统只支持播放MP3格式的语音消息。使用回调模式投递语音消息到环信时,可以使用以下两种方式:
123第 4 步:设置客服回复消息给微信粉丝
公众号开发者提供回调服务给环信,环信会将客服人员回复的消息发送给提供的服务上,回调的地址集成时可联系环信处理。
目前仅支持文本消息和图片消息类型。
环信回调到消息内容如下:
文本消息:
12345678910111213141516171819202122232425262728图片消息:
12345678910111213141516171819202122232425262728293031323334第 5 步:设置第三方服务器返回响应消息
第三方服务器收到回调消息后,需要给环信服务器发送响应消息。响应内容不能超过1000个字符。
响应消息示例: