API 与 Zapier
API 与 Zapier
InterMIND 生成的每份会议总结都能直接进入您的工作工具中——无论是 CRM、服务台、任务追踪器还是电子表格——无需任何人手动复制。有三种接入方式：
- 您的 AI 助手（Claude、ChatGPT、Copilot、Gemini 及任何其他 MCP 客户端）：参见 AI 助手 (MCP)。
- Zapier（无代码）：使用 API 密钥连接一次 InterMIND，然后基于 Meeting Recap Ready 触发器和 Create Meeting Link 操作构建 Zap。同样的集成也可通过 Make、n8n 或 Pipedream 的通用 Webhook 和 HTTP 模块实现，使用下方 API。
- API（面向开发者）：一个个人密钥、一个 Webhook 事件和十余个端点——涵盖会议、会议总结、转写记录、频道和文档。
**适用对象：**每个已注册账户。访客无法创建密钥。 **入口：**Integrations → API keys。
API 密钥
- 打开 Integrations 并找到 API keys 卡片。
- 点击 Create key，为其指定一个标签（即将要使用它的工具，例如 "Zapier"）并复制密钥。它以
imk_开头，且仅显示一次——InterMIND 仅存储其哈希值。 - 随时可在同一卡片中吊销密钥。使用该密钥创建的 Webhook 订阅将立即停止。
每个账户最多可拥有 10 个密钥。将密钥作为 Bearer Token 发送：
Authorization: Bearer imk_…
密钥仅适用于下方的 /api/v1 端点；它们绝不授予对 Web 应用程序自身 API 的访问权限。
Zapier
- 在 Zapier 中，将 InterMIND 应用添加到 Zap 中，并在提示时粘贴您的 API 密钥。该连接会以您的账户电子邮件进行标记。
- 触发器 Meeting Recap Ready —— 每当您主持的会议结束并生成总结后，就会触发一次。包含字段：会议标题和链接、会议总结链接、转写记录链接、Markdown 格式的总结、总结语言、开始和结束时间、参与者（姓名、电子邮件）、主持人。
- 操作 Create Meeting Link —— 创建一个您拥有的临时会议并返回其 URL。将其放入 CRM 交易、支持工单或日历邀请中；任何人打开该链接都可发起敲门请求，由您在会议中批准他们进入。
典型 Zap 示例：会议总结 → 在 HubSpot 交易中添加新备注；会议总结 → 在 Zendesk 工单中添加内部评论；会议总结 → 在 Google Sheets 中添加一行；新建 Pipedrive 交易 → 将会议链接写回该交易。
端点
基础 URL：https://intermind.com/api/v1。所有响应均为 JSON 格式。机器可读契约（OpenAPI 3.1，适用于 Make、n8n、Pipedream 和 AI 代理）：https://intermind.com/api/v1/openapi.json。
| 方法 | 路径 | 用途 |
|---|---|---|
GET | /me | 密钥的所有者：{ id, email, name } |
POST | /meetings | 创建临时会议链接。请求体 { "title": "…" }（可选）。返回 201 { id, url, title, created_at }。使用 starts_at (YYYY-MM-DDTHH:mm)、time_zone、可选的 duration_min 和 invitees 时，会议也会同步写入您连接的日历；响应会加上时间窗口及 calendar: created / not_connected / failed |
GET | /meetings?kind=recent|upcoming&type=&limit=10 | 您主持或参与的会议：recent 表示按最近活动排序，upcoming 表示未来已安排的会议 |
GET | /meetings/{id}/transcript?session=&max_chars=60000 | 按发言人划分的最终转写记录（Markdown 格式），语言为口语原始语言（或您缓存的翻译）；如被截断则显示 truncated |
GET | /recaps?limit=3 | 您的最新会议总结（1–10 条），按最新顺序排列，格式与 Webhook 负载相同 |
GET | /recaps/search?q=&limit=5 | 标题或当前总结包含相应单词（匹配词形）的会议总结，附带高亮片段和链接 |
GET | /channels?limit=20 | 您所属的团队聊天和收件箱 |
GET | /channels/{id}/messages?limit=50&before= | 频道聊天记录的一页，从最旧开始，如果聊天室产生了翻译，则附带目标聊天语言的缓存翻译 |
POST | /channels/{id}/messages | 以您的身份发送 { "text": "…" } → 201 { id, sent_at, text }；实时分发并为每位读者提供翻译 |
GET | /documents?meeting_id=&limit=50 | 在您的会议中共享的文件——包括上传的文件和关联的 Drive / OneDrive 文件 |
GET | /webhooks | 您的 Webhook 订阅 |
POST | /webhooks | 订阅：{ "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | 取消订阅 → 204 |
密钥拥有其创建时被赋予的权限：2026 年 9 月之前创建的密钥只能访问 /me、POST /meetings、/recaps 和 /webhooks —— 较新的端点会返回 403，直到您创建新密钥（或重新连接应用）。读取权限仅限于您主持或参加的会议：查询其他会议的 ID 会返回 404。
限制：每个账户最多 10 个密钥和 20 个 Webhook 订阅。target_url 必须是 https:// 且可公开访问——私有网络地址将被拒绝。
Webhook：recap.ready
当您主持的会议生成非空总结的最终版时，会以 POST JSON 请求发送到每个已订阅的 target_url。每场会议会话仅发送一次。头部信息：
| 头部 | 值 |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | 此事件的唯一 ID (<meeting id>.<session id>) —— 可据此进行去重 |
X-InterMIND-Signature | sha256=<HMAC-SHA256 of the raw body with the subscription's secret> |
User-Agent | InterMIND-Webhooks/1 |
负载：
{
"id": "abc-def-ghi.conf_01",
"event": "recap.ready",
"occurred_at": "2026-09-04T10:32:11.000Z",
"meeting": { "id": "abc-def-ghi", "title": "Weekly sync with Acme", "url": "https://intermind.com/abc-def-ghi", "type": "adhoc" },
"recap": {
"url": "https://intermind.com/r/abc-def-ghi/…",
"transcript_url": "https://intermind.com/t/abc-def-ghi/…",
"summary_md": "## Decisions\n- …",
"language": "en"
},
"session": { "started_at": "2026-09-04T10:00:03.000Z", "ended_at": "2026-09-04T10:31:40.000Z" },
"participants": [{ "name": "Anna Müller", "email": "anna@acme.example" }],
"host": { "name": "Anna Müller", "email": "anna@acme.example" }
}
投递规则：您的端点应在 8 秒内响应 2xx 状态码。网络错误、5xx 或 429 会立即重试一次。返回 410 或 404 将删除该订阅。任何其他错误都会被记录且事件不会重发——会议总结电子邮件和总结页面将作为持久记录。会议总结和转写记录链接对已登录的会议参与者开放。