概述

ctc接口用于点击呼叫场景。

应用调用click2call接口成功后，语音服务平台使用先后拨打主被叫用户的号码，接通后桥接双方进行通话。

/{SoftVersion}/Accounts/{accountSid}/Applications/{applicationSid}/ctc/Conversations[/{conversationSid}]

API

click2call

请求URL

/{SoftVersion}/Accounts/{accountSid}/Applications/{applicationSid}/ctc/Conversations

请求参数

属性	约束	说明
action	必选	请求指令：click2call
caller	必选	主叫用户的号码（发起呼叫的用户）
callee	必选	被叫用户的号码
callerCli	可选	指定呼叫主叫用户的线路号码
calleeCli	可选	指定呼叫被叫用户的线路号码
greetVoice	可选	接到呼入，呼叫被叫前，向主叫播放的提示音。
ringbackMode	可选	回铃音模式。                0：透传模式（默认）：透传被叫侧的回铃音及呼叫失败提示音                1:定制模式：平台播放回铃音及呼叫失败提示音。
ringbackVoice	可选	定制回铃音（ringback_mode=1时有效）
failVoice	可选	定制呼叫失败音（ringback_mode=1时有效）
calleeVoice	可选	给被叫播放的提示音（接通后），缺省不播放                给被叫播放提示音时主叫如何处理？一起听？
callerVoice	可选	给主叫播放的提示音（接通后），缺省不播放                给被叫播放提示音时主叫如何处理？一起听？
userData	可选	支持英文字母和数字，长度最大支持256字节。
statusUrl	可选	接收状态上报的URL。                状态包括呼出、振铃、摘机和挂机等
cdrUrl	可选	实时话单通知接口回调地址
record	可选	0不录音；1被叫振铃时开始录音；2被叫接听开始录音；默认值0。
maxDuration	可选	通话的最大时长,单位为秒。默认值空，不限制通话时长
lastMinVoice	可选	最后一分钟提示音。默认放音内容“本次通话时长还剩1分钟”。

响应参数

名称	示例值	描述
conversationSid	CA2016010000000219	呼叫唯一标识（发起呼叫后返回）
statusCode	00000	发送结果错误码
statusMsg	success	发送结果状态描述

取消呼叫

请求URL

/{SoftVersion}/Accounts/{accountSid}/Applications/{applicationSid}/ctc/Conversations/{conversationSid}

请求参数说明

参数	约束	说明
action	必选	请求指令：cancelCall

名称	示例值	描述
statusCode	00000	发送结果错误码
statusMsg	success	发送结果状态描述

三方呼叫

请求URL

/{SoftVersion}/Accounts/{accountSid}/Applications/{applicationSid}/ctc/Conversations/{conversationSid}

请求参数说明

参数	约束	说明
action	必选	请求指令：addCall
callee	必选	被叫用户的号码
calleeCli	可选	指定呼叫被叫用户的线路号码
greetVoice	可选	呼叫被叫前，向主叫播放的提示音。
ringbackMode	可选	回铃音模式。                0：透传模式（默认）：透传被叫侧的回铃音及呼叫失败提示音                1:定制模式：平台播放回铃音及呼叫失败提示音。
ringbackVoice	可选	定制回铃音（ringback_mode=1时有效）
failVoice	可选	定制呼叫失败音（ringback_mode=1时有效）
calleeVoice	可选	给被叫播放的提示音（接通后），缺省不播放                给被叫播放提示音时主叫如何处理？一起听？
callerVoice	可选	给主叫播放的提示音（接通后），缺省不播放                给被叫播放提示音时主叫如何处理？一起听？
record	O	是否录音，默认false不录音
timeout	O	被叫接听超时时长。默认 120秒

click2call请求指示的被叫挂机时，通话结束；其它呼叫方挂机时，不影响剩余两方通话          当通话变为两方呼叫时，允许再次调用addCall

响应参数

名称	示例值	描述
statusCode	00000	发送结果错误码
statusMsg	success	发送结果状态描述

呼叫状态

参数	说明
conversationSid	会话标识ID
callSid	呼叫标识ID
apiVersion	API版本信息
accountSid	账号ID
appSid	应用ID
from	主叫号码
to	被叫号码
direction	呼叫方向 outbound：外呼
callStatus	呼叫状态                initiated：开始呼叫                ringing：呼叫振铃                answered：呼叫应答                completed：呼叫结束
timestamp	时间戳 YYYYMMDDHHmmss
callCause	挂机原因                failed：失败                no-answer：无应答                time-out：外呼超时                completed：正常结束
userData	用户自定义数据

呼叫话单

参数	说明
conversationSid	会话标识ID
accountSid	账号ID
appSid	应用ID
recordingUrl	录音下载Url
recordingDuration	录音时长
userData	用户自定义数据
byeType	挂机类型                0：主叫未应答                1：呼被叫时主叫挂机                2：被叫未应答                3：主叫挂机                4：被叫挂机                5：通话时长达到上限结束
cdrs	呼叫话单CDR集

CDR

参数	说明
callSeq	呼叫序列号, 从0开始递增
callSid	呼叫标识ID
from	主叫号码
to	被叫号码
startTime	开始时间
ringTime	振铃时间
answerTime	应答时间
stopTime	结束时间
duration	通话时长
cause	挂机原因

示例

{

         "accountSid": "400a8e279a5b7f0f33c1d8b58bcfe3dd",

         "appSid": "aebd5b2621c64582a69474382d253530",

         "conversationSid": "CV50001201908141226560665400000001",

         "recordingUrl": "http://test.com/record/100001/20190814/RE1000200000184_D_2_20190814122702.wav",

         "recordingDuration": "14",

         "userData": "13800138001_2_13800138000",

         "byeType": "4",

         "cdrs": [{

                 "callSeq": "1",

                 "callSid": "CA10002201908141227025945100000184",

                 "from": "01062236000",

                 "to": "13800138000",

                 "startTime": "20190814122700",

                 "ringTime": "20190814122700",

                 "answerTime": "20190814122702",

                 "stopTime": "20190814122716",

                 "duration": "14",

                 "cause": "completed"

         }, {

                 "callSeq": "0",

                 "callSid": "CA10002201908141226569209000000183",

                 "from": "01062236000",

                 "to": "13800138001",

                 "startTime": "20190814122654",

                 "ringTime": "20190814122655",

                 "answerTime": "20190814122656",

                 "stopTime": "20190814122716",

                 "duration": "20",

                 "cause": "completed"

         }]

}

流程示意

主叫侧平台被叫侧click2callsetupanswergreet_voicesetupringringback toneringback_voiceringback tonealt[ 定制回铃音 ][ 透传回铃音 ]answer2wayCall主叫侧平台被叫侧