配置一键双呼

前提条件

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

背景信息

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

操作步骤

1. 以租户管理员角色登录客户服务云，选择“配置中心 > 扩展与集成 > 双呼”，进入双呼页面。
2. 单击“编辑”配置一键双呼的配置。
3. 选择一键双呼的类型：云客服双呼、ITA双呼。

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

   

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

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

4. 配置云客服双呼。
   1. 配置回调URL。
      • 接通回调url/挂机回调URL：配置接通回调url/挂机回调URL。url必须以http或https开头。
        

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

      • 接通/挂机回调方法：默认配置为POST。
   2. 配置接口调用URL鉴权。
      • 回调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这个组件。

5. 配置ITA双呼。
   1. 配置接口调用URL鉴权。
      • 回调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这个组件。
   2. 配置ITA参数。
      • AccessKey：ITA侧提供
      • SecretKey：ITA侧提供
      • AppKey：ITA侧提供
      • ITA域名：ITA侧提供
      • X号码分配模式：
        • 系统分配
        • 接入商指定
      • X号码：ITA侧提供的购买的号码。

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

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

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

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

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

2. 以系统管理员sysadmin用户登录AICC，选择“配置中心 > 系统管理 > 证书管理”，进入配置页面。
3. 单击“新建”，证书编码必须设置为CERT_ITA、选择证书类型为DER，选择已获取的ITA认证证书。
4. 单击“保存”。证书上传完成后需等待5分钟生效。