====== 微信渠道集成 ======

微信渠道包含微信公众号和微信小程序，环信客服云支持与二者进行绑定，提供咨询服务。

===== 微信公众号集成 =====

首次在微信公众号使用环信客服云时，需要先在环信客服云绑定微信公众号。

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

未通过微信认证的服务号或订阅号无法使用环信客服云的完整功能。使用环信客服云时，需停用微信多客服，并关闭多客服客户端上的自动回复功能。
</WRAP>

微信公众号集成支持三种模式：授权模式、回调模式、H5网页跳转模式。
==== 授权模式集成 ====

将微信公众号授权第三方平台“环信移动客服”，在客服云上绑定微信公众号，使客服可以直接与公众号的粉丝对话。

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

私有部署场景下，需要企业提前在微信开放平台申请并[[cs:300visitoraccess:30wechat:wechat-3rd-party-platform|开通第三方平台]]，并将第三方平台的AppID和AppSecret提供给环信运维工程师。
</WRAP>

1. [[http://kefu.easemob.com/|登录]]环信客服云，进入“管理员模式 > 渠道管理 > 微信”。

{{:cs:start-wechat1.png?nolink|微信渠道}}

2. 点击“添加微信公众账号”，添加微信公众号。

{{:cs:start-wechat2.png?nolink|添加微信公众号}}

3. 点击“登录授权”，进入微信公众平台，扫描二维码授权第三方平台“环信移动客服”。

{{:cs:start-wechat3.png?nolink|授权环信客服云}}

4. 绑定成功后，通过微信公众平台设置的“自定义菜单”将会暂时失效，需重新设置自定义菜单。点击微信公众号，选择“自定义菜单”进行设置。

{{:cs:200admin:admin-channel-wechat.png?nolink|设置微信公众号的自定义菜单}}

注意：

  * 通过微信公众平台编辑的素材库可以进入环信客服云的“管理员模式→渠道管理→微信”继续使用。
  * 解除绑定时，需进入微信公众平台的“添加功能插件→授权管理”取消绑定。

==== 回调模式集成 ====

针对有开发者的公众号，需要首先将公众号设置为开发者模式，微信会将粉丝发送的信息及事件推送到设定的第三方服务器地址上。第三方服务器接收到微信推送过来的粉丝消息后，根据需要有选择的将消息通过API转发到环信客服云；客服回复后环信会将消息推送给接收消息的第三方服务器，由该服务器将客服回复消息转发给微信公众号的粉丝。

关于具体集成方式和消息体示例，请参考[[cs:300visitoraccess:restapi|REST API渠道集成]]。

==== H5网页跳转模式集成 ====

环信客服云提供H5网页聊天窗口，将H5网页地址添加到微信公众号的自定义菜单，即可为微信公众号的粉丝提供咨询入口。

=== 添加H5网页地址 ===

1. 获取网页插件的configId。[[http://kefu.easemob.com/|登录]]环信客服云，进入“管理员模式 > 渠道管理 > 网页”，找到网页插件的configId。如下图所示。

{{:cs:admin-channel-web7.png?nolink|获取configId}}

2. 设置H5网页聊天窗口地址。将configId的值填入下述网址中xxxx的位置，即可获得H5网页地址。

<code http>https://kefu.easemob.com/webim/im.html?configId=xxxx</code>

3. 设置自定义菜单。登录微信公众平台，打开“自定义菜单”，将H5网页链接地址添加到“联系客服”菜单上，保存并更新微信公众号。

//注：Android版微信菜单更新存在一定时间延迟。//

=== 获取微信公众号的粉丝信息 ===

当前，微信的H5页面，并不会传微信公众号信息到客服端，所以客服端显示的访客ID是webim id（环信ID）。

如果您需要H5页面将微信的openid等公众号信息传至客服端，使客服端显示的访客ID包含微信的openid，可以配置参数wechatAuth=true和appid={appid}。其中，appid为微信公众号的ID。

配置示例：

<code http>https://kefu.easemob.com/webim/im.html?configId={configId}&wechatAuth=true&appid=wx1e7ed77036581061</code>

注意：当您配置wechatAuth和appid这两个参数时，还需要在客服云的“管理员模式 > 渠道管理 > 微信”页面通过授权的方式绑定您的微信公众号。建议授权后，直接在环信客服云的“渠道管理 > 微信”页面，将上述H5地址添加至自定义菜单。

===== 微信小程序集成 =====

环信客服云支持微信小程序接入，绑定后您可以使用环信客服云统一接收与回复通过小程序咨询的消息。小程序属于微信渠道，小程序用户产生的会话消息将以微信渠道的形式在客服工作台进行展示和统计。

集成步骤如下：

**第1步：获取微信小程序的基本信息。**

进入微信公众平台获取“小程序名称”、“原始ID”、“AppID”和“AppSecret”。

1. 进入“设置 > 基本设置”页面获取“小程序名称”和“原始ID”。

{{:cs:300visitoraccess:30wechat:wechat-miniprogram4.png?nolink|小程序基本设置页面}}

2. 进入“设置 > 开发设置”页面获取“AppID”和“AppSecret”。

{{:cs:300visitoraccess:30wechat:wechat-miniprogram3.png?nolink|小程序开发设置页面}}

**第2步：在环信客服云添加微信小程序。**

在环信客服云添加微信小程序，填写小程序的基本信息，生成服务器URL。

1. 进入“管理员模式 > 渠道管理 > 微信”页面，点击“添加微信关联”，并点击“添加微信小程序”。

{{:cs:300visitoraccess:30wechat:wechat-miniprogram.png?nolink|添加微信小程序}}

2. 在“添加微信小程序”页面，填写小程序名称、原始ID、AppID、AppSecret，并点击下一步。

{{:cs:300visitoraccess:30wechat:wechat-miniprogram1.png?nolink|填写小程序的基本信息}}

3. 获取环信生成的服务器URL。

{{:cs:300visitoraccess:30wechat:wechat-miniprogram7.png?nolink|生成服务器URL}}

**第3步：配置微信小程序的消息推送。**

进入微信公众平台，配置微信小程序的消息推送。然后，将小程序的Token（令牌）和EncodingAESkey填入环信客服云，完成微信小程序的配置。

1. 进入微信公众平台的“设置 > 开发设置”页面，在“消息推送”区域，填入上一步生成的服务器URL，设置Token（令牌），并生成EncodingAESkey。

<WRAP round tip>
注意：选择消息加密方式为“安全模式”，数据格式为“XML”。
</WRAP>


{{:cs:300visitoraccess:30wechat:wechat-miniprogram5.png?nolink|配置微信小程序的消息推送}}

2. 进入环信客服云，填写微信小程序的Token（令牌）和EncodingAESkey，并点击下一步，完成绑定微信小程序。

{{:cs:300visitoraccess:30wechat:wechat-miniprogram6.png?nolink|绑定微信小程序}}

**第4步：在微信小程序上配置客服按钮。**

在微信小程序的源码中添加如下代码，配置客服按钮。完成后，微信用户即可点击该按钮发起咨询。

<code>
<button open-type="contact" bindcontact="handleContact">客服</button>
</code>