首次呼入回调的示例和说明_语音服务(VS)-阿里云帮助中心

阿里云接收到用户呼叫后首次请求与返回参数如下。

请求示例

http://127.0.0.1/test?call_id=100001616500^10000187****&timestamp=1504174341229&content_type=callin&content={"caller": "1371111****"," callee": "0571111****"," orgcallee": "05712222****" }

请求参数

参数名称	参数类型	是否必填	示例	说明
call_id	String	是	100001616500^10000187****	呼叫的唯一ID。
content_type	String	是	callin	智能语音交互的类型，callin表示用户拨打指定号码发起呼叫。
content	JSON	是	{"caller": "1371111**","callee": "0571111","orgcallee": "05712222**"}	具体的语音内容，JSON格式。 caller：呼入场景主叫号码。 callee：呼入场景被拨打的服务号码。 orgcallee：呼入场景下原始被叫号码。假设C为服务号码，用户B设置呼叫转移至号码C，用户A拨打号码B转接至C时，则caller为A、callee为C、orgcallee为B。

返回示例

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

调用成功：

{
"result":"success",
"msg":"成功",
"code":200,
"data":{"dynamic_id":"v1_0_start",
        "action_code":"$tts$",
        "action":"answer",
        "record_flag":true,
        "action_code_param":"{\"tts\":\"你好，我是面试官钟六六。我们现在开始面试。我问你几个问题。\"}",
        "call_id":"130420284****117198409016"}
}

调用失败：

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

返回参数

名称	格式	是否必填	示例	说明
call_id	String	是	100001616500^10000187****	这通呼叫的唯一ID。
action	String	是	answer	下一步的动作。 answer：开场白应答。 hangup：挂机。
session_timeout	Integer	否	120	最大通话时长。单位：秒，超时后自动挂断。
asr_model_id	String	否	11323223q23****	定制模型ID，未指定时使用基础模型。
asr_base_id	String	否	customer_service_8k	基础模型。
record_flag	Boolean	否	true	是否开启录音。
mute_time	Integer	否	5000	静音时长，单位：毫秒。说明通话过程中可以动态设置，以最后一次设置为准。
pause_time	Integer	否	500	断句时长，单位：毫秒。说明首次设置有效，后续设置无效。
action_code	String	否	xxx.wav	放音文件。
action_code_break	Boolean	否	true	当前返回的媒体文件是否可以被打断。取值： true（默认值）：可被打断。 false：即使下一个动作action_break为true，也无法打断当前放音。说明 action_break和action_code_break，action_code_break优先级更高。
action_break	Boolean	否	true	是否打断上一个动作。取值： true（默认值）：打断。 false：不打断。说明如果上一个动作的action_code_break为false，则无法打断。
action_code_param	String	否	{"name":"喂，你好"}	放音参数。
action_code_time_break	Integer	否	120	基于用户持续说话时长打断，单位：毫秒。说明如果当前媒体文件action_code_break为true，用户持续说话可以打断当前播放。不设置或者为0，不生效。
dynamic_id	String	否	abcde****	扩展字段。
tts_conf	Boolean	否	true	TTS声音设置参数。取值为true时，需要设置tts_style、tts_volume、tts_speed三个参数来设置TTS变量播放时的声音风格。
tts_style	String	否	xiaoyun	TTS变量播放时的声音风格。
tts_volume	Integer	否	100	TTS变量播放时音量。
tts_speed	Integer	否	0	TTS变量播放速度。