发起呼叫

最近更新时间:2019-05-24 16:46:38

接口描述

发起一路呼叫并启动 ivr 流程。
当智能外呼开启时,会增加两个事件通知:语音识别结果通知,识别超时通知。可以用这些通知进行智能对话的场景设计。

注意:

该识别结果为原始词汇,您可能需要做词汇修正;或者您提供特定的场景词汇,能够帮助增加识别结果的准确率。

请求

请求地址

http://host/ipcc/call/callNotify

说明:

host:申请云呼叫成功后,通过线下分配的域名或 IP 地址进行测试。

请求方式

Post 请求。

请求包体

属性 类型 约束 说明
appId String 必选 应用 ID
caller String 必选 主叫号码 - 显示的号码 - 从腾讯云申请的号码
called String 必选 被叫号码
data String 可选 要进行透传的数据,128个字节
Timeout int 可选 超时未接听则挂断,20 - 60 之间
enableAi int 可选 智能外呼标识,
为1时生效,用户说话时,会打断正在播放的语音,同时,会上报用户说话通知和识别用户说话的内容

响应

响应包体

属性 类型 约束 说明
code String 必选 响应码
000000表示成功
108100解析失败-入参错误
108101应用 ID 不存在
108102消息队列已满
108103呼叫资源不足
108104其他错误
appId String 必选 应用 ID
callId String 必选 呼叫号 ID

实际示例

JSON 请求示例

{
    "appId": "247e35ff320a4142a105024055c367cf", 
    "caller": "75581234567", 
    "called": "18888888888", 
    "timeout": 40, 
    "data": " userdata "
}

JSON 响应示例

{
    "code ": "000000", 
    "appId": "247e35ff320a4142a105024055c367cf", 
    "callId": "88-2018031000182918181271218-108bc381ca0f42d8-out"
}