配置微信渠道

租户管理员可以配置用户接入微信渠道。

前提条件

秘钥托管前提条件：
- 系统管理员已在“配置中心 > 系统管理 > 证书管理”中上传微信认证证书。证书获取方式：如图1红框所示，单击证书名称后，再次单击“导出”以获取微信认证证书。
  图1 导出微信证书
- 测试环境，配置微信渠道需要提前进入微信公众平台，申请测试账号的对接ID和密钥。
  1. 打开微信公众平台测试账号网站：https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index，使用个人微信扫码登录。
    图2 微信公众平台
  2. 获取测试号的相关信息。
    图3 测试号信息
- 商用环境，配置微信渠道需要提前进入微信公众平台，注册正式的公众号等操作。
  1. 请打开微信公众平台官网：https://mp.weixin.qq.com/，参考如下微信侧文档完成正式微信公众号的注册，微信侧有多种公众号类型，推荐选择服务号。
    - 中国内地账号注册流程请参见：https://kf.qq.com/faq/120911VrYVrA151013MfYvYV.html
    - 境外账号注册流程请参见：https://kf.qq.com/faq/180312zQjeYV180312FNNbmA.html
  1. 登录微信公众号，在“公众号 > 设置与开发 > 开发接口管理 > 基本配置”页面中获取AppID和AppSecret。
  2. 将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的值。

操作步骤

以租户管理员角色登录AICC，选择“配置中心 > 接入配置 > 渠道配置”，进入渠道列表页面。
单击“新建”，打开社交媒体开通配置页面。

配置渠道信息。

表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。

扫码托管说明：

选择扫码托管后，单击页面的“点击进入微信扫码授权”，将弹出包含二维码的公众平台账号授权页面。
使用通过微信认证的微信号登录微信，扫描弹出的二维码，界面提示扫描成功，请在手机上进行授权。

一个公众号/小程序帐号只可以绑定在一个开放平台帐号下。
您在手机界面上授权后，界面将提示授权成功，完成扫码托管，重新回到渠道配置界面完成后续配置。

配置基础配置。

表3 基础配置参数说明
参数	说明
渠道名称	渠道名称必须是唯一的，输入值只能由字母，数字或下划线组成（首字符只能用字母和下划线），最大长度为64个字符。
组织配置	为渠道资源分配组织机构，从配置组织机构中选择一个创建好的组织机构。
技能队列	会查询当前租间的所有多媒体被叫配置，配置方法请参见配置被叫。其中查询条件：“所有可访问组织”，由租户级参数“租户是否开启组织间的数据强制隔离机制”控制，开启后支持根据组织机构查询被叫配置。同时未配置组织机构权限的非管理员账号仅支持查询当前组织下的被叫配置。
转人工关键字	用户在客户端输入该关键字后会由机器人服务转为人工座席服务。说明：开启智能机器人，转人工关键字必须设置。
座席工作时间	工作日：可配置0-24小时间最多4个工作时间段。默认展示一个时间段，单击新增，可增加时间段配置。非工作日：可配置0-24小时间最多4个工作时间段。默认展示一个时间段，单击新增，可增加时间段配置。非工作日为在“配置中心 > 工作台配置 > 在线交谈服务时间”页面设置的休息日。
非工作时间提醒信息	非工作时间内，客户呼叫接入后，提示已配置的消息内容，提醒客户当前座席休息。
排队提醒	选择排队提醒方式。全部提醒排队提醒排队进展提醒关闭提醒
排队提醒内容	设置排队提醒内容。长度限制256，不允许配置特殊字符<>'"/\ “排队提醒”设置为“全部提醒”、“排队提醒”时，该参数为必填项。
排队进展提醒内容	设置排队进展提醒内容。长度限制256，不允许配置特殊字符<>'"/\ 支持设置变量，绑定变量仅支持userId（用户ID）、nickName（用户名称）、position（排队位置）、waitTime（预估等待时间，单位：秒）默认值：您当前正在排队中，排在第${position}位，预计还要等待${waitTime}秒。 “排队提醒”设置为“全部提醒”、“排队进展提醒”时，该参数为必填项。
呼叫转移交互次数	座席给用户发送的消息数，如果达到配置的交互次数，才可以使用呼叫转移功能。当取值为0或为空时，座席可以随时使用呼叫转移功能。
更多配置
熟客模式	配置方法请参见如何开启熟客模式
客户超时结束会话	配置方法请参见如何设置客户超时结束会话
座席超时转移会话	配置方法请参见如何设置座席超时转移会话
会话转移设置	配置方法请参见如何设置会话转移设置

配置机器人配置。

表4 机器人配置参数说明
参数	说明
接入智能机器人	配置方法请参见如何接入智能机器人
接入机器人助手	配置方法请参见如何接入机器人助手

配置集成说明，仅秘钥托管方式下需要操作。
1. 进入到集成说明页面。
2. 将渠道集成页面生成的网址和验证码信息填入微信公众平台侧。
  - 测试账号：进入微信公众平台的测试页面，将“网址”和“验证码”填入到接口配置中。单击提交，进行Token认证。
  - 正式公众号：选择“公众号 > 设置与开发 > 开发接口管理 > 基本配置”将“网址”和“验证码”填入到服务器配置的“URL”和“Token”中。
    其中“EncodingASEKey”请自定义，手动填写或随机生成，将用作消息体加解密密钥。“消息加解密方式”请自定义。
认证通过后，说明接入成功，返回AICC的渠道配置页面，单击“提交”，进入到接入成功页面，微信渠道接入配置完成。