文档首页> 隐私保护通话 PrivateNumber> API参考> AX模式> AX模式呼叫事件通知接口
更新时间:2022-05-13 GMT+08:00
分享

AX模式呼叫事件通知接口

接口功能

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

请求方向

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

使用说明

  • 前提条件

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

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

  • 注意事项

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

  • 使用限制

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

接口类型

表1 接口类型说明

请求方法

POST

访问URI

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

通信协议

HTTPS/HTTP

请求参数

AX模式中,A和X号码形成绑定关系,所有与A用户建立的通讯都是通过X号码建立:A呼叫X,呼叫转接给指定的呼叫对象(A主叫场景);其他用户呼叫X,呼叫转接给A(A被叫场景)。

注:以下流程和接口示例以A主叫场景为例,即A呼叫X,呼叫转接给指定的呼叫对象B,B用户接听为例。流程和接口示例仅供参考,请以实际消息为准。

图1 A主叫场景业务流程
表2 请求Headers参数说明

参数名称

是否必选

参数类型

说明

Content-Type

String

固定填写为application/json;charset=UTF-8。

Authorization

String

固定填写为WSSE realm="SDP",profile="UsernameToken",type="Appkey"。

X-WSSE

String

取值为UsernameToken Username="APP_Key的值", PasswordDigest="PasswordDigest的值", Nonce="随机数", Created="随机数生成时间"。
  • PasswordDigest:根据PasswordDigest = Base64 (SHA256 (Nonce + Created + Password))生成。其中,Password为APP_Secret的值。Nonce、Created、Password直接进行字符串拼接即可,无需包含+号和空格。
  • Nonce:客户发送请求时生成的一个随机数,长度为1~128位,可包含数字和大小写字母。例如:66C92B11FF8A425FB8D4CCFE0ED9ED1F。
  • Created:随机数生成时间。采用标准UTC格式,例如:2018-02-12T15:30:20Z。不同编程语言中将UTC时间戳转换为普通时间时使用的格式不同,部分语言可参考表3
表3 不同编程语言的时间格式

编程语言

时间格式

Java

yyyy-MM-dd'T'HH:mm:ss'Z'

PHP

Y-m-d\TH:i:s\Z

Python

%Y-%m-%dT%H:%M:%SZ

C#

yyyy-MM-ddTHH:mm:ssZ

Node.js

toISOString().replace(/.[0-9]+\Z/, 'Z')

注:Node.js中,使用toISOString()转换后的时间格式去除毫秒后即为本接口要求的时间格式。

表4 请求Body参数说明

参数名称

是否必选

参数类型

说明

eventType

String(枚举)

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

取值范围如下:

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

statusInfo

CallStatusInfo

呼叫状态事件的信息。

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

CallStatusInfo定义
表5 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。

注:

  • A主叫场景,呼入事件的主叫号码为A号码。
  • A被叫场景,呼入事件的主叫号码为B号码(B为任意其他用户)。

called

String(1-32)

被叫号码。

注:A主叫/被叫场景,呼入事件的被叫号码为X号码。

subscriptionId

String(1-64)

绑定ID。

userData

String(1-256)

用户附属信息。

说明:

使用该参数的场景请联系华为云客服获取。

接口示例

POST /status HTTP/1.1

content-type: application/json;charset=UTF-8
authorization: WSSE realm="SDP",profile="UsernameToken",type="Appkey"
x-wsse: UsernameToken Username="************",PasswordDigest="*************",Nonce="ac1c911c4792492687f8f6b2264a491e",Created="2018-05-26T00:35:30Z"
Content-Length: xx 

{"eventType":"callin","statusInfo":{"sessionId":"1200_1827_4294967295_20190124023003@callenabler246.huaweicaas.com","timestamp":"2019-01-24 02:30:03","caller":"+86138****0021","called":"+86138****0022","subscriptionId":"****"}}
表6 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。

注:A主叫/被叫场景,呼出事件的主叫号码为X号码。

called

String(1-32)

被叫号码。

注:

  • A主叫场景,呼出事件的被叫号码为B号码。

  • A被叫场景,呼出事件的被叫号码为A号码。

subscriptionId

String(1-64)

绑定ID。

userData

String(1-256)

用户附属信息。

