文档首页 > > API参考> AXYB模式>

AXYB模式呼叫事件通知接口

AXYB模式呼叫事件通知接口

分享
更新时间:2021/05/17 GMT+08:00

接口功能

隐私保护通话平台通过此接口向客户推送隐私保护通话用户呼叫时的状态信息,如呼入、呼出、振铃、应答、挂机等状态的信息。

请求方向

隐私保护通话平台(服务端) → 客户服务器(客户端)

使用说明

  • 前提条件

    客户添加应用时需设置呼叫状态接收地址,并确保提供的地址能够正常处理隐私保护通话平台发送的通知消息。

    如果需要单独接收呼入事件(callin),需联系客服,提供呼入事件状态接收地址。

  • 注意事项

    若平台给客户推送呼叫事件通知后未收到成功响应,视为推送失败,平台会重新推送呼叫事件通知,直至客户返回成功响应。平台最多重推6次,分别于1分钟、4分钟、9分钟、106分钟、203分钟和300分钟后重推。

  • 使用限制

    业务平台推送呼叫状态给开发者应用,仅支持POST方式。

接口类型

表1 接口类型说明

请求方法

POST

访问URI

客户添加应用时填写的呼叫状态接收地址

通信协议

HTTPS/HTTP

请求参数

AXYB模式中,A和B通过X和Y号码形成绑定关系,使用隐私号码X和Y互相通讯(A拨打Y,接通B;B拨打X,接通A)。

注:以下流程和接口示例以B拨打X,呼叫通过Y转接至A,A用户接听为例,流程和接口示例仅供参考,请以实际消息为准。

图1 AXYB业务流程
表2 请求Body参数说明

参数名称

是否必选

参数类型

说明

eventType

String(枚举)

该参数标识通知的事件类型。

取值范围如下:

  • callin:呼入事件
  • callout:呼出事件
  • alerting:振铃事件
  • answer:应答事件
  • disconnect:挂机事件

statusInfo

CallStatusInfo

呼叫状态事件的信息。

当eventType参数为callin、callout、alerting、answer、disconnect时携带。

CallStatusInfo定义
表3 callin:呼入事件

参数名称

是否必选

参数类型

说明

timestamp

String(1-128)

该呼叫事件发生时隐私保护通话平台的UNIX时间戳。

该参数取值为UTC时间(+8小时为北京时间)格式,即为“yyyy-MM-dd HH:mm:ss”。

sessionId

String(1-256)

唯一指定一条通话链路的标识ID。

caller

String(1-32)

主叫号码。

号码为全局号码格式(包含国家码),如+86138****0021。

注:呼入事件的主叫号码为B号码。

called

String(1-32)

被叫号码。

注:呼入事件的被叫号码为X号码。

subscriptionId

String(1-64)

绑定ID。

接口示例

POST /status HTTP/1.1




content-length:xx
 

{"eventType":"callin","statusInfo":{"sessionId":"1200_1029_4294967295_20190123091514@callenabler246.huaweicaas.com","timestamp":"2019-01-23 09:15:14","caller":"+86138****0021","called":"+86138****0022","subscriptionId":"****"}}
表4 callout:呼出事件

参数名称

是否必选

参数类型

说明

timestamp

String(1-128)

该呼叫事件发生时隐私保护通话平台的UNIX时间戳。

该参数取值为UTC时间(+8小时为北京时间)格式,即为“yyyy-MM-dd HH:mm:ss”。

sessionId

String(1-256)

唯一指定一条通话链路的标识ID。

caller

String(1-32)

主叫号码。

号码为全局号码格式(包含国家码),如+86138****0021。

注:呼出事件的主叫号码为Y号码。

called

String(1-32)

被叫号码。

注:呼出事件的被叫号码为A号码。

subscriptionId

String(1-64)

绑定ID。

userData

String(1-256)

用户自定义数据。

若客户在调用AXYB模式绑定接口时携带了"userData",对应此呼叫事件的通知消息中都会携带此参数。

接口示例

POST /status HTTP/1.1




content-length:xx
 

{"eventType":"callout","statusInfo":{"sessionId":"1200_1029_4294967295_20190123091514@callenabler246.huaweicaas.com","timestamp":"2019-01-23 09:15:15","caller":"+86138****0021","called":"+86138****7021","subscriptionId":"****"}}
表5 alerting:振铃事件

