智能语音交互呼入回调HTTP接口

更新时间:
复制 MD 格式

智能语音交互呼入回调HTTP接口的号码呼入配置及回调接口配置。

业务流程

智能语音交互呼入回调HTTP接口的业务流程,请参见智能语音交互呼入业务流程。

为指定号码添加呼入配置

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

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

  3. 在服务开通页签内开通智能语音交互产品功能,如已开通请进行下一步。

  4. 在呼叫设置页签内单击通用呼入配置 > 添加指定号码呼入配置进入指定号码呼入配置页。

  5. 配置类型请选择智能语音交互呼入,根据页面提示信息选择使用公司、被叫号码和配置说明。

  6. 单击确定添加。

配置回调接口

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

  2. 在左侧导航栏中,选择通用设置 > 回调地址,开启智能语音交互回调地址开关。

  3. 在接收地址输入框中输入回调URL(例如https://push.example.com/contextpath/receive.do)。页面上的响应信息区域展示的是JSON响应格式规范,仅供参考,无需编辑。

    说明

    接收地址用于接收语音实时转文本结果并返回下一步执行动作。

    重要

    保存前,确保接收地址对应的服务端已部署完成,且能返回符合要求的JSON格式响应。响应必须包含result、msg、code、data字段,其中data必须包含call_id、action、action_code、extend。具体格式请参见返回示例章节。

  4. 单击保存。系统会向接收地址发起一次HTTP验证请求,校验返回的数据是否符合指定的JSON格式。如果接收地址无法访问或返回格式不符合要求,保存将失败。

  5. 您也可以单击右侧测试按钮,对配置信息进行测试。

回调接口规范

规范

说明

接口协议

HTTP

方式

POST

字符编码格式

UTF-8

示例与参数

智能语音交互呼入回调HTTP接口的请求示例、返回示例与对应参数,请参见:

说明
  • 首次呼入时,请求参数中的content_type为callin,表示用户拨打指定号码发起呼叫。

  • 后续呼入时,content_type内容取决于消息类型,例如:mute表示静音消息。