配置一键双呼

前提条件

• 租间开启一键双呼特性。
• 一键双呼的回调URL已通过系统管理员加入手机客服回调的地址白名单中。

背景信息

• 当回调URL鉴权方式选择了共享密钥签名时，如果后续共享密匙发生变化，涉及的一键双呼的配置项也要修改，修改方式：租户管理员进入“配置中心 > 扩展与集成管理 > 双呼配置”，单击“编辑”，更新共享密匙的值。
• 当回调URL鉴权方式选择了OAuth 2.0时，如果OAuth 2.0授权的AK、SK发生变化，涉及的一键双呼的配置项也要修改，修改方式：租户管理员进入“配置中心 > 扩展与集成管理 > 双呼配置”，单击“编辑”，更新AK、SK的值。
• 当一键双呼的类型选择了ITA双呼时，如果ITA侧提供的accessKey、appKey、secretKey发生变化，涉及的一键双呼的配置项也要修改，修改方式：租户管理员进入“配置中心 > 扩展与集成管理 > 双呼配置”，单击“编辑”，更新accessKey、appKey、secretKey的值。

操作步骤

1. 以租户管理员角色登录客户服务云，选择“配置中心 > 扩展与集成管理 > 双呼配置”，进入配置页面，开始配置回调URL以及为租间选择双呼类型。
2. 单击“编辑”配置一键双呼的回调URL。
   • 接通/挂机回调url：配置接通/挂机回调url。url必须以http或https开头。
   

   HTTP协议不是安全的网络协议，如确定使用，可能存在安全风险。推荐使用HTTPS协议。

   • 接通/挂机回调方法：默认配置为POST。
   • 请选择回调URL鉴权方式：共享密钥签名、OAuth 2.0、不鉴权。
     

     此处的回调URL鉴权方式设置是针对通过接口方式传入回调URL，通过界面方式传入回调URL默认不鉴权。

     不鉴权有安全风险，请谨慎使用。

   • 请输入共享密匙：当回调URL鉴权方式选择了共享密钥签名时需配置，密匙长度不少于16个字符。
   • 请输入OAuth 2.0授权信息：当回调URL鉴权方式选择了OAuth 2.0时需配置。
     • 请输入AK：AK（Access Key ID），访问密钥ID。与私有访问密钥关联的唯一标识符。
     • 请输入SK：SK（Secret Access Key），与访问密钥ID结合使用的密钥。
     • 请输入OAuth 2.0鉴权Login URL：获取OAuth 2.0访问令牌的地址。目前OAuth 2.0鉴权方式仅用于AppCube这个组件。

3. 配置一键双呼的类型。
   1. 单击“编辑”，选择一键双呼的类型：云客服双呼、ITA双呼。

      云客服双呼：AICC云客服系统自带的双呼，ITA双呼：云客服侧封装了ITA的双呼接口。此处选择后，在后续调用座席双呼接口时以此处选择的双呼类型为准。

      

      若您选择了ITA双呼，请在ITA侧确认已配置好话单推送URL，否则会影响ITA的话单推送到云客服，推送URL示例:

      https://10.243.7.176:28090/apiaccess/rest/cc-management/v1/ita/twopartiescall/statusnotify

   2. 选择了ITA双呼后，请配置如下ITA的参数。
      • 请输入accessKey：ITA侧提供
      • 请输入secretKey：ITA侧提供
      • 请输入appKey：ITA侧提供
      • 请输入ITA域名：ITA侧提供
      • 系统分配或接入商指定：暂不支持系统分配。
      • 请输入X号码：ITA侧提供的购买的号码。

4. 配置完成后单击“保存”。

后续操作（仅针对ITA双呼）

若您选择了ITA双呼，请参照下面描述配置ITA双呼的认证证书。

1. 参考管理证书中的方式，获取ITA认证证书。
   

   对接ITA双呼，必须上传对应的认证证书。可参考浏览器方式获取证书，证书获取地址如下：https://ITA域名/v1/ngin/axmn。

2. 以系统管理员sysadmin用户登录客户服务云，选择“配置中心 > 系统管理 > 证书管理”，进入配置页面。
3. 单击“创建”，证书编码必须设置为CERT_ITA、选择证书类型为DER，选择已获取的ITA认证证书。

   

4. 单击“完成”。证书上传完成后需等待5分钟生效。