# Deepgram Webhooks ## 何时使用此技能 * 为转录结果设置 Deepgram 回调处理程序 * 处理来自 Deepgram 的异步转录结果 * 为 Deepgram 回调实现 webhook 身份验证 * 处理转录完成事件 ## 基本代码 Deepgram Webhook（回调）用于异步接收转录结果。当您在转录请求中提供回调 URL 时，Deepgram 会立即响应“request_id”，并在处理完成后将转录结果发送到您的回调 URL。 ### 基本 Webhook 处理程序 // Express.js 示例 app.post('/webhooks/deepgram',express.raw({ type: 'application/json' }), (req, res) => { // 使用 dg-token 标头验证 webhook 的真实性 const dgToken = req.headers['dg-token']; 如果（！dgToken）{ return res.status(401).send('缺少 dg-token 标头'); } // 验证令牌是否与您期望的 API 密钥标识符匹配 // dg-token 包含原始请求中使用的 API 密钥标识符 if (dgToken !== process.env.DEEPGRAM_API_KEY_ID) { return res.status(403).send('无效的 dg-token'); } // 解析转录结果 consttranscriptionResult = JSON.parse(req.body.toString()); // 处理转录 console.log('收到转录：',transcriptionResult); // 返回成功以防止重试 res.status(200).send('确定'); }); ### 身份验证方法 Deepgram 支持两种 Webhook 身份验证方法： 1. **dg-token Header** ：自动包含，包含 API 密钥标识符 2. **基本身份验证**：在回调 URL 中嵌入凭据 // 使用 dg-token 标头（推荐） const verifyDgToken = (req, res, next) => { const dgToken = req.headers['dg-token']; if (!dgToken || dgToken !== process.env.DEEPGRAM_API_KEY_ID) { return res.status(403).send('身份验证无效'); } 下一个（）; }; // 回调 URL 中的基本身份验证 // https://用户名:密码@your-domain.com/webhooks/deepgram ### 通过回调发出请求卷曲\ --请求帖子\ --header '授权：令牌 YOUR_DEEPGRAM_API_KEY' \ --header '内容类型：音频/wav' \ --data-binary @audio.wav \ --url 'https://api.deepgram.com/v1/listen?callback=https://your-domain.com/webhooks/deepgram' ## 常见事件类型 Deepgram 将转录结果作为 Webhook 负载发送。该结构根据您请求中启用的功能而有所不同：领域 |描述 |永远存在 ---|---|--- `request_id` |转录请求的唯一标识符 |是的 `创建` |创建转录时的时间戳 |是的 `持续时间` |音频长度（以秒为单位）|是的 `渠道` |音频通道数 |是的 `结果` |按通道划分的转录结果 |是的 `results.channels[].alternatives` |转录替代品 |是的 `results.channels[].alternatives[].transcript` |转录文本 |是的 `results.channels[].alternatives[].confidence` |置信度得分 (0-1) |是的 ## 环境变量 # 您的 Deepgram API 密钥（用于发出请求） DEEPGRAM_API_KEY=your_api_key_here # API密钥标识符（在Deepgram控制台中显示，用于验证dg-token） # 注意：这不是您的 API 密钥秘密 - 它是显示的唯一标识符 # 在 Deepgram 控制台中标识请求使用了哪个 API 密钥 DEEPGRAM_API_KEY_ID=your_api_key_id_here # 您的 webhook 端点 URL WEBHOOK_URL=https://your-domain.com/webhooks/deepgram ## 本地发展对于本地 webhook 测试，请安装 Hookdeck CLI： # 通过 npm 安装 npm install -g hookdeck-cli # 或者通过自制程序酿造安装hookdeck/hookdeck/hookdeck # 创建本地隧道（无需帐户） hookdeck Listen 3000 --path /webhooks/deepgram # 在发出 Deepgram 请求时使用提供的 URL 作为回调 URL 这提供了： * 用于测试的本地隧道 URL * 用于检查 webhook 负载的 Web UI * 请求历史记录和调试工具 ## 重要提示 ### 重试行为 * Deepgram 重试失败回调（非 200-299 状态）最多 10 次 * 重试尝试之间有 30 秒的延迟 * 成功处理的 webhooks 始终返回 200-299 状态 ### 端口限制 * 仅允许回调端口 80、443、8080 和 8443 * 确保您的 webhook 端点使用这些端口之一 ### 无签名验证 * Deepgram 通过 dg-token 标头使用简单的基于令牌的身份验证，而不是其他提供商使用的加密 HMAC 签名 * 身份验证依赖于“dg-token”标头或基本身份验证 * 始终对 webhook 端点使用 HTTPS ## 资源 * [overview.md]() \- Deepgram webhooks 是什么，转录事件 * [setup.md]() \- 在 Deepgram API 请求中配置回调 * [verification.md]() \- 身份验证方法和安全注意事项 * [examples/]() \- Express、Next.js 和 FastAPI 的完整实现 ## 推荐：webhook-handler-patterns 对于生产处理程序，请与此技能一起安装模式技能。关键参考（仅安装此技能时链接有效）： * [幂等性]() * [错误处理]() * [重试逻辑]() ## 相关技能 * [stripe-webhooks]() \- Stripe 支付 webhooks * [shopify-webhooks]() \- Shopify 商店 webhooks * [github-webhooks]() \- GitHub 存储库 webhooks * [webhook-handler-patterns]() \- 幂等性、错误处理、重试逻辑 * [hookdeck-event-gateway]() \- 取代队列的 Webhook 基础设施 — 保证交付、自动重试、重播、速率限制和 Webhook 处理程序的可观察性

Deepgram Webhook

包含技能