阿里云语音服务呼入动态IVR，呼转回调http接口规范

网友投稿 • 2023年2月2日 am10:17 • 全球云 • 阅读 0

呼入动态IVR，呼转回调http接口

1 场景描述

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

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

此时，云通信平台，根据用户呼入的主叫号码，被叫号码以及按键信息，通过url回调查询后，获取需要转接的号码，呼转到指定的坐席或服务人员的电话上。

2 接口概述

a) 此URL主要用于呼入业务设置为动态IVR时，根据呼入的主叫号码、被叫号码以及按键信息通过设置的url回调获取呼转的号码以及外呼显示号码。

b) 此配置可分为两个维度：指定号码设置以及全局默认设置，优先会通过获取指定号码设置的URL，若号码未指定设置则会通过默认设置。

c) 回调触发点：当按键查询呼转开关，关闭时，接收到呼入请求直接回调。当按键查询呼转开关，打开时，播放IVR提示音后，等待用户按键结束后进行回调。

3 交互协议

接口协议：http

提交方式：Get

调用超时时间：3秒

字符编码：UTF-8

请求参数定义：

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

序号	参数名称	是否必填	备注
1	caller	必须	呼入主叫号码
2	serviceNumber	必须	呼入被叫号码
3	timestamp	必须	当前时间戳
4	uuid	必须	呼叫唯一标识
5	dtmf	可选	用户按键信息

响应参数定义：

返回格式：JSON

成功样式：

{“result”: “success”,”msg”: “成功”,“data”: {“called”: “13000000000”,”showNumber”: “057100000000”}}

失败样式：

{“result”:”fail”,”msg”:”fail reason”, “data”:{}}

参数说明

序号	参数名称	是否必填	备注
1	called	必须	将要呼转的被叫号码
2	showNumber	可选	呼转显示号码。如果为空，默认会通过呼入的服务号码进行外呼。

4 具体例子

1调用样例

url如果在语音服务控制台设置的地址为:

http://11.162.156.43:7001/test?action=getTransferNumber

用户实际呼入时，输入按键后语音平台请求客户的实际url为：

http://11.162.156.43:7001/test?action=getTransferNumber&caller=137012345678&serviceNumber=051083484093&uuid=7e34bb6c-ec99-11e8-b18b-af10dc1a7640&dtmf=123

2 返回结果

{ “result”: “success”, “data”: { “called”: “13000000000”, “showNumber”: “051083484093” }}

原创文章，作者：网友投稿，如若转载，请注明出处：https://www.cloudads.cn/archives/33348.html