# 配置微信渠道
租户管理员可以配置用户接入微信渠道。
#### 前提条件
- 秘钥托管前提条件：
- 系统管理员已在"配置中心 \> 系统管理 \> 证书管理"中上传微信认证证书。证书获取方式：如[图1]红框所示，单击根证书证书名称后，再单击"导出"以获取微信认证证书。
图1导出微信证书
- 测试环境，配置微信渠道需要提前进入微信公众平台，申请测试账号的对接ID和密钥。
1. 打开微信公众平台测试账号网站：[https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo\&t=sandbox/index](https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index)，使用个人微信扫码登录。
图2微信公众平台
2. 获取测试号的相关信息。
图3测试号信息
- 商用环境，配置微信渠道需要提前进入微信公众平台，注册正式的公众号等操作。
1. 请打开微信公众平台官网：，参考如下微信侧文档完成正式微信公众号的注册，微信侧有多种公众号类型，推荐选择服务号。
- 中国内地账号注册流程请参见：
- 境外账号注册流程请参见：
2. 登录微信公众号，在"公众号 \> 设置与开发 \> 开发接口管理 \> 基本配置"页面中获取AppID和AppSecret。
3. 将AICC系统对外的公网IP地址添加到IP白名单中。
1. 登录AICC的K8S容器后台，查询WeChatAdapter的容器名称。
2. 进入WeChatAdapter容器，*aicc-wechatadapter-7b66c5bc6-9db25* 为[3.a]查询到的WeChatAdapter的容器名称。
```
klog aicc-wechatadapter-7b66c5bc6-9db25 bash
```
3. 执行如下命令，[图4]红框所示即为查询到的IP地址。
```
curl ipinfo.io
```
图4公网IP
4. 选择"公众号 \> 设置与开发 \> 开发接口管理 \> 基本配置"，将[3.c]查询到的AICC系统对外的公网IP地址添加到IP白名单中。
- 扫码托管前提条件： 企业主体的公众号通过微信认证以及创建第三方平台账号并进行全网发布。
#### 背景信息
- 如果微信提供的AppID和AppSecret发生变化时，AICC侧涉及的微信渠道也要修改，修改方式：租户管理员进入"配置中心 \> 接入配置 \> 渠道配置"，单击涉及渠道操作列的"编辑"，更新"App ld"、"App密钥"的值。
- 微信消息加密开关，开启后，"EncodingAESKey"需要填入与微信平台一致的内容。若微信平台侧有变更，AICC侧需要同步修改。修改方式如下：
- 微信平台侧：登录开发者账号，进入"公众号 \> 设置与开发 \> 开发接口管理 \> 基本配置"，更新消息加解密密钥（EncodingAESKey）的值。
- AICC侧：租户管理员进入"配置中心 \> 接入配置 \> 渠道配置"，单击涉及渠道操作列的"编辑"，更新EncodingAESKey的值。
#### 操作步骤
1. 以租户管理员角色登录AICC，选择"配置中心 \> 接入配置 \> 渠道配置"，进入渠道列表页面。
2. 单击"新建"，打开社交媒体开通配置页面。
3. 配置渠道信息。
表1渠道信息参数说明
| 参数 | 说明 |
|:---|:---|
| 渠道选择 | 选择微信 |
| 托管方式 | 取值范围： - 秘钥托管：参数说明请参见[表2] - 扫码托管：操作详情，请参见[3.a]。 请依据实际场景选择托管方式 |
表2秘钥托管参数说明
| 参数 | 说明 |
|:---|:---|
| App Id | 输入微信公众平台中获取的AppID和AppSecret值。获取方法参考[申请对接ID和密钥]。 |
| App密钥 | 输入微信公众平台中获取的AppID和AppSecret值。获取方法参考[申请对接ID和密钥]。 |
| 微信消息加密开关 | 是否开启微信消息加密。 取值范围： - ：关闭 - ：开启 默认值： 请注意，关闭消息加密，可能存在安全风险。注意与微信公众平台配置保持一致。 |
| EncodingAESKey | 密钥长度为43且只能包含A-Z,a-z,0-9 "微信消息加密开关"开启后，"EncodingAESKey"需要填入与微信平台一致的内容。若微信平台侧有变更，AICC侧需要同步修改。修改方式如下： - 微信平台侧：登录开发者账号，进入"微信公众号 \> 设置与开发 \> 开发接口管理 \> 基本配置"，更新消息加解密密钥（EncodingAESKey）的值。 - AICC侧：租户管理员进入"配置中心 \> 接入配置 \> 渠道配置"，单击涉及渠道操作列的"编辑"，更新EncodingAESKey的值。 |
| 对接加密算法 | 对接微信的加密算法，取值范围： - SHA-1 - SHA-256 说明： SHA-1算法强度不够，存在安全风险。如果平台支持，建议选择更高强度的算法SHA-256。 |
扫码托管说明：
1. 选择扫码托管后，单击页面的"点击进入微信扫码授权"，将弹出包含二维码的公众平台账号授权页面。
2. 使用通过微信认证的微信号登录微信，扫描弹出的二维码，界面提示扫描成功，请在手机上进行授权。
一个公众号/小程序帐号只可以绑定在一个开放平台帐号下。
3. 您在手机界面上授权后，界面将提示授权成功，完成扫码托管，重新回到渠道配置界面完成后续配置。
4. 配置基础配置。
表3基础配置参数说明
| 参数 | 说明 |
|:---|:---|
| 渠道名称 | 渠道名称必须是唯一的，输入值只能由字母，数字或下划线组成（首字符只能用字母和下划线），最大长度为64个字符。 |
| 组织配置 | 为渠道资源分配组织机构，从[配置组织机构](https://support.huaweicloud.com/usermanual-cec/cec_04_0003.html#ZH-CN_TOPIC_0000002510095985)中选择一个创建好的组织机构。 |
| 技能队列 | 会查询当前租间的所有多媒体被叫配置，配置方法请参见[配置被叫](https://support.huaweicloud.com/usermanual-cec/cec_04_0018.html#ZH-CN_TOPIC_0000002478096036)。 其中查询条件："所有可访问组织"，由租户级参数"租户是否开启组织间的数据强制隔离机制"控制，开启后支持根据组织机构查询被叫配置。同时未配置组织机构权限的非管理员账号仅支持查询当前组织下的被叫配置。 |
| 转人工关键字 | 用户在客户端输入该关键字后会由机器人服务转为人工座席服务。 说明： 开启智能机器人，转人工关键字必须设置。 |
| 座席工作时间 | - 工作日：可配置0-24小时间最多4个工作时间段。默认展示一个时间段，单击"添加时段"，可增加时间段配置。 - 非工作日：可配置0-24小时间最多4个工作时间段。默认展示一个时间段，单击"添加时段"，可增加时间段配置。 非工作日为在"配置中心 \> 工作台配置 \> 在线交谈服务时间"页面设置的休息日。 |
| 非工作时间提醒信息 | 非工作时间内，客户呼叫接入后，提示已配置的消息内容，提醒客户当前座席休息。 |
| 排队提醒 | 选择排队提醒方式。 - 全部提醒 - 排队提醒 - 排队进展提醒 - 关闭提醒 |
| 排队提醒内容 | 设置排队提醒内容。 长度限制256，不允许配置特殊字符\<\>'"/\\ "排队提醒"设置为"全部提醒"、"排队提醒"时，该参数为必填项。 |
| 排队进展提醒内容 | 设置排队进展提醒内容。 - 长度限制256，不允许配置特殊字符\<\>'"/\\ - 支持设置变量，绑定变量仅支持userId（用户ID）、nickName（用户名称）、position（排队位置）、waitTime（预估等待时间，单位秒）、waitTimeInMinute（预估等待时间，单位分钟）。 变量waitTime、waitTimeInMinute只需配置其中一个即可。 - 默认值：您当前正在排队中，排在第${position}位，预计还要等待 ${waitTime}秒。 "排队提醒"设置为"全部提醒"、"排队进展提醒"时，该参数为必填项。 |
| 呼叫转移交互次数 | 座席给用户发送的消息数，如果达到配置的交互次数，才可以使用呼叫转移功能。 当取值为0或为空时，座席可以随时使用呼叫转移功能。 |
| **更多配置** ||
| 熟客模式 | 配置方法请参见[如何开启熟客模式](https://support.huaweicloud.com/usermanual-cec/cec_04_0085.html#ZH-CN_TOPIC_0000002509976059) |
| 客户超时结束会话 | 配置方法请参见[如何设置客户超时结束会话](https://support.huaweicloud.com/usermanual-cec/cec_04_0086.html#ZH-CN_TOPIC_0000002478096072) |
| 座席超时转移会话 | 配置方法请参见[如何设置座席超时转移会话](https://support.huaweicloud.com/usermanual-cec/cec_04_0087.html#ZH-CN_TOPIC_0000002510096029) |
| 会话转移设置 | 配置方法请参见[如何设置会话转移设置](https://support.huaweicloud.com/usermanual-cec/cec_04_0088.html#ZH-CN_TOPIC_0000002477936100) |
5. 配置机器人配置。
表4机器人配置参数说明
| 参数 | 说明 |
|:---|:---|
| 接入智能机器人 | 配置方法请参见[如何接入智能机器人](https://support.huaweicloud.com/usermanual-cec/cec_04_0094.html#ZH-CN_TOPIC_0000002478096076) |
| 接入机器人助手 | 配置方法请参见[如何接入机器人助手](https://support.huaweicloud.com/usermanual-cec/cec_04_0095.html#ZH-CN_TOPIC_0000002510096033) |
6. 配置集成说明，仅秘钥托管方式下需要操作。
1. 进入到集成说明页面。 
2. 将渠道集成页面生成的网址和验证码信息填入微信公众平台侧。
- 测试账号：进入微信公众平台的测试页面，将"网址"和"验证码"填入到接口配置中。单击提交，进行Token认证。 
- 正式公众号：选择"公众号 \> 设置与开发 \> 开发接口管理 \> 基本配置"将"网址"和"验证码"填入到服务器配置的"URL"和"Token"中。 其中"EncodingASEKey"请自定义，手动填写或随机生成，将用作消息体加解密密钥。"消息加解密方式"请自定义。
7. 认证通过后，说明接入成功，返回AICC的渠道配置页面，单击"提交"，进入到接入成功页面，微信渠道接入配置完成。
#### 后续说明
使用微信扫描测试公众号的二维码关注，并在公众号后台发送消息，才能和座席建立连接。
#### 后续操作
导出渠道配置。
- 导出范围：基础配置、机器人配置下所有配置。密码密钥不支持导出。
- 单次导出渠道配置记录最多100000条，单个导出文件限制2000条。
- 不勾选渠道，默认导出全部渠道配置。
- 输入压缩密码后，单击可以查看密码的明文。
1. 返回在渠道配置列表。
2. 勾选已创建的渠道配置，单击，导出渠道配置。
3. 单击，当"导出任务状态"为"成功"。
4. 单击"下载"，即可获得导出的渠道配置。