====== 创建APP关联 ======

环信客服云的“APP关联”对应即时通讯云（IM）后台的应用，是客服与app/网页访客端客户之间收发消息的通道。在客服云创建关联后，可以在IM后台管理该关联对应的应用。


===== 快速创建 =====

1. 打开[[http://kefu.sh.absoloop.com/mo/login|环信客服云]]，进入“管理员模式 > 渠道管理 > 手机APP”。

{{:cs:start-app5.png?nolink|手机APP渠道}}

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

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

{{:cs:releasenote:admin-channel-app2.png?nolink|添加APP关联}}

3. 点击“快速创建”按钮，快速创建一个APP关联。

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

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

{{:cs:admin-channel-app3.png?nolink|查看APP关联}}

<WRAP round tip>
**注意：**

从2017年8月8日起，通过点击“快速创建”按钮新创建的APP关联位于环信的vip5服务器集群，此集群内每个应用的IM用户总数上限为10000000个。使用REST API方式进行[[im:100serverintegration:20users|用户体系集成]]时，请将示例的服务器域名更改为https://a1-vip5.easemob.com。

通过[[http://console.easemob.com/|即时通讯云管理后台]]注册的应用，在进行[[im:100serverintegration:20users|用户体系集成]]时，仍然使用文档中示例的服务器域名。
</WRAP>
===== 手动添加 =====

1. 打开[[http://kefu.sh.absoloop.com/mo/login|环信客服云]]，进入“管理员模式 > 渠道管理 > 手机APP”。

{{:cs:start-app5.png?nolink|手机APP渠道}}

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

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

{{:cs:releasenote:admin-channel-app2.png?nolink|添加APP关联}}

3. 点击“关联IM账号”按钮，填写下图中的信息，手动添加一个APP关联。

注：关联中填写的IM服务号为IM用户的用户名，**必须为小写，不能包含大写字母**。

{{:cs:300visitoraccess:start-app10.png?nolink|关联IM账号}}

手动添加APP关联后，可以查看关联的APP信息。

{{:cs:300visitoraccess:start-app11.png?nolink|查看APP关联}}