注册 登录

侧边栏

文档首页

常见问题

SDK下载

返回码

短信API

使用指南

审核规范

用户工具

您在这里: 接入建议 » 业务通知回调接口
业务通知回调接口

这是本文档旧的修订版！

目录

业务通知回调接口

目前业务通知回调包过三个业务：

  • 漫游呼转离线来电Push续活通知，当用户APP离线时，发送消息激活APP，使其能够正常接听电话。
  • 漫游呼转未接来电通知
  • 漫游关闭通知

1.1 平台请求

• 请求地址
需要第三方自行配置URL地址。
• 请求包体

1.漫游呼转离线来电Push续活通知

属性 类型 约束 说明
event String 必选 值为：roam pushcall
callid String 必选 呼叫的唯一标识（沿用原来机制，由sdk组件生成）
dsid Int 必选 会话处理服务器标识id
callertype Int 必选 主叫号码类型，0：Client账号，1：普通电话
caller String 必选 主叫号码
普通电话：18512345678
Client号码：60000000000018
calledtype Int 必选 被叫号码类型，0：Client账号，1：普通电话
called String 必选 被叫号码
普通电话：18612345678
Client号码：60000000000017

2.漫游呼转未接来电通知

属性 类型 约束 说明
event String 必选 值为：roam misscall
callid String 必选 呼叫的唯一标识（沿用原来机制，由sdk组件生成）
callertype Int 必选 主叫号码类型，0：Client账号，1：普通电话
caller String 必选 主叫号码
普通电话：18512345678
Client号码：60000000000018
calledtype Int 必选 被叫号码类型，0：Client账号，1：普通电话
called String 必选 被叫号码
普通电话：18612345678
Client号码：60000000000017

3、漫游关闭通知

属性 类型 约束 说明
event String 必选 值为：closeRoam
accountid String 必选 开发者账号id
appid String 必选 应用id
clientnumberString 必选 clientNumber号码
closetime String 必选 关闭时间，时间格式如：2014-06-16 16:47:28
reason Int 必选 关闭原因，0：到达失效期，1：余额不足

• XML请求示例 

POST /coolweb/notify HTTP/1.1
Host: 172.16.10.32:8080
Content-Type:text/xml;charset=utf-8
Accept:application/xml
Content-Length: 515
 
1.漫游呼转离线来电Push续活通知
<?xml version="1.0"?>
<request>
  <event>roam pushcall</event>
  <callid>Y2IyZmRmMjc0NWI2NTFjN2YyNDkwZDM3Mzk0NWViZTE.</callid>
  <dsid>54</dsid>
  <callertype>1</callertype>
  <caller>15994729927</caller>
  <calledtype>0</calledtype>
  <called>60000000000008</called>
</request>
 
2.漫游呼转未接来电通知
<?xml version="1.0"?>
<request>
  <event>roam misscall</event>
  <callid>Y2IyZmRmMjc0NWI2NTFjN2YyNDkwZDM3Mzk0NWViZTE.</callid>
  <callertype>1</callertype>
  <caller>15994729927</caller>
  <calledtype>1</calledtype>
  <called>13554876722</called>
</request>
 
3.漫游关闭通知
<?xml version="1.0"?>
<request>
	<event>closeRoam</event>
	<accountid>e7e87018c960d01da9aab0f71f79d589</accountid>
	<appid>78d3db19c0694c95ac4720de70004921</appid>
	<clientnumber>65900000690095</clientnumber>
	<closetime>2015-03-18 21:00:00</closetime>
	<reason>1</reason>
</request>

1.2 第三方AS响应

• 响应包体

属性 类型 约束 说明
retcode Int 必选 返回错误码，0：成功，非0：失败
reason String 可选 原因描述

• XML响应示例 

<?xml version="1.0" encoding="UTF-8"?>
<response>
    <retcode>0</retcode>
    <reason>100013</reason>
</response>

页面工具