配置WHATSAPP渠道
前提条件
已从WhatsApp服务路径供应商获取如下信息：
- 供应商为infobip：
- 注册WhatsApp服务路径提供商用户的电话号码
- 注册WhatsApp服务路径提供商的用户名称
- 注册WhatsApp服务路径提供商的用户密码
- WhatsApp服务路径提供商提供接口的url前缀，并向系统管理员提出申请且通过，将其加入地址白名单
- WhatsApp服务路径提供商提供认证的AccountKey
- Webhook密码为渠道接受消息的认证密码，由渠道配置人员自定义。渠道配置后需要通知infobip侧配置，对应infobip侧的webhook接口的acountkey
- 已获取认证证书，认证证书获取方法：
- 访问网址：https://api.infobip.com/。
- 导出浏览器中的证书。
- 参考管理证书，上传认证证书。
- 供应商为other：other为客户自实现bsp对接whatsApp，目前版本只支持ITAU。
当WhatsApp服务路径供应商为other时，存在两种认证方式：
- basic：直接与WhatsApp服务路径提供商鉴权
- oAuth：通过API接口与WhatsApp服务路径提供商鉴权
认证方式不同，需要获取的参数也不同。
- 注册WhatsApp服务路径提供商用户的电话号码。
- 注册WhatsApp服务路径提供商的用户名称。
当WhatsApp服务路径提供商为other，且认证方式为oAuth时，请联系系统管理员在，找到订阅了sendWhatsappMessage接口并绑定了待配置WhatsApp渠道租间的APP，获取APP标识填到用户名称中。
- 注册WhatsApp服务路径提供商的用户密码。
当WhatsApp服务路径提供商为other，且认证方式为oAuth时，请联系系统管理员在，找到订阅了sendWhatsappMessage接口并绑定了待配置WhatsApp渠道租间的APP，获取APP密钥填到密码中。
- WhatsApp服务路径提供商提供接口的url前缀。
当WhatsApp服务路径提供商为other，且认证方式为oAuth时，须配置为：https://IP:PORT/apiaccess/rest/ccmessaging，其中IP:PORT为AICC前台登录IP和端口，可替换成域名。
- WhatsApp服务路径提供商提供认证的key。
- 渠道接受消息的认证密码。
- 已获取WhatsApp服务路径提供商提供的信任证书并在管理证书中上传。
- 当前系统的身份证书并在管理证书中上传。
与WhatsApp服务路径提供商的认证方式为oAuth时，不需要获取。
- 供应商为cloud-api：目前只支持演示，不能商用
- 需要先在Facebook开发者页面创建应用。
- 使用开发者账号登录Facebook，访问https://developers.facebook.com/apps，创建应用。
用例类型选择其他，应用类型选择商务，自定义应用名称，其他的保持默认。
- 返回https://developers.facebook.com/apps，找到刚刚创建的应用，复制应用编号，并访问https://developers.facebook.com/apps/应用编号/settings/basic可查看应用信息。应用编号替换成复制的应用编号。
图1 获取应用信息
应用编号对应客户服务云侧渠道配置的APP标识
应用密钥对应客户服务云侧渠道配置的应用密钥
- 为应用添加产品：WhatsApp。
图2 添加产品
- 选择，配置快速入门。
如果Facebook账号被限制了广告投放功能，请自行申请解封。
- 选择，获取电话号码和BaseUrl。
- 测试号码对应客户服务云侧的电话号码
- 红框中的URL对应客户服务云侧的BaseUrl
- 接收者为WhatsApp渠道服务的对象，为手机号码，需要手动添加，客户才能接入WhatsApp渠道。
图3 获取电话号码和BaseUrl
- 继续访问https://business.facebook.com/settings/system-users，选择应用所在业务实体，在中添加管理员。
“系统用户姓名”可自定义，“系统用户身份”请选择“管理员”。图4 添加和管理员
- 添加资产后，生成新口令。
图5 添加资产
图6 生成新口令
生成的口令权限必须包含whatsapp_business_messaging、whatsapp_business_management。
生成的口令对应客户服务云侧渠道配置的access token
生成新口令会设置有效期，客户服务云侧与Facebook侧的有效期需要保持一致。
- 使用开发者账号登录Facebook，访问https://developers.facebook.com/apps，创建应用。
- 已获取信任证书并在管理证书中上传
- 国内环境：直接访问https://graph.facebook.com/v8.0网站受限，需要先配置代理服务器，再获取代理服务器的信任证书，证书格式要求.der。
- 国外环境：访问https://graph.facebook.com/v8.0网站，以浏览器方式导出证书，证书格式要求.der。
- 当前系统的身份证书并在管理证书中上传。
访问当前系统，以浏览器方式导出证书。
- 需要先在Facebook开发者页面创建应用。
背景信息
当WhatsApp服务路径提供商提供的信息发生变化时，涉及的WHATSAPP渠道需要同步修改，修改方式：租户管理员进入，单击涉及渠道操作列的“修改”，更新用户名称、密码、BaseUrl、AccountKey。
操作步骤
- 以租户管理员角色登录客户服务云，选择。
- 单击“新增”，打开社交媒体开通配置页面。
输入“渠道接入编码”，选择“WHATSAPP”渠道，然后单击“下一步”，进入WHATSAPP渠道的配置页面。
渠道接入编码必须是唯一的，输入值只能由字母，数字或下划线组成（首字符只能用字母和下划线），最大长度为64个字符。
- 配置WHATSAPP渠道的“选择配置方法”参数。
表1 WHATSAPP渠道参数配置 参数
说明
个性化配置
根据前提条件中获得的信息配置。
公共配置
渠道接入编码
展示在2设置的渠道接入编码，支持修改。
组织配置
为渠道资源分配组织机构，从配置组织机构中选择一个创建好的组织机构。
信息配置
需要配置以下参数：
- 技能队列：配置框会查询当前租间的所有多媒体被叫配置，用户酌情选择。
- 转人工关键字：用户在WHATSAPP客户端输入该关键字后会由机器人服务转为人工座席服务。
说明：
若不开启智能机器人，转人工关键字可不设置。
熟客模式
开启后需配置以下参数：
- 选择方式：熟客的选择方式，包括自定义时间范围和当天两种。
- 时间范围（小时）：选择方式选择时间范围后，需要配置该参数。
会话结束方式
自定义访客未回复超时时间和会话结束回复语，默认关闭，若不开启，默认3分钟超时，打开后需要配置。
- 客户未回复提醒时间间隔（分钟）：用户在客户端无会话达到该时间后会断开连接，默认配置为3分钟。
- 会话结束语：会话断开后结束提醒。
座席超时转移设置
自定义座席未回复超时时间和重新分配新座席提示语。
开启后需配置以下参数：
- 座席超时未回复转移时间（分钟）
- 重新分配新座席提示语
会话转移设置
座席转移会话时仅展示对应渠道类型的技能队列。
离线消息
具体配置可参考如何开启离线消息。
座席工作时间
- 工作日：可配置0-24小时间最多4个工作时间段。默认展示一个时间段，单击新增，可增加时间段配置。
- 非工作日：可配置0-24小时间最多4个工作时间段。默认展示一个时间段，单击新增，可增加时间段配置。
- 非工作时间提醒信息：非工作时间内，客户呼叫接入后，提示已配置的消息内容，提醒客户当前座席休息。
机器人设置
默认关闭，表示直接转座席。开关开启，需要根据实际情况配置机器人信息。需配置以下参数：
- 更换头像：可更换机器人头像。
- 名字：为机器人添加名字。
- 性别：为机器人添加性别。
- 机器人接入码：从智能IVR中选择配置好的机器人接入码。
- 默认回复语：当机器人不能识别客户语意，自定义回复语。
- 超时回复语：当客户会话超时，自定义超时回复语。
- 转人工提示语：自定义转人工成功提示语。
- 静默座席技能队列：配置框会查询当前租间的所有多媒体被叫配置，用户酌情选择。
机器人助手配置
默认关闭。开关开启，则在座席侧开启机器人助手。
- 机器人助手接入码：从智能IVR中选择配置好的机器人助手接入码。
- 单击“保存并进行下一步”，进入到集成说明页面。
