动态IVR呼转回调接口

回调触发点：

• 当按键查询呼转开关关闭时，接收到呼入请求直接回调。

• 当按键查询呼转开关打开时，播放IVR提示音后，等待用户按键结束后进行回调。

呼转回调接口可用于以下场景：

• 多个坐席或者服务人员，使用同一个号码，对用户进行语音外呼。当某个接到该电话的用户，回拨该外呼号码时，需要把这个呼入电话，呼转到指定服务人员号码上，从而提供精准的客户服务。

• 在商城有多个小商家入驻时，统一提供对外的呼入服务号码，和多个商家的分机号。当用户呼入该服务号码时，提示客户按键呼转到指定商家的分机号上；从而解决平台提供统一服务号码，给多个中小商家快速提供客服热线的能力。该功能也适用于企业的呼入总机服务，解决简单分机呼转需求。

开启动态IVR呼转功能，需要将呼入设置指定为动态IVR，并指定URL。

1. 登录语音服务控制台。

2. 在左侧导航栏选择通用设置。

3. 在呼叫设置页签，单击修改全局配置或单击添加指定号码呼入配置。

   说明

   若需统一设置所有号码的提示音，请选择修改全局配置；若需为特定号码单独设置，请选择添加指定号码呼入配置。

4. 配置类型指定为动态IVR。

5. 填写URL。

   此处的URL是客户自定义获取呼转被叫号码的HTTP地址，触发回拨事件后，语音服务会采集呼叫信息，自动将呼叫信息作为固定请求参数添加到此处的URL中，并发起请求。

   此处填写的格式为：

   http://IP地址：端口号/test?action=getTransferNumber

   添加参数后的示例：

   http://10.10.10.1:7001/test?action=getTransferNumber&caller=1700000****&serviceNumber=05108348****&timestamp=1691402001&uuid=7e34bb6c-ec99-11e8-b18b-af10dc1a7640&dtmf=123

   说明

   IP地址需为公网IP。

6. 指定号码呼入配置需要选择使用公司以及被叫号码。

7. 选择访问URL失败放音、查分机不存在放音以及呼转放音。

   访问URL失败放音、查分机不存在放音为必填项，其下拉列表仅显示已上传且审核通过的放音文件。如下拉列表为空，请确认已在控制台完成放音文件的上传和审核。

8. 单击开启禁止呼转时段设置，选择禁止呼转时段以及禁止呼转时放音。

9. 如需开启按键查询呼转，请按照参数进行配置。

   配置信息	描述
   首次呼入放音	被叫号码接通后放音
   无按键超时放音	等待按键超时放音
   无按键超时时长	等待用户按键时长
   超时次数后挂机	最大超时次数
   重听按键配置	重新放音文件按键
   输入结束按键配置	输入结束按键

10. 单击确定修改。

如下定义的固定参数语音平台在呼叫过程中会自动添加到URL的请求参数上。

以JSON格式为例，返回示例如下：

• 调用成功：

  {
  "result":"success",
  "msg":"成功",
  "data":{"called":"1390000****",
          "showNumber":"057100005848"}
  }

• 调用失败：

  {"result":"fail","msg":"fail reason","data":{}}