APP接入

您已拥有一款手机APP,只需在环信移动客服系统创建“APP关联”,并集成环信提供的SDK,就可以轻松处理来自您的APP用户的咨询。

  • 对于Android版手机APP,环信已推出移动客服Android SDK,只需5分钟即可集成移动客服通用功能。注册移动客服后,请点击:移动客服 Android SDK 集成
  • 对于iOS版手机APP,暂时需要您集成环信即时通讯云(IM) SDK 2.x,为了帮助您快速集成,我们为您准备了“商城”Demo及其源码,请参考下述步骤集成。

注意:环信只提供消息收发功能,APP的UI界面需要自定义。

第1步:注册移动客服账号

在移动客服注册页面,填写您的邮箱、密码等信息,注册移动客服账号。

注册

第2步:快速创建APP关联

移动客服系统的“APP关联”对应即时通讯云(IM)后台的应用。在移动客服系统创建关联后,可直接登录IM后台管理该关联对应的应用。

1. 打开环信移动客服,进入“管理员模式 > 渠道管理 > 手机APP”。

手机APP渠道

2. 点击“添加APP关联”按钮,创建APP关联。支持两种方式:快速创建、关联IM账号。

  • 快速创建:如果您还没有环信即时通讯云的账号,可以直接点击“快速创建”,系统会为您自动创建一个APP关联;
  • 关联IM账号:如果您已有环信即时通讯云的账号,并创建了应用,可以点击“去关联IM账号”,填写关联名称、AppKey、ClientId、ClientSecret、IM服务号、IM Password,手动将您的APP绑定到环信移动客服。

添加APP关联

创建APP关联后,可以查看关联的APP信息,包括关联名称、AppKey、ClientId、ClientSecret等。对于快速创建的关联,您还可以点击“直接登录IM关联后台”,查看更多相关信息。

  • 关联名称:该关联在移动客服系统中的名称,可修改。
  • AppKey:应用的唯一标识,与“IM服务号”共同构成手机APP与移动客服之间的消息通道,不可修改。
  • ClientId和ClientSecret:自动生成,用于获取管理员token,不可修改。其中,管理员token用于使用REST API进行环信即时通讯云的服务端集成。
  • IM服务号:该应用下,IM用户的用户名,与“AppKey”共同构成手机APP与移动客服之间的消息通道,可以修改为其他IM用户的用户名(及对应的密码)。

查看APP关联

第3步:验证该APP关联的消息收发

您可以通过“商城”Demo验证该APP关联的消息收发。打开“商城”Demo,点击“设置”,将设置页面的“AppKey”和“IM服务号”修改为上述APP关联的“AppKey”和“IM服务号”,即可先行体验通过您自己的AppKey发送的消息和留言。

第4步:为您的APP集成用户体系

您需要为您的已有用户和新增用户创建环信ID,并关联起来,才可以在环信移动客服上正确显示访客信息(您的用户信息)。请参考用户和好友体系集成

注:集成过程中有任何技术问题,请联系环信技术支持。

第5步:为您的APP集成消息和留言功能

参考“商城”Demo的开源代码,集成消息和留言功能。

注:集成过程中有任何技术问题,请联系环信技术支持。

后续操作

集成IM SDK后,您可以使用APP扩展集成,实现更多个性化功能。