SuperAPI AI 工具集

integrate-whatsapp-calling

智能体与模型

查看项目

更新于 10-15 21:53

技能介绍

用途:通过 Kapso 把语音智能体接入 WhatsApp Calling,处理 Calling 设置、签名通话 Webhook、来电接听、外呼权限与拨号,以及原生录音/转写产物。

主要能力:Kapso 转发 Meta 通话事件并代理通话动作;媒体服务器或服务商负责 WebRTC 音频与语音对话。需校验 Kapso 的十六进制 HMAC-SHA256 X-Webhook-Signature(基于原始请求字节与接收方 secret_key),10 秒内确认并排队处理。需遍历 value.calls[] 与 value.statuses[],按 value.metadata.phone_number_id 限定范围,保留 messages 处理(含 interactive.call_permission_reply),用 X-Idempotency-Key 加位置做去重,每个 call ID 单独守卫会话。

使用方式:先确定项目与 Meta 电话号码 ID,检查 Calling 设置、现有 Meta Webhook 与语音智能体分配;复用号码唯一的 Meta Webhook。外呼需检查 start_call 权限为 true,创建实时音频 peer 并以 action: "connect" 发送 SDP offer,保存返回的 call ID。

适用场景:来电接听、外呼拨号、通话生命周期处理、录音/转写完成通知。

限制:需要符合资格的专用 Cloud API 号码,消息沙箱不能用于 Calling 测试;HTTP 动作或 Webhook 成功不代表音频可用;本地清理不会挂断 WhatsApp 通话;超时或响应不确定时不要自动重拨;SIP、语音信箱与合作伙伴路由需查阅 Meta 当前文档。资料未提供具体价格与部署细节。