# 配置一键双呼
为租间选择一键双呼类型，包括云客服双呼和ITA双呼，在后续调用座席双呼接口时以此处选择的双呼类型为准。同时为一键双呼配置回调相关信息，一键双呼结束时回调配置的URL并传递呼叫相关数据。
#### 前提条件
- 租间开启一键双呼特性。
- 一键双呼的回调URL已通过系统管理员加入手机客服回调的地址白名单中。
- 当前菜单下部分操作支持单独权限控制，未配置相关操作权限时，不支持对应的操作。支持单独配置的操作权限详情请参考[表1](https://support.huaweicloud.com/usermanual-cec/cec_04_0005.html#ZH-CN_TOPIC_0000002509976017__zh-cn_topic_0000002456193157_zh-cn_topic_0000002130159869_zh-cn_topic_0210228460_table12706174092516)。
 
#### 背景信息
- 当回调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的双呼接口。此处选择后，在后续调用座席双呼接口时以此处选择的双呼类型为准。
   ![](https://support.huaweicloud.com/usermanual-cec/public_sys-resources/note_3.0-zh-cn.png)
   若您选择了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由第三方系统提供，AICC会将当前通话事件推送给此URL，更多关于回调URL的说明请参见回调接口。url必须以http或https开头。
        ![](https://support.huaweicloud.com/usermanual-cec/public_sys-resources/note_3.0-zh-cn.png)
        HTTP协议不是安全的网络协议，如确定使用，可能存在安全风险。推荐使用HTTPS协议。
        HTTPS采用TLS1.2及以上版本，确保web应用的敏感数据在传输过程中不被非法截获
        
      
      - 接通/挂机回调方法：默认配置为POST。
       
   
   2. 配置接口调用URL鉴权。
      - 回调URL鉴权方式：共享密钥签名、OAuth 2.0、不鉴权。
        ![](https://support.huaweicloud.com/usermanual-cec/public_sys-resources/note_3.0-zh-cn.png)
        此处的回调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、不鉴权。
        ![](https://support.huaweicloud.com/usermanual-cec/public_sys-resources/note_3.0-zh-cn.png)
        此处的回调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. 参考[管理证书](https://support.huaweicloud.com/usermanual-cec/cec_04_0462.html#ZH-CN_TOPIC_0000002478096298)中的方式，获取ITA认证证书。
   
   ![](https://support.huaweicloud.com/usermanual-cec/public_sys-resources/note_3.0-zh-cn.png)
   对接ITA双呼，必须上传对应的认证证书。可参考浏览器方式获取证书，证书获取地址如下：https://*ITA域名*/v1/ngin/axmn。
   
   
2. 以系统管理员sysadmin用户登录客户服务云，选择"配置中心 \> 系统管理 \> 证书管理"，进入配置页面。
3. 单击"新建"，证书编码必须设置为CERT_ITA、选择证书类型为DER，选择已获取的ITA认证证书。
4. 单击"保存"。证书上传完成后需等待5分钟生效。