当客户在AX模式绑定接口、AX模式绑定信息修改接口或AX模式设置临时被叫接口中携带了“userData”时,对应此呼叫事件的通知消息中都会携带此参数。

接口示例

POST /status HTTP/1.1

content-type: application/json;charset=UTF-8
authorization: WSSE realm="SDP",profile="UsernameToken",type="Appkey"
x-wsse: UsernameToken Username="************",PasswordDigest="*************",Nonce="ac1c911c4792492687f8f6b2264a491e",Created="2018-05-26T00:35:30Z"
content-length:xx 

{"eventType":"callout","statusInfo":{"sessionId":"1200_1827_4294967295_20190124023003@callenabler246.huaweicaas.com","timestamp":"2019-01-24 02:30:03","caller":"+86138****0022","called":"+86138****7021","subscriptionId":"****"}}
表7 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。

注:A主叫/被叫场景,振铃事件的主叫号码为X号码。

called

String(1-32)

被叫号码。

注:

  • A主叫场景,振铃事件的被叫号码为B号码。

  • A被叫场景,振铃事件的被叫号码为A号码。

subscriptionId

String(1-64)

绑定ID。

userData

String(1-256)

用户附属信息。

当客户在AX模式绑定接口、AX模式绑定信息修改接口或AX模式设置临时被叫接口中携带了“userData”时,对应此呼叫事件的通知消息中都会携带此参数。

接口示例

POST /status HTTP/1.1

content-type: application/json;charset=UTF-8
authorization: WSSE realm="SDP",profile="UsernameToken",type="Appkey"
x-wsse: UsernameToken Username="************",PasswordDigest="*************",Nonce="ac1c911c4792492687f8f6b2264a491e",Created="2018-05-26T00:35:30Z"
content-length:xx

{"eventType":"alerting","statusInfo":{"sessionId":"1200_1827_4294967295_20190124023003@callenabler246.huaweicaas.com","timestamp":"2019-01-24 02:30:04","caller":"+86138****0022","called":"+86138****7021","subscriptionId":"****"}}

表8 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。

注:A主叫/被叫场景,应答事件的主叫号码为X号码。

called

String(1-32)

被叫号码。

注:

  • A主叫场景,应答事件的被叫号码为B号码。

  • A被叫场景,应答事件的被叫号码为A号码。

subscriptionId

String(1-64)

绑定ID。

userData

String(1-256)

用户附属信息。

当客户在AX模式绑定接口、AX模式绑定信息修改接口或AX模式设置临时被叫接口中携带了“userData”时,对应此呼叫事件的通知消息中都会携带此参数。

接口示例

POST /status HTTP/1.1

content-type: application/json;charset=UTF-8
authorization: WSSE realm="SDP",profile="UsernameToken",type="Appkey"
x-wsse: UsernameToken Username="************",PasswordDigest="*************",Nonce="ac1c911c4792492687f8f6b2264a491e",Created="2018-05-26T00:35:30Z"
content-length:xx 

{"eventType":"answer","statusInfo":{"sessionId":"1200_1827_4294967295_20190124023003@callenabler246.huaweicaas.com","timestamp":"2019-01-24 02:30:06","caller":"+86138****0022","called":"+86138****7021","subscriptionId":"****"}}
表9 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)

用户附属信息。

当客户在AX模式绑定接口、AX模式绑定信息修改接口或AX模式设置临时被叫接口中携带了“userData”时,对应此呼叫事件的通知消息中都会携带此参数。

接口示例

POST /status HTTP/1.1

content-type: application/json;charset=UTF-8
authorization: WSSE realm="SDP",profile="UsernameToken",type="Appkey"
x-wsse: UsernameToken Username="************",PasswordDigest="*************",Nonce="ac1c911c4792492687f8f6b2264a491e",Created="2018-05-26T00:35:30Z"
content-length:xx

{"eventType":"disconnect","statusInfo":{"sessionId":"1200_1827_4294967295_20190124023003@callenabler246.huaweicaas.com","timestamp":"2019-01-24 02:30:22","caller":"+86138****0022","called":"+86138****7021","stateCode":0,"stateDesc":"The user releases the call.","subscriptionId":"****"}}

响应参数

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

接口示例

HTTP/1.1 200 OK 
分享:

    相关文档

    相关产品

close