API & Zapier
API & Zapier
InterMINDが生成するすべてのレポートは、誰かが手作業でコピーすることなく、あなたの作業ツール（CRM、ヘルプデスク、タスクトラッカー、スプレッドシートなど）に直接届けることができます。2つの接続方法があります:
- Zapier（ノーコード）: APIキーでInterMINDに一度接続し、Meeting Recap ReadyトリガーとCreate Meeting LinkアクションでZapを構築します。以下のAPIを使用することで、Make、n8n、Pipedreamの汎用WebhookおよびHTTPモジュールからも同じ統合を利用できます。
- The API（開発者向け）: 個人キー、1つのWebhookイベント、3つのエンドポイント。
利用可能な対象: すべての登録済みアカウント。ゲストはキーを作成できません。 場所: 設定 → APIキー。
APIキー
- 設定を開き、APIキーカードを見つけます。
- Create keyをクリックし、ラベル（使用するツール名、例: "Zapier"）を付けて、キーをコピーします。
imk_で始まり、一度だけ表示されます — InterMINDはハッシュのみを保存します。 - 同じカードからいつでもキーを取り消せます。そのキーで作成されたWebhookサブスクリプションは直ちに停止します。
1アカウントあたり最大10個のキーを作成できます。キーはベアラートークンとして送信してください:
Authorization: Bearer imk_…
キーは以下の/api/v1エンドポイントでのみ機能し、Webアプリケーション独自のAPIへのアクセスを許可することはありません。
Zapier
- Zapierで、ZapにInterMINDアプリを追加し、求められたらAPIキーを貼り付けます。接続にはアカウントのメールアドレスがラベル付けされます。
- トリガーMeeting Recap Ready — あなたがホストを務めた終了したミーティングごとに、要約が生成されるとすぐに1回発火します。フィールド: ミーティングのタイトルとリンク、レポートリンク、トランスクリプトリンク、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。
| Method | Path | 目的 |
|---|---|---|
GET | /me | キーの所有者: { id, email, name } |
POST | /meetings | アドホックミーティングリンクを作成。ボディ { "title": "…" }（任意）。201 { id, url, title, created_at } を返します |
GET | /recaps?limit=3 | 最新のレポート（1〜10件）、新しい順、Webhookペイロードの形式 |
GET | /webhooks | あなたのWebhookサブスクリプション |
POST | /webhooks | サブスクリプション: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | サブスクリプション解除 → 204 |
制限: 1アカウントあたり10個のキーおよび20個のWebhookサブスクリプション。target_urlはhttps://であり、公開到達可能である必要があります — プライベートネットワークアドレスは拒否されます。
Webhook: recap.ready
あなたがホストを務めたミーティングのレポートが空でない要約とともに確定された瞬間に、すべてのサブスクライブ済みtarget_urlへPOST JSONとして送信されます。これはミーティングセッションごとに1回送信されます。ヘッダー:
| Header | Value |
| --- | --- | --- |
| 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の場合は、直ちに1回再試行されます。410または404の場合はサブスクリプションが削除されます。その他の失敗はログに記録され、イベントは再送信されません — レポートメールとレポートページが永続的な記録として残ります。レポートおよびトランスクリプトのリンクは、サインインしているミーティング参加者に対して開かれます。