自定义 HTTP Webhook 接口配置与对接指南

如果您所在的团队有私有内部协作系统、自建 OA / ERP、数据仓库，或者您习惯使用 Zapier、Make (Integromat)、n8n、Flowise 等低代码工作流引擎，DuRT 提供了极其灵活的 通用自定义 Webhook 功能。

核心特性

标准 HTTP POST / PUT 协议：支持向任意外部 RESTful API 发起标准的 HTTP 请求。
自定义请求头 (Custom Headers)：自由配置鉴权 Header（如 Authorization: Bearer <token>、X-Custom-Secret: ...、Content-Type: application/json）。
全量结构化 JSON Payload：DuRT 会将转录文本、多语言译文、说话人分离列表、AI 摘要、结构化纪要及元数据组装为规范的 JSON 实体发送给下游。

第一步：在 DuRT 中配置自定义 Webhook

打开 DuRT 客户端，进入 「设置」->「第三方集成与推送」。
点击左下角 「+ 添加账号」，在弹出菜单中选择 「自定义 Webhook」。
在右侧配置面板中填写：
- 账号名称：如 自建企业知识库接收网关 或 n8n 自动化接收节点。
- 请求地址 (Endpoint URL)：输入您对外暴露的完整 HTTP/HTTPS 接口 URL（例如 https://api.mycompany.com/v1/durt/ingest）。
- 请求方法 (HTTP Method)：可选择 POST（推荐）或 PUT。
- 自定义请求头 (Headers JSON)：若接口需要鉴权凭证或特定协议头，可输入标准的 JSON 键值对，例如：
  json
```
{
  "Authorization": "Bearer my_super_secret_token",
  "X-Tenant-ID": "team-001"
}
```
- 内容推送偏好：
  - ✅ 包含 AI 核心摘要 (Summary)
  - ✅ 包含完整转写稿与多语言译文
  - ✅ 包含说话人分离与时间戳数据
  - ✅ 包含任务元数据 (时长、录音时间、工作流类型等)
点击右下角 「保存」。

DuRT 发送的 JSON Payload 数据结构规范

当 DuRT 触发 Webhook 时，将向下游接口发送格式如下的标准 JSON 数据体：

json

{
  "task_id": "8f9b0c2e-4d5a-4e8a-bf90-33219488a0e1",
  "title": "2026-10-14 战略规划与多模态 ASR 评审",
  "created_at": "2026-10-14T07:30:00Z",
  "duration_seconds": 1542.8,
  "formatted_duration": "00:25:42",
  "summary": "本次会议深入讨论了端侧 ASR 离线引擎与多模型聚合服务网关架构...",
  "document_markdown": "## 核心讨论要点\n1. 降低端侧延迟至 200ms 以内...\n\n## 最终决议\n全量推进 10 大推送渠道自动化交付...",
  "action_items": [
    "周五前完成私有网络环境下的 Webhook 联调测试",
    "向运营部门同步新的文档指南地址"
  ],
  "transcript": [
    {
      "start": 0.0,
      "end": 2.45,
      "speaker": "Speaker 1",
      "text": "大家下午好，今天会议正式开始。",
      "translation": "Good afternoon everyone, the meeting is officially starting."
    },
    {
      "start": 2.8,
      "end": 6.12,
      "speaker": "Speaker 2",
      "text": "我们先来看一下本周的关键交付成果。",
      "translation": "Let's first review the key deliverables for this week."
    }
  ],
  "metadata": {
    "workflow": "会议纪要全自动流",
    "app_version": "3.1.0",
    "platform": "macOS"
  }
}

经典对接应用场景

1. 对接 Zapier / Make / n8n 触发下游多任务

在 n8n 中创建一个 Webhook 触发节点，将生成的 Webhook URL 填入 DuRT。一旦录音结束：

n8n 自动将行动项同步至 Jira / Trello / Linear / ClickUp 创建工单。
将全文转写归档到 Google Drive / Dropbox / 阿里云 OSS。

2. 对接企业私有大模型与自建知识库 RAG

将 Webhook 地址指向企业内网的向量数据库构建服务（如 FastGPT / Dify / 自建 LangChain 知识库），会议录音一结束，全篇文字稿自动完成 Embedding 切片与入库，成为企业内部随时可问答检索的知识沉淀。

自定义 HTTP Webhook 接口配置与对接指南 ​

核心特性 ​

第一步：在 DuRT 中配置自定义 Webhook ​

DuRT 发送的 JSON Payload 数据结构规范 ​

经典对接应用场景 ​

1. 对接 Zapier / Make / n8n 触发下游多任务 ​