API & Zapier
API & Zapier
Setiap rekap yang dihasilkan InterMIND dapat masuk ke alat tempat Anda bekerja — CRM, help desk, pelacak tugas, atau spreadsheet — tanpa ada yang menyalinnya secara manual. Dua cara masuk:
- Zapier (tanpa kode): hubungkan InterMIND sekali dengan kunci API, lalu buat Zaps pada pemicu Meeting Recap Ready dan aksi Create Meeting Link. Integrasi yang sama juga berfungsi dari Make, n8n, atau Pipedream melalui modul webhook dan HTTP generik mereka, menggunakan API di bawah.
- API (untuk pengembang): kunci pribadi, satu peristiwa webhook, dan tiga endpoint.
Tersedia di: setiap akun terdaftar. Tamu tidak dapat membuat kunci. Lokasi: Settings → API keys.
Kunci API
- Buka Settings dan temukan kartu API keys.
- Klik Create key, beri label (alat yang akan menggunakannya, mis. "Zapier") lalu salin kunci. Kunci dimulai dengan
imk_dan ditampilkan sekali — InterMIND hanya menyimpan hash. - Cabut kunci dari kartu yang sama kapan saja. Langganan webhook yang dibuat dengan kunci tersebut akan langsung berhenti.
Maksimal 10 kunci per akun. Kirim kunci sebagai bearer token:
Authorization: Bearer imk_…
Kunci hanya berfungsi pada endpoint /api/v1 di bawah; kunci tidak pernah memberikan akses ke API aplikasi web itu sendiri.
Zapier
- Di Zapier, tambahkan aplikasi InterMIND ke Zap dan tempelkan kunci API Anda saat diminta. Koneksi tersebut dilabeli dengan email akun Anda.
- Trigger Meeting Recap Ready — terpicu sekali per rapat yang selesai Anda selenggarakan, segera setelah ringkasan tersedia. Bidang: judul rapat dan tautan, tautan rekap, tautan transkrip, ringkasan dalam Markdown, bahasa ringkasan, waktu mulai dan berakhir, peserta (nama, email), host.
- Action Create Meeting Link — membuat tautan rapat ad-hoc milik Anda dan mengembalikan URL-nya. Masukkan ke dalam deal CRM, tiket dukungan, atau undangan kalender; siapa pun yang membuka tautan tersebut akan mengetuk dan Anda menyetujuinya di ruangan.
Zap tipikal: rekap → catatan baru pada deal HubSpot; rekap → komentar internal pada tiket Zendesk; rekap → baris di Google Sheets; deal Pipedrive baru → tautan rapat ditulis kembali ke deal tersebut.
Endpoint
URL Dasar: https://intermind.com/api/v1. Semua respons adalah JSON. Kontrak yang dapat dibaca mesin (OpenAPI 3.1, untuk Make, n8n, Pipedream, dan agen AI): https://intermind.com/api/v1/openapi.json.
| Metode | Jalur | Tujuan |
|---|---|---|
GET | /me | Siapa pemilik kunci: { id, email, name } |
POST | /meetings | Buat tautan rapat ad-hoc. Body { "title": "…" } (opsional). Mengembalikan 201 { id, url, title, created_at } |
GET | /recaps?limit=3 | Rekap terbaru Anda (1–10), terbaru lebih dulu, dalam bentuk payload webhook |
GET | /webhooks | Langganan webhook Anda |
POST | /webhooks | Berlangganan: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | Berhenti berlangganan → 204 |
Batas: 10 kunci dan 20 langganan webhook per akun. target_url harus https:// dan dapat dijangkau publik — alamat jaringan pribadi akan ditolak.
Webhook: recap.ready
Dikirim sebagai POST JSON ke setiap target_url berlangganan saat rekap untuk rapat yang Anda selenggarakan selesai dengan ringkasan yang tidak kosong. Ini dikirim sekali per sesi rapat. Header:
| Header | Nilai |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | ID unik dari peristiwa ini (<meeting id>.<session id>) — lakukan deduplikasi berdasarkan ini |
X-InterMIND-Signature | sha256=<HMAC-SHA256 dari body mentah dengan rahasia langganan> |
User-Agent | InterMIND-Webhooks/1 |
Payload:
{
"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" }
}
Aturan pengiriman: endpoint Anda harus menjawab 2xx dalam 8 detik. Kesalahan jaringan, 5xx, atau 429 akan dicoba lagi sekali secara langsung. 410 atau 404 akan menghapus langganan. Kegagalan lainnya akan dicatat dan peristiwa tidak dikirim ulang — email rekap dan halaman rekap tetap menjadi catatan yang tahan lama. Tautan rekap dan transkrip terbuka untuk peserta rapat yang telah masuk.