Dograh Vonage集成教程欧洲企业级语音AI接入实战指南【免费下载链接】dograhOpen source voice AI platform. Self-hosted alternative to Vapi and Retell. On Prem, BYOK across Speech to Speech or LLM/STT/TTS, with a visual workflow builder, MCP native and telephony support.项目地址: https://gitcode.com/GitHub_Trending/do/dograhDograh 是一个开源、可自托管的语音 AI 平台Voice AI Platform是 Vapi 和 Retell 的自托管替代品支持语音到语音Speech-to-Speech或 LLM/STT/TTS 架构并内置可视化工作流编排器。本教程带你从零完成 Dograh 的 Vonage 集成配置真实电话号码、打通呼入/呼出电话让你的 AI 语音坐席在欧洲及全球客户之间稳定通话。为什么欧洲企业选择 Vonage 接入语音AIVonage原 Nexmo是全球领先的云通信平台在欧洲企业市场有三大独特优势16kHz 高音质音频Vonage 支持 16kHz 线性 PCM 音频流相比传统 8kHz 电话音质更清晰、语音识别准确率更高、TTS 播报更自然出色的国际覆盖欧洲本地号码与跨国呼叫覆盖完整非常适合跨国客服与营销外呼JWT 安全认证 签名回调Dograh 使用 JWTRS256调用 Vonage 语音 API并用签名 Secret 校验回调请求企业级安全Dograh 内置了 Twilio、Vonage、Telnyx、Plivo、Vobiz、Cloudonix 与 Asterisk ARI 等电信集成见 README.mdVonage 是其中面向欧洲市场的推荐方案。开始前的准备工作配置 Dograh Vonage 集成前请准备好以下材料材料获取位置Vonage 账号Vonage 官网注册Voice 能力的应用ApplicationVonage Dashboard → ApplicationsApplication ID Private Key创建应用时生成务必妥善保存API Key API SecretVonage Dashboard → API SettingsSignature SecretVonage 账号级别至少一个号码Vonage Dashboard → Numbers可公网访问的 Dograh 实例自托管部署已完成⚠️ 自托管用户注意Vonage 必须能从公网访问你的后端域名localhost地址是无法收到回调的。第一步在 Vonage 控制台创建语音应用登录 Vonage Dashboard进入Applications → Create a new application启用Voice能力生成Private Key保存完整文件包含 BEGIN/END 行后面要原样粘贴记下Application ID随后在API Settings中复制API Key和API Secret并复制账号级别的Signature SecretDograh 用它验证 Vonage 的签名 Webhook。最后在Numbers → Your Numbers中购买或关联号码并将每个用于呼入的号码绑定到上面创建的 Voice 应用——这一步最关键如果号码没有绑定到应用Vonage 根本不会回调 Dograh 的 Answer URL你只会听到忙音而 Dograh 日志里什么都看不到。第二步在 Dograh 中配置 Vonage 电信参数进入 Dograh 面板这是配置的完整流程打开Telephony Configurations页面点击Add configuration提供商选择Vonage填写凭据Application IDPrivate Key完整密钥含 BEGIN/END 行API KeyAPI SecretSignature Secret点击保存进入刚创建的配置添加至少一个电话号码注意不带前缀写14155551234而不是14155551234默认主叫号码用于外呼配置表单的字段定义见 config.py其中 API Secret、Private Key、Signature Secret 在读取接口中会被自动脱敏masked只有 Application ID 明文可见。第三步配置呼入来电Inbound CallingVonage 的呼入路由以应用为单位同一个 Voice 应用下所有号码共享一个 Answer URL。Dograh 通过号码在Inbound workflow中的分配把来电路由到正确的 AI 坐席。1. 绑定号码在 Vonage Dashboard 中把每个呼入号码的 Voice 应用app_id设置为你在 Dograh 里配置的同一个应用。2. 分配呼入工作流回到 Dograh 的 Telephony 配置页编辑需要接收来电的号码将Inbound workflow设置为应答的坐席保存。保存后 Dograh 会自动完成两件事由 provider.py 中的configure_inbound实现将应用的Answer URL更新为https://你的后端域名/api/v1/telephony/inbound/runPOST将Event URL更新为https://你的后端域名/api/v1/telephony/vonage/eventsPOST并自动启用签名回调 如果保存时出现同步警告请检查 API Key、API Secret、Application ID 和 Signature Secret 是否正确后重新保存呼入工作流。3. 验证打开 Vonage 应用的Capabilities → Voice确认 Answer URL / Event URL 已正确写入且 Signed callbacks 已开启。用另一部手机拨打该号码Dograh 的 AI 坐席即可自动应答。第四步测试外呼并查看通话记录外呼测试很简单创建一个测试工作流在面板中点击Call按钮发起呼叫。Dograh 会通过 Vonage Voice APIPOST /v1/calls发起呼叫返回 NCCONexmo Call Control Objects指令把通话音频通过 WebSocket 桥接到 AI 管道16kHz PCM。几个值得了解的实现细节呼叫控制用 NCCOJSON 格式区别于 Twilio 的 XMLTwiML核心指令是把通话connect到带鉴权参数的 WebSocket事件回调统一打到 routes.py 中的/vonage/events/{workflow_run_id}端点覆盖 started、ringing、answered、complete、failed 等全生命周期状态每次回调都会先做 JWT 签名校验不通过直接返回 401号码归属校验保存号码时 Dograh 会调用 Vonage 的 owned-numbers 接口确认号码确实属于当前账号避免配置张冠李戴常见问题排查清单现象排查方向JWT 认证失败Private Key 不完整需含 BEGIN/END 行、Application ID 错误、密钥被重新生成过签名校验失败Signature Secret 两边不一致应用未启用签名回调确认回调带Authorization头号码无效报错去掉前缀保持 E.164 格式国家码号码无空格横线来电忙音且无日志号码未绑定到 Dograh 配置的 Voice 应用后端域名必须公网可达通话中途断开检查 WebSocket 心跳、负载均衡器/代理的空闲超时设置无声通话检查音频管道是否为 16kHz PCM确认 VAD语音活动检测正常工作另外提醒一点目前 Dograh 的 Vonage 提供商尚不支持通话转接call transfer如果你的业务流程依赖转人工坐席可以先用 Twilio 或 Cloudonix 等支持该功能的提供商。企业级最佳实践安全Private Key 加密存储于数据库始终保持签名回调开启并同步最新 Signature Secret冗余为同一应用配置多个号码避免单点故障监控在 Vonage Dashboard 配置呼叫失败告警配合 Dograh 面板的通话日志双向核对成本控制Vonage 按分钟计费 号码月租建议在 Dashboard 设置用量监控完整官方文档可参考 vonage.mdx更多提供商对比见 overview.mdx行为测试用例位于 test_provider.py。至此你的 Dograh 语音 AI 已通过 Vonage 接入欧洲企业级电话网络外呼、呼入、状态追踪、签名安全一站搞定。下一步可以为坐席添加工具Tools、知识库Knowledge Base或启用活动外呼Campaigns批量触达客户。【免费下载链接】dograhOpen source voice AI platform. Self-hosted alternative to Vapi and Retell. On Prem, BYOK across Speech to Speech or LLM/STT/TTS, with a visual workflow builder, MCP native and telephony support.项目地址: https://gitcode.com/GitHub_Trending/do/dograh创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考