API & Zapier

Hantar rumusan reunion ke CRM, help desk atau hamparan anda dengan Zapier, atau panggil API InterMIND secara terus menggunakan kunci API peribadi.

API & Zapier

Setiap rekap yang dihasilkan InterMIND boleh sampai ke alat tempat anda bekerja — CRM, help desk, penjejak tugasan atau hamparan — tanpa sesiapa perlu menyalinnya secara manual. Tiga cara untuk bermula:

  • Pembantu AI anda (Claude, ChatGPT, Copilot, Gemini dan mana-mana klien MCP yang lain): lihat Pembantu AI (MCP).
  • Zapier (tanpa kod): sambungkan InterMIND sekali sahaja dengan kunci API, kemudian bina Zap menggunakan pencetus Meeting Recap Ready dan tindakan Create Meeting Link. Integrasi yang sama juga berfungsi daripada Make, n8n atau Pipedream melalui modul webhook dan HTTP generik mereka, dengan menggunakan API di bawah.
  • API (untuk pembangun): satu kunci peribadi, satu peristiwa webhook dan belasan endpoint — meeting, rekap, transkrip, saluran, dokumen.

Tersedia untuk: setiap akaun berdaftar. Tetamu tidak boleh membuat kunci. Lokasi: Integrations → API keys.

Rekap juga boleh sampai ke mana-mana alat yang mempunyai alamat e-mel masuk — tambahkannya sebagai penerima salinan rekap pada meeting atau saluran, tanpa memerlukan sebarang integrasi. Lihat Salinan rekap.

Kunci API

  1. Buka Integrations dan cari kad API keys.
  2. Klik Create key, berikan label (alat yang akan menggunakannya, cth. "Zapier") dan salin kunci tersebut. Kunci bermula dengan imk_ dan dipaparkan sekali sahaja — InterMIND hanya menyimpan hash.
  3. Batalkan kunci daripada kad yang sama pada bila-bila masa. Langganan webhook yang dibuat dengan kunci itu terhenti serta-merta.

Sehingga 10 kunci bagi setiap akaun. Hantar kunci sebagai bearer token:

Authorization: Bearer imk_…

Kunci hanya berfungsi pada endpoint /api/v1 di bawah; kunci tidak sekali-kali memberikan akses kepada API aplikasi web itu sendiri.

Zapier

  1. Dalam Zapier, tambahkan aplikasi InterMIND pada Zap dan tampal kunci API anda apabila diminta. Sambungan tersebut dilabelkan dengan e-mel akaun anda.
  2. Pencetus Meeting Recap Ready — dicetuskan sekali bagi setiap meeting selesai yang anda anjurkan, sebaik sahaja ringkasan wujud. Medan: tajuk dan pautan meeting, pautan rekap, pautan transkrip, ringkasan dalam Markdown, bahasa ringkasan, masa mula dan tamat, peserta (nama, e-mel), hos.
  3. Tindakan Create Meeting Link — membuat meeting ad hoc yang anda miliki dan memulangkan URL-nya. Letakkannya dalam tawaran CRM, tiket sokongan atau jemputan kalendar; sesiapa yang membuka pautan itu akan mengetuk dan anda meluluskan mereka dalam bilik.

Contoh Zap lazim: rekap → nota baharu pada tawaran HubSpot; rekap → komen dalaman pada tiket Zendesk; rekap → baris dalam Google Sheets; tawaran Pipedrive baharu → pautan meeting ditulis semula ke dalam tawaran tersebut.

Endpoint

URL asas: https://intermind.com/api/v1. Semua respons dalam format JSON. Kontrak boleh dibaca mesin (OpenAPI 3.1, untuk Make, n8n, Pipedream dan ejen AI): https://intermind.com/api/v1/openapi.json.

KaedahLaluanTujuan
GET/mePemilik kunci: { id, email, name }
POST/meetingsBuat pautan meeting ad hoc. Badan { "title": "…" } (pilihan). Memulangkan 201 { id, url, title, created_at }. Dengan starts_at (YYYY-MM-DDTHH:mm), time_zone, duration_min pilihan dan invitees, meeting turut ditulis ke kalendar anda yang disambungkan; respons menambah tetingkap masa dan calendar: created / not_connected / failed
GET/meetings?kind=recent|upcoming&type=&limit=10Meeting yang anda anjurkan atau hadiri: recent mengikut aktiviti terakhir, upcoming dijadualkan pada masa hadapan
GET/meetings/{id}/transcript?session=&max_chars=60000Transkrip muktamad terkini dalam Markdown mengikut penutur, dalam bahasa yang dituturkan (atau terjemahan tersimpan anda); truncated apabila dipotong
GET/recaps?limit=3Rekap terbaharu anda (1–10), yang terbaharu dahulu, dalam bentuk muatan webhook
GET/recaps/search?q=&limit=5Rekap yang tajuk atau ringkasan semasanya menyebut perkataan tersebut (bentuk perkataan dipadankan), dengan petikan yang diserlahkan dan pautan
GET/channels?limit=20Sembang pasukan dan peti masuk yang anda sertai
GET/channels/{id}/messages?limit=50&before=Satu halaman sembang saluran, yang terlama dahulu, dengan terjemahan tersimpan ke dalam bahasa sembang anda apabila bilik itu telah membuatnya
POST/channels/{id}/messagesHantar { "text": "…" } sebagai anda → 201 { id, sent_at, text }; diedarkan secara langsung dan diterjemahkan untuk setiap pembaca
GET/documents?meeting_id=&limit=50Fail yang dikongsi dalam meeting anda — muat naik dan fail Drive / OneDrive yang dipautkan
GET/webhooksLangganan webhook anda
POST/webhooksMelanggan: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at }
DELETE/webhooks/{id}Berhenti melanggan → 204

Sesuatu kunci membawa hak yang diberikan semasa ia dibuat: kunci yang dibuat sebelum September 2026 hanya membuka /me, POST /meetings, /recaps dan /webhooks — endpoint yang lebih baharu menjawab 403 sehingga anda membuat kunci baharu (atau menyambung semula aplikasi). Bacaan terhad kepada meeting yang anda anjurkan atau hadiri: id meeting lain dijawab dengan 404.

Had: 10 kunci dan 20 langganan webhook bagi setiap akaun. target_url mestilah https:// dan boleh dicapai secara awam — alamat rangkaian peribadi ditolak.

Webhook: recap.ready

Dihantar sebagai JSON POST kepada setiap target_url yang dilanggan sebaik sahaja rekap bagi meeting yang anda anjurkan dimuktamadkan dengan ringkasan yang tidak kosong. Ia dihantar sekali bagi setiap sesi meeting. Pengepala:

PengepalaNilai
X-InterMIND-Eventrecap.ready
X-InterMIND-DeliveryID unik peristiwa ini (<meeting id>.<session id>) — nyahduplikasi berdasarkannya
X-InterMIND-Signaturesha256=<HMAC-SHA256 of the raw body with the subscription's secret>
User-AgentInterMIND-Webhooks/1

Muatan:

{
  "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" }
}

Peraturan penghantaran: endpoint anda hendaklah menjawab 2xx dalam masa 8 saat. Ralat rangkaian, 5xx atau 429 dicuba semula sekali dengan serta-merta. 410 atau 404 memadamkan langganan. Sebarang kegagalan lain direkodkan dan peristiwa itu tidak dihantar semula — e-mel rekap dan halaman rekap kekal sebagai rekod tahan lama. Pautan rekap dan transkrip dibuka untuk peserta meeting yang telah log masuk.