您可以通过HTTP批量推送方式订阅中间状态摘机(被叫接通)事件消息(SecretPickUpReport),获取呼叫过程中的摘机信息。
注意事项
仅部分运营商平台号码支持订阅SecretPickUpReport。
协议说明
参数 | 说明 |
协议 | HTTP + JSON |
编码 | UTF-8 |
请求说明
请求内容为JSON Array格式,单次请求可能会包含多个通话记录。
请求样例
[{
"phone_no": "1314456****",
"secret_no": "1304984****",
"peer_no": "1304984****",
"call_type": "1",
"call_id": "4461122c480****",
"call_time": "2021-12-10 10:00:00",
"pool_key": "FC2256****",
"ring_time": "2021-12-10 10:00:03",
"start_time": "2021-12-10 10:06:00",
"sub_id": "100004306803****",
"city": "西安",
"out_id": "8136812621****"
}]
字段说明
参数名 | 参数类型 | 示例 | 描述 |
phone_no | String | 1314456**** | A号码。 |
secret_no | String | 1304984**** | 隐私号码。 |
peer_no | String | 1380000**** | B号码、N号码或者G组号码。 |
call_type | Number | 1 | 呼叫类型。取值:
|
call_id | String | 44611dd0c30**** | 呼叫记录ID。 |
call_time | String | 2021-12-10 10:00:00 | 主叫拨打时间。 |
pool_key | String | FC2256**** | 号码池Key。 |
ring_Time | String | 2021-12-10 10:00:03 | 振铃时间。 |
start_time | String | 2021-12-10 10:06:00 | 被叫接听时间。 |
sub_id | Long | 100004306803**** | 绑定关系ID。 |
city | String | 西安 | 隐私号码归属地。 |
out_id | String | 8136812621**** | 外部业务ID。 |
extension | String | 8011 | 分机号。 |
响应说明
响应样例:
{
"code" : 0,
"msg" : "接收成功"
}
字段说明:
名称 | 类型 | 是否必选 | 示例值 | 描述 |
code | Number | 是 | 0 | 应答编码。 |
msg | String | 否 | 接收成功 | 描述信息。 |
系统仅校验返回值的code是否为数字,不校验内容。若HTTP状态码为200,请求成功。HTTP状态码非200或响应超时情况下,系统会进行重试推送。
若出现系统异常、消费失败等情况,建议HTTP响应码返回50X。
重新推送
第一次推送失败后,间隔1分钟、5分钟、10分钟后会进行重推,直至推送成功为止。如果推送3次后仍失败,不再重试。