咨询热线:0755-33548988
手机专号通通知接口介绍
1.手机专号通挂机通知接口介绍

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

2.手机专号通回调接口配置

请求地址配置

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

地址配置图

3.手机专号通挂机通知接口

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

回调请求地址

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

回调请求包头

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

回调请求包体

属性 类型 约束 描述 取值
action String 必选 请求类型 Hangup
type int 必选 呼叫类型 20:回拨
21:回呼
appId String 必选 应用ID
subid String 必选 虚拟小号绑定时生成的唯一ID
callId String 必选 呼叫的唯一标示 32位字符串
telA String 必选 主叫号码
telB String 必选 被叫号码
telX String 必选 主被叫绑定的小号
startTimeCaller String 必选 主叫发起时间,主叫接通X的时间 YYYYMMDDHH24MISS 20130212000256
startTimeCallee String 必选 被叫接听时间 YYYYMMDDHH24MISS 20130212000256
endTime String 必选 通话结束时间 YYYYMMDDHH24MISS
duration String 必选 通话时长。回拨时,如被叫接听,通话建立,则为B路接听到结束的时间。如被叫未接听,则为0 单位:秒
userFlag String 必选 本次通话的挂机标识 0:标识A路(主叫),1:标识B路(被叫)
byeType String 必选 通话挂机类型 包含正常挂机以及异常挂机类型。 0:正常挂断, 1:A无法接通, 2:B无法接通, 3:A目标忙, 4:B目标忙, 5:通话达到最大时长, 6:服务器错误, 7:网络错误, 255:其他错误
dateCreated String 必选 请求时间 回调用户的时间
userData String 可选 用户数据 用户自定义数据,最长可支持128字节。如用户在回拨REST请求接口中传入,则回调会将数据原样回调给客户
recordUrl String 可选 录音回调地址 URL格式,未开启录音,则为空,录音下载有延时

参数说明:

(1).action:请求类型
(2).type:呼叫类型
(3).appId:应用ID
(4).subid:AX绑定时生成的唯一ID
(5).callId:呼叫的唯一标示
(6).telA:主叫号码
(7).telB:被叫号码
(8).telX: 主被叫绑定的小号
(9).startTimeCaller:主叫发起时间,主叫接通X的时间
(10).startTimeCallee:被叫接听时间
(11).endTime:通话结束时间
(12).duration:通话时长。回拨时,如被叫接听,通话建立,则为B路接听到结束的时间。如被叫未接听,则为0
(13).userFlag: 本次通话的挂机标识
(14).byeType:通话挂机类型
(15).dateCreated:请求时间
(16).userData:用户回调REST接口中传入的数据
(17).recordUrl:录音回调地址

回调请求示例

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

手机专号通通知接口

回调通知AS接口入

手机专号通挂机通知接口


在线客服

在线语音

点击呼叫

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

电话咨询
0755-33548988

回到顶部