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

请求示例

http://http://127.0.0.1/test?call_id=100001616500^10000187****&timestamp=1504174341229&content_type=callin&content={"caller": "1371111****"," callee": "0571111****"," orgcallee": "05712222****" }/test?call_id=100001616500^10000187****&timestamp=1504174341229&content_type=normal&content={"role": "B","identity": "id2","words": "你好","begin_offset": "1000","end_offset": "9000","begin_time": "2017-06-01 10:00:00"}

请求参数

参数名称 参数类型 必填与否 示例 说明
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": "成功","data": {"call_id": "100001616500^10000187****","action": "answer","action_code": "411111","session_timeout": 180,"asr_model_id": 11323223q23****,"asr_base_id": "customer_service_8k","record_flag": true,"mute_time": 5000,"pause_time": 100,"action_code_break": true,"action_break": true,"action_code_param": "","action_code_time_break": 120,"tts_conf": true,"tts_style": "xiaoyun","tts_volume": 100,"tts_speed": 0,"dynamic_id": "xxxx"}}","data": {"call_id": "100001616500^10000187****","action": "play","action_code": "411111","extend": "xxxx"}}
  • 调用失败:
    {"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_breaktrue,也无法打断当前放音。
说明 action_breakaction_code_breakaction_code_break优先级更高。
action_break Boolean true 是否打断上一个动作。取值:
  • true(默认值):打断。
  • false:不打断。
说明 如果上一个动作的action_code_breakfalse,则无法打断。
action_code_param String {"name":"喂,你好"} 放音参数。
action_code_time_break Integer 120 基于用户持续说话时长打断,单位为毫秒。
说明 如果当前媒体文件actionCodeBreaktrue,用户持续说话可以打断当前播放。不设置或者为0,不生效。
dynamic_id String abcde**** 扩展字段。
tts_conf Boolean true TTS声音设置参数。取值为true时,需要设置tts_styletts_volumetts_speed三个参数来设置TTS变量播放时的声音风格。
tts_style String xiaoyun TTS变量播放时的声音风格。
tts_volume Integer 100 TTS变量播放时音量。
tts_speed Integer 0 TTS变量播放速度。