API & Zapier
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.
Kunci API
- Buka Integrations dan cari kad API keys.
- 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. - 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
- Dalam Zapier, tambahkan aplikasi InterMIND pada Zap dan tampal kunci API anda apabila diminta. Sambungan tersebut dilabelkan dengan e-mel akaun anda.
- 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.
- 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.
| Kaedah | Laluan | Tujuan |
|---|---|---|
GET | /me | Pemilik kunci: { id, email, name } |
POST | /meetings | Buat 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=10 | Meeting yang anda anjurkan atau hadiri: recent mengikut aktiviti terakhir, upcoming dijadualkan pada masa hadapan |
GET | /meetings/{id}/transcript?session=&max_chars=60000 | Transkrip muktamad terkini dalam Markdown mengikut penutur, dalam bahasa yang dituturkan (atau terjemahan tersimpan anda); truncated apabila dipotong |
GET | /recaps?limit=3 | Rekap terbaharu anda (1–10), yang terbaharu dahulu, dalam bentuk muatan webhook |
GET | /recaps/search?q=&limit=5 | Rekap yang tajuk atau ringkasan semasanya menyebut perkataan tersebut (bentuk perkataan dipadankan), dengan petikan yang diserlahkan dan pautan |
GET | /channels?limit=20 | Sembang 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}/messages | Hantar { "text": "…" } sebagai anda → 201 { id, sent_at, text }; diedarkan secara langsung dan diterjemahkan untuk setiap pembaca |
GET | /documents?meeting_id=&limit=50 | Fail yang dikongsi dalam meeting anda — muat naik dan fail Drive / OneDrive yang dipautkan |
GET | /webhooks | Langganan webhook anda |
POST | /webhooks | Melanggan: { "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:
| Pengepala | Nilai |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | ID unik peristiwa ini (<meeting id>.<session id>) — nyahduplikasi berdasarkannya |
X-InterMIND-Signature | sha256=<HMAC-SHA256 of the raw body with the subscription's secret> |
User-Agent | InterMIND-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.
Telegram
Majukan mesej kepada bot InterMIND, cerminkan kumpulan Telegram ke dalam saluran, dan salurkan sembang ke dalam Inbox anda.
E-mel ke Saluran
Berikan alamat e-mel saluran anda kepada mana-mana perkhidmatan dan mesejnya akan masuk ke dalam saluran — dengan lampiran kekal utuh, dibaca oleh setiap ahli dalam bahasa mereka sendiri.