文档

首次呼入回调

更新时间:

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

请求示例

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_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

基于用户持续说话时长打断,单位:毫秒。

说明

如果当前媒体文件action_code_breaktrue,用户持续说话可以打断当前播放。不设置或者为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变量播放速度。

  • 本页导读 (1)