Skip to content

calls webhook

GiuFLim edited this page Oct 24, 2025 · 1 revision

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"
        }
    ]
}

简介

短信

语音

云呼叫中心(NXLink)

云呼叫中心(AI自动外呼)

Flash Call

短链

邮件验证码

DID号码

通用

号码检测

WhatsApp

Viber

Zalo ZNS

Super Message API

隐私号(旧)

PNS

坐席(旧版)

AI Agent

Clone this wiki locally