接口功能

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

请求方向

隐私保护通话平台（服务端） → 客户服务器（客户端）

使用说明

• 前提条件

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

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

• 注意事项

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

• 使用限制

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

接口类型

A被叫场景请求参数

A被叫场景是指和隐私号码X绑定的号码A作为通话方中的被叫的场景，即A以外的用户呼叫X后根据语音提示输入E，呼叫转接至A的场景。

注：以下流程和接口示例以A用户接听为例（B为A以外的其他用户），流程和接口示例仅供参考，请以实际消息为准。

图1 A被叫场景业务流程

接口示例

POST /status HTTP/1.1




content-length:xx
 

{"eventType":"callin","statusInfo":{"sessionId":"1201_11275_4294967295_20190124033310@callenabler246.huaweicaas.com","timestamp":"2019-01-24 03:33:10","caller":"+8613866887021","called":"+8613800000022"}}

接口示例

POST /status HTTP/1.1




content-length:xx

{"eventType":"collectInfo","statusInfo":{"sessionId":"1201_11275_4294967295_20190124033310@callenabler246.huaweicaas.com","timestamp":"2019-01-24 03:33:16","digitInfo":"02"}}

接口示例

POST /status HTTP/1.1




content-length:xx
 

{"eventType":"callout","statusInfo":{"sessionId":"1201_11275_4294967295_20190124033310@callenabler246.huaweicaas.com","timestamp":"2019-01-24 03:33:16","caller":"+8613800000022","called":"+8613800000021","subscriptionId":"8e6a3881-ee87-4b0a-a07e-d491135025f8"}}

接口示例

POST /status HTTP/1.1




content-length:xx
 

{"eventType":"alerting","statusInfo":{"sessionId":"1201_11275_4294967295_20190124033310@callenabler246.huaweicaas.com","timestamp":"2019-01-24 03:33:16","caller":"+8613800000022","called":"+8613800000021","subscriptionId":"8e6a3881-ee87-4b0a-a07e-d491135025f8"}}

接口示例

POST /status HTTP/1.1




content-length:xx
 

{"eventType":"answer","statusInfo":{"sessionId":"1201_11275_4294967295_20190124033310@callenabler246.huaweicaas.com","timestamp":"2019-01-24 03:33:28","caller":"+8613800000022","called":"+8613800000021","subscriptionId":"8e6a3881-ee87-4b0a-a07e-d491135025f8"}}

接口示例

POST /status HTTP/1.1




content-length:xx

{"eventType":"disconnect","statusInfo":{"sessionId":"1201_11275_4294967295_20190124033310@callenabler246.huaweicaas.com","timestamp":"2019-01-24 03:33:57","caller":"+8613800000022","called":"+8613800000021","stateCode":0,"stateDesc":"The user releases the call.","subscriptionId":"8e6a3881-ee87-4b0a-a07e-d491135025f8"}

A回呼场景请求参数

A回呼场景是指和隐私号码X绑定的号码A作为通话方中的主叫的场景，即A用户呼叫X，呼叫转接至最近一次通过X呼叫A的用户（如B）。若找不到对应回呼记录，则隐私保护通话平台根据绑定时的设置给A放指定音（callbackTone）后结束呼叫，或将呼叫转接至指定号码（callbackNum）。

注：以下流程以B用户接听为例，流程和接口示例仅供参考，请以实际消息为准。B号码是通过X号码呼叫过A的号码（存在回呼记录）或企业设置的指定转接号码（不存在回呼记录）。

图2 A回呼场景业务流程

接口示例

POST /status HTTP/1.1




content-length:xx
 

{"eventType":"callin","statusInfo":{"sessionId":"1202_1051_4294967295_20190124070250@callenabler246.huaweicaas.com","timestamp":"2019-01-24 07:02:50","caller":"+8613800000021","called":"+8613800000022"}}

接口示例

POST /status HTTP/1.1




content-length:xx
 

{"eventType":"callout","statusInfo":{"sessionId":"1202_1051_4294967295_20190124070250@callenabler246.huaweicaas.com","timestamp":"2019-01-24 07:02:50","caller":"+8613800000022","called":"+8613866887021","subscriptionId":"8e6a3881-ee87-4b0a-a07e-d491135025f8"}}

接口示例

POST /status HTTP/1.1




content-length:xx
 

{"eventType":"alerting","statusInfo":{"sessionId":"1202_1051_4294967295_20190124070250@callenabler246.huaweicaas.com","timestamp":"2019-01-24 07:02:53","caller":"+8613800000022","called":"+8613866887021","subscriptionId":"8e6a3881-ee87-4b0a-a07e-d491135025f8"}}

接口示例

POST /status HTTP/1.1




content-length:xx
 

{"eventType":"answer","statusInfo":{"sessionId":"1202_1051_4294967295_20190124070250@callenabler246.huaweicaas.com","timestamp":"2019-01-24 07:03:03","caller":"+8613800000022","called":"+8613866887021","subscriptionId":"8e6a3881-ee87-4b0a-a07e-d491135025f8"}}

接口示例

POST /status HTTP/1.1




content-length:xx
 

{"eventType":"disconnect","statusInfo":{"sessionId":"1202_1051_4294967295_20190124070250@callenabler246.huaweicaas.com","timestamp":"2019-01-24 07:03:28","caller":"+8613800000022","called":"+8613866887021","stateCode":0,"stateDesc":"The user releases the call.","subscriptionId":"8e6a3881-ee87-4b0a-a07e-d491135025f8"}}

响应参数

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

接口示例

HTTP/1.1 200 OK