calls webhook - nxtele/http-api-document GitHub Wiki
calling相关回执
应用上配置的webhook值【需要订阅 如下事件】
- calls calling事件
对提供的webhook地址,进行推送信息
- URL:
webhook_url - Method:
POST - Content-Type:
application/json
验签说明
对于客户应用配置了回执加签算法,所有的回执请求服务端都会进行加签处理,客户端可自行对回执请求进行验签处理,验签算法请参照签名算法
calling呼叫记录的回执
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| calls | array[Call Object] | 记录对象 |
| business_phone | String | 商户电话 |
| messaging_product | String | 消息类型,固定值”whatsapp“ |
| wabaId | String | waba id |
- Call Object参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| call_id | String | call_id |
| from | String | 拨打方号码 |
| to | String | 接听方号码 |
| costs | Cost Object | 费用信息 |
| start_time | String | 通话开始时间戳 |
| end_time | String | 通话终止时间戳 |
| record | String | 录音文件地址 |
| call_duration | Integer | 通话时长 |
| fee_duration | Integer | 计费时长 |
| bill_type | String | 计费方式6+6 |
| end_direction | Integer | 挂断方:0主叫, 1被叫,2服务器,3 未知 |
| end_reason | String | 终止原因 |
- Cost Object参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| direction | Integer | 1-呼出 0-呼入 |
| currency | String | 币种 |
| price | Double | 币种对应的费用 |
回执示例
{
"app_id": 277,
"business_phone": "xxx",
"channel": 2,
"merchant_phone": "xxx",
"messaging_product": "whatsapp",
"wabaId": "xxx",
"calls": [
{
"call_id": "ae5b182f-f37b-123e-dcb0-42010a34f811",
"from": "xxx",
"to": "xxx",
"costs": [
{
"direction": 1,
"currency": "EUR",
"price": 1.2948
}
],
"start_time": "1755153316",
"end_time": "1755153319",
"record": "https://xxx",
"call_duration": 55,
"fee_duration": 60,
"bill_type": "6+6",
"end_direction": 1,
"end_reason": "Busy Here"
}
]
}