SuperAPI AI 工具集

aircall-webhooks

编程与开发

查看项目

更新于 10-15 22:14

技能介绍

用途:接收并校验 Aircall Webhook,适用于搭建 Aircall Webhook 处理器、排查 token 校验失败,以及处理通话、消息、联系人等事件。

主要能力:说明 Aircall 事件信封结构(resource、event、timestamp、token、data 五个顶层字段),列出常见事件类型,如 call.created、call.answered、call.ended、call.tagged、message.received、contact.created、user.connected.v2、number.opened、transcription.created 等,并给出投递语义与处理建议。

校验方式:Aircall 没有签名头,也没有加密签名。每个事件体含顶层 token 字符串,等于创建 Webhook 时下发的 token。校验即用常量时间比较该字段与存储的 token,例如 Node 用 crypto.timingSafeEqual,Python 用 secrets.compare_digest。不要查找 X-Aircall-Signature、HMAC-SHA256 或 Standard Webhooks 头。因密钥在请求体中,解析后的 JSON 即可,无需原始请求体;token 明文传输,必须使用 HTTPS。

投递语义:需立即返回 200,Aircall 5 秒超时,应异步处理;至少一次且无序投递,处理器须幂等且不假设顺序;按 data.id 做 upsert;非 2xx 或超时算失败,Aircall 会重试,最终可能禁用 Webhook,失败事件保留重试 12 小时,期间成功可自动重新启用;必须 HTTPS,无 IP 白名单。

环境变量:AIRCALL_WEBHOOK_TOKEN 来自 POST /v1/webhooks 的 webhook.token,注意它不是 API 密钥。

本地开发:npx hookdeck-cli listen 3000 aircall --path /webhooks/aircall,无需账号,CLI 会创建访客账号并提供公网 URL 与请求查看界面,隧道提供 Aircall 所需的 HTTPS。

限制:资料未提供具体收费、价格与完整事件目录细节;重试阈值官方文档说法不一致,不应依赖确切数字。