咨询热线:0755-33548988
云双呼回调接口
1.云双呼回调接口介绍

玖云平台针对云双呼回拨接口提供了回调通知接口,云双呼发起呼叫请求后会回到用户服务器,将通话的状态信息返回给用户。

2.回调通知AS接口接入及使用流程

请求地址配置

请求地址为开发者服务器地址,具体配置方式如下:

地址配置图

3.云双呼呼叫挂机通知接口

此接口用于呼叫断开的时候,平台通知用户应用服务器。包括正常断开以及异常断开情况。

回调请求地址

用户自行配置URL地址。通过POST方式请求通知用户,只提供XML格式。

回调请求包头

属性 类型 约束 说明
Content-Type String 必选 类型application/xml
Content-Length String 必选 消息体的长度

回调请求包体

属性 类型 约束 描述 取值
action String 必选 请求类型 Hangup
type int 必选 呼叫类型 22:小号业务
appId String 必选 应用ID
telA String 必选 主叫号码
telB String 必选 被叫号码
telX String 必选 主被叫绑定的小号
startTimeCaller String 必选 主叫发起时间,主叫接通X的时间 YYYYMMDDHH24MISS 20130212000256
startTimeCallee String 必选 被叫接听时间 YYYYMMDDHH24MISS 20130212000256
endTime String 必选 通话结束时间 YYYYMMDDHH24MISS
duration String 必选 通话时长。回拨时,如被叫接听,通话建立,则为B路接听到结束的时间。如被叫未接听,则为0 单位:秒
callFrom String 必选 本次通话类型 2云双呼
callId String 必选 呼叫的唯一标示 32位字符串
recordUrl String 可选 录音回调地址 URL格式,未开启录音,则为空,录音下载有延时
byeType String 必选 通话挂机类型 挂机原因
dateCreated String 必选 请求时间 回调用户的时间
userData String 必选 用户数据 用户自定义数据,最长可支持32字节。如用户在回拨REST请求接口中传入,则回调会将数据原样回调给客户

回调请求示例

XML请求示例
      POST
      <?xml version='1.0'?>
      <req>
          <action>Hangup</action>
          <type>12</type>
          <appId>7290fa01293c483fb2709c690f213272</appId> 
          <callId>9f1ffdf1273511e7a80d000c29779dd9</callId>
          <telA>18612345678</telA>
          <telB>0</telB>
          <telX>18612345678</telX>
          <startTimeCaller>20170911145109</startTimeCaller>
          <startTimeCallee>20170911145113</startTimeCallee>
          <endTime>20170422163810</endTime>
          <duration>7</duration>
          <callFrom>2</callFrom> 
          <byeType>16</byeType>
          <recordUrl>http://xxx.xx/download/record1</recordUrl>
          <dateCreated>20161106190844</dateCreated>
          <userData>AA,BB,CC</userData>
      </req>
                            

用户AS响应包头

属性 类型 约束 说明 举例
Status-Code String 必选 应答状态码,全部为200 HTTP/1.1 200 OK
Date String 可选 服务器时间 Wed Nov 9 16:08:57 2011
Content-Length String 必选 消息体的长度 140

用户AS响应包体

属性 类型 约束 描述 取值
statusCode String 必选 响应结果 用户返回错误码 0000表示成功,目前平台不对此字段进行解析
statusMsg String 可选 响应结果描述 用户自定义描述,目前平台不对此字段进行解析

用户AS响应示例

XML响应示例
      POST
      <?xml version='1.0' encoding='utf-8'?>
      <Response>
          <statusCode>0000</statusCode>
          <statusMsg>Success</statusMsg>
      </Response>
                            

在线客服

在线语音

点击呼叫

音频设备正常
点击"呼叫"立即接通客服
麦克风设备未准备好
请检查设备后再点击"呼叫"
音频设备未准备好
请检查设备后再点击"呼叫"
呼叫中……
请耐心等待
00:00
通话中
通话已结束
时长: 00:00
通话未接通
非常抱歉!客服未能接通。请再次呼叫或在官网下方留下您的联系方式,我们将尽快与您沟通。

电话咨询
0755-33548988

回到顶部