API & Zapier
API & Zapier
InterMINDが生成するすべてのレックアップは、手作業でコピーすることなく、あなたが作業するツール — CRM、ヘルプデスク、タスクトラッカー、スプレッドシート — に届けることができます。以下の3つの方法があります:
- AIアシスタント(Claude、ChatGPT、Copilot、Gemini、その他のMCPクライアント):AIアシスタント(MCP)を参照してください。
- Zapier(ノーコード):APIキーでInterMINDに一度接続し、Meeting Recap ReadyトリガーとCreate Meeting LinkアクションでZapを構築します。以下のAPIを使用すれば、Make、n8n、Pipedreamの汎用WebhookおよびHTTPモジュールからも同じインテグレーションを利用できます。
- API(開発者向け):個人キー、1つのWebhookイベント、十数個のエンドポイント — ミーティング、レックアップ、トランスクリプト、チャネル、ドキュメント。
利用可能: すべての登録アカウント。ゲストはキーを作成できません。 場所: インテグレーション → APIキー。
APIキー
- インテグレーションを開き、APIキーカードを見つけます。
- キーを作成をクリックし、ラベル(使用するツール名、例:「Zapier」)を付けて、キーをコピーします。キーは
imk_で始まり、一度だけ表示されます — InterMINDはハッシュのみを保存します。 - 同じカードからいつでもキーを取り消せます。そのキーで作成されたWebhookサブスクリプションは即座に停止します。
アカウントあたり最大10キーを作成できます。キーはベアラートークンとして送信してください:
Authorization: Bearer imk_…
キーは以下の/api/v1エンドポイントでのみ機能します。Webアプリケーション自体のAPIへのアクセス権は付与しません。
Zapier
- Zapierで、InterMINDアプリをZapに追加し、求められたら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 | アドホックミーティングリンクを作成。Body { "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= | チャネルのチャット1ページ分(古い順)。ルームで翻訳が作成された場合、チャット言語にキャッシュされた翻訳を含む |
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に送信されます。ミーティングセッションごとに1回送信されます。ヘッダー:
| ヘッダー | 値 |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | このイベントのユニークID(<meeting id>.<session id>) — 重複排除に使用 |
X-InterMIND-Signature | sha256=<サブスクリプションのシークレットによる生ボディのHMAC-SHA256> |
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の場合、サブスクリプションは削除されます。その他の失敗はログに記録され、イベントは再送されません — レックアップメールとレックアップページが永続的な記録として残ります。レックアップとトランスクリプトのリンクは、サインイン済みのミーティング参加者のみが開けます。