给 HTTP 智能体接入 WhatsApp 语音
教程通过开源 FastAPI 网关 agent-voice-bridge,将 WhatsApp 文本和语音消息转交给 HTTP 智能体处理。语音链路串联下载、转写与语音合成,并支持 Meta 和 Twilio 接入。
原文暂未完整获取,基于公开信息的快读
开源 FastAPI 网关 agent-voice-bridge 给现有 HTTP 智能体增加了 WhatsApp 文本和语音留言入口。dev.to 上的教程展示了完整链路:文字消息收到文字回复,语音留言经过转写、智能体处理和语音合成,再以语音形式返回。这里处理的是录音留言,不是实时通话。
目前能确认什么
项目采用 Apache 2.0 许可证,支持 Twilio 和 Meta WhatsApp Cloud API。网关负责接收渠道消息、下载录音、调用语音服务,再把统一的 JSON 请求 POST 给智能体。智能体返回 {"reply_text":"..."} 即可,不需要处理两家渠道各自的消息格式。
教程用一个 FastAPI 回声接口验证链路,也展示了接入 LangGraph 和 n8n 的方式。请求中的 sender_id 可用作会话标识,但上下文记忆仍需智能体侧实现。
网关会先确认收到 webhook,再在后台执行耗时任务。原文还说明了签名校验、有限重试和临时音频清理机制。音频格式也会影响呈现:OpenAI、Azure OpenAI 返回的 Ogg/Opus 显示为语音留言,ElevenLabs 返回的 MP3 则作为音频附件。
我的判断
它的直接价值,是让已有文本智能体复用一套渠道与语音处理代码。
业务接口已经能接收文本、返回文本的团队,可以把语音转换放在网关层,减少对智能体内部流程的改动。但「任意 HTTP 智能体」仍有接口前提,已有服务可能需要适配请求字段和返回结构。
标题里的「10 分钟」应理解为教程演示目标,不能据此判断生产接入工期。现有节选没有交代并发承载、后台任务持久化和服务重启后的恢复行为;有限重试也不能单独证明端到端不会重复回复。语音合成失败后的降级说明恰好被截断,具体行为仍待完整原文或项目文档确认。