参数名称

是否必选

参数类型

说明

timestamp

String(1-128)

该呼叫事件发生时隐私保护通话平台的UNIX时间戳。

该参数取值为UTC时间(+8小时为北京时间)格式,即为“yyyy-MM-dd HH:mm:ss”。

sessionId

String(1-256)

唯一指定一条通话链路的标识ID。

caller

String(1-32)

主叫号码。

号码为全局号码格式(包含国家码),如+86138****0021。

注:振铃事件的主叫号码为Y号码。

called

String(1-32)

被叫号码。

注:振铃事件的被叫号码为A号码。

subscriptionId

String(1-64)

绑定ID。

userData

String(1-256)

用户自定义数据。

若客户在调用AXYB模式绑定接口时携带了"userData",对应此呼叫事件的通知消息中都会携带此参数。

接口示例

POST /status HTTP/1.1




content-length:xx
 

{"eventType":"alerting","statusInfo":{"sessionId":"1200_1029_4294967295_20190123091514@callenabler246.huaweicaas.com","timestamp":"2019-01-23 09:15:16","caller":"+86138****0021","called":"+86138****7021","subscriptionId":"****"}}

表6 answer:应答事件

参数名称

是否必选

参数类型

说明

timestamp

String(1-128)

该呼叫事件发生时隐私保护通话平台的UNIX时间戳。

该参数取值为UTC时间(+8小时为北京时间)格式,即为“yyyy-MM-dd HH:mm:ss”。

sessionId

String(1-256)

唯一指定一条通话链路的标识ID。

caller

String(1-32)

主叫号码。

号码为全局号码格式(包含国家码),如+86138****0021。

注:应答事件的主叫号码为Y号码。

called

String(1-32)

被叫号码。

注:应答事件的被叫号码为A号码。

subscriptionId

String(1-64)

绑定ID。

userData

String(1-256)

用户自定义数据。

若客户在调用AXYB模式绑定接口时携带了"userData",对应此呼叫事件的通知消息中都会携带此参数。

接口示例

POST /status HTTP/1.1




content-length:xx
 

{"eventType":"answer","statusInfo":{"sessionId":"1200_1029_4294967295_20190123091514@callenabler246.huaweicaas.com","timestamp":"2019-01-23 09:15:36","caller":"+86138****0021","called":"+86138****7021","subscriptionId":"****"}}
表7 disconnect:挂机事件

参数名称

是否必选

参数类型

说明

timestamp

String(1-128)

该呼叫事件发生时隐私保护通话平台的UNIX时间戳。

该参数取值为UTC时间(+8小时为北京时间)格式,即为“yyyy-MM-dd HH:mm:ss”。

sessionId

String(1-256)

唯一指定一条通话链路的标识ID。

caller

String(1-32)

主叫号码。

号码为全局号码格式(包含国家码),如+86138****0021。

注:此处返回号码非真实主被叫号码,真实主被叫号码请以fee事件中的返回值为准。

called

String(1-32)

被叫号码。

注:此处返回号码非真实主被叫号码,真实主被叫号码请以fee事件中的返回值为准。

stateCode

Integer

通话挂机的原因值,仅当eventType为disconnect时携带。

取值范围及表示的含义请参考通话挂机原因值说明

stateDesc

String(1-128)

通话挂机的原因值的描述,仅当eventType为disconnect时携带。

subscriptionId

String(1-64)

绑定ID。

userData

String(1-256)

用户自定义数据。

若客户在调用AXYB模式绑定接口时携带了"userData",对应此呼叫事件的通知消息中都会携带此参数。

接口示例

POST /status HTTP/1.1




content-length:xx
 

{"eventType":"disconnect","statusInfo":{"sessionId":"1200_1029_4294967295_20190123091514@callenabler246.huaweicaas.com","timestamp":"2019-01-23 09:16:41","caller":"+86138****0021","called":"+86138****7021","stateCode":0,"stateDesc":"The user releases the call.","subscriptionId":"****"}}

响应参数

客户服务器接收到隐私保护通话平台的呼叫事件通知后,返回的响应消息。

接口示例

HTTP/1.1 200 OK 
分享:

    相关文档

    相关产品