API & Zapier
API & Zapier
Elke recap die InterMIND produceert kan belanden in de tool waarin je werkt — je CRM, helpdesk, taaktracker of een spreadsheet — zonder dat iemand het met de hand hoeft over te typen. Drie manieren om dit te doen:
- Jouw AI-assistent (Claude, ChatGPT, Copilot, Gemini en elke andere MCP-client): zie AI-assistenten (MCP).
- Zapier (geen code): verbind InterMIND eenmalig met een API-sleutel en bouw vervolgens Zaps op de Meeting Recap Ready trigger en de Create Meeting Link actie. Dezelfde integratie werkt ook vanuit Make, n8n of Pipedream via hun algemene webhook- en HTTP-modules, met behulp van de onderstaande API.
- De API (voor ontwikkelaars): een persoonlijke sleutel, één webhook-event en een tiental endpoints — meetings, recaps, transcripties, kanalen, documenten.
Beschikbaar op: elk geregistreerd account. Gasten kunnen geen sleutels aanmaken. Waar: Integrations → API keys.
API keys
- Open Integrations en zoek de API keys kaart.
- Klik op Create key, geef het een label (de tool die het zal gebruiken, bijv. "Zapier") en kopieer de sleutel. Het begint met
imk_en wordt één keer getoond — InterMIND slaat alleen een hash op. - Trek een sleutel in vanaf dezelfde kaart op elk moment. Webhook-abonnementen die met die sleutel zijn aangemaakt, stoppen onmiddellijk.
Maximaal 10 sleutels per account. Stuur de sleutel als een bearer-token:
Authorization: Bearer imk_…
Sleutels werken alleen op de /api/v1 endpoints hieronder; ze geven nooit toegang tot de eigen API van de webapplicatie.
Zapier
- Voeg in Zapier de InterMIND app toe aan een Zap en plak je API-sleutel wanneer hierom wordt gevraagd. De verbinding wordt gelabeld met je account-e-mailadres.
- Trigger Meeting Recap Ready — vuurt één keer per voltooide meeting die je hebt gehost, zodra de samenvatting bestaat. Velden: meetingtitel en link, recap-link, transcriptielink, de samenvatting in Markdown, taal van de samenvatting, begin- en eindtijd, deelnemers (naam, e-mailadres), host.
- Actie Create Meeting Link — maakt een ad-hoc meeting aan waarvan jij de eigenaar bent en retourneert de URL. Plaats het in een CRM-deal, een supportticket of een agenduitnodiging; iedereen die de link opent, klopt aan en je keurt ze goed in de room.
Typische Zaps: recap → nieuwe notitie op de HubSpot-deal; recap → interne reactie op het Zendesk-ticket; recap → rij in Google Sheets; nieuwe Pipedrive-deal → meeting-link teruggestuurd naar de deal.
Endpoints
Basis-URL: https://intermind.com/api/v1. Alle reacties zijn JSON. Machineleesbaar contract (OpenAPI 3.1, voor Make, n8n, Pipedream en AI-agents): https://intermind.com/api/v1/openapi.json.
| Method | Path | Doel |
|---|---|---|
GET | /me | Wie de sleutel bezit: { id, email, name } |
POST | /meetings | Maak een ad-hoc meeting-link aan. Body { "title": "…" } (optioneel). Retourneert 201 { id, url, title, created_at }. Met starts_at (YYYY-MM-DDTHH:mm), time_zone, optioneel duration_min en invitees, wordt de meeting ook naar je verbonden agenda geschreven; het antwoord voegt het tijdvenster en calendar: created / not_connected / failed toe |
GET | /meetings?kind=recent|upcoming&type=&limit=10 | Meetings die je host of bijwoont: recent op basis van laatste activiteit, upcoming gepland in de toekomst |
GET | /meetings/{id}/transcript?session=&max_chars=60000 | Laatste voltooide transcriptie als Markdown per spreker, in de gesproken taal (of jouw gecachte vertaling); truncated indien afgekapt |
GET | /recaps?limit=3 | Jouw nieuwste recaps (1–10), nieuwste eerst, in de vorm van de webhook-payload |
GET | /recaps/search?q=&limit=5 | Recaps waarvan de titel of huidige samenvatting de woorden noemt (woordvormen komen overeen), met een gemarkeerd fragment en links |
GET | /channels?limit=20 | Teamchats en inboxen waar je bij hoort |
GET | /channels/{id}/messages?limit=50&before= | Eén pagina van een kanaal-chat, oudste eerst, met de gecachte vertaling naar jouw chat-taal wanneer de room er een heeft gemaakt |
POST | /channels/{id}/messages | Plaats { "text": "…" } als jij → 201 { id, sent_at, text }; live uitgerold en vertaald voor elke lezer |
GET | /documents?meeting_id=&limit=50 | Bestanden die in jouw meetings zijn gedeeld — uploads en gekoppelde Drive / OneDrive-bestanden |
GET | /webhooks | Jouw webhook-abonnementen |
POST | /webhooks | Abonneer: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | Uitschrijven → 204 |
Een sleutel draagt de rechten waarmee deze is aangemaakt: sleutels aangemaakt voor september 2026 openen alleen /me, POST /meetings, /recaps en /webhooks — de nieuwere endpoints geven 403 totdat je een nieuwe sleutel aanmaakt (of de app opnieuw verbindt). Lezen is beperkt tot meetings die je host of bijwoont: het id van een andere meeting geeft 404.
Limieten: 10 sleutels en 20 webhook-abonnementen per account. target_url moet https:// zijn en openbaar bereikbaar — privé-netwerkadressen worden geweigerd.
Webhook: recap.ready
Verzonden als POST JSON naar elke geabonneerde target_url op het moment dat een recap voor een meeting die je hebt gehost wordt voltooid met een niet-lege samenvatting. Het wordt één keer per meeting-sessie verzonden. Headers:
| Header | Waarde |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | Uniek id van dit event (<meeting id>.<session id>) — ontdubbel hierop |
X-InterMIND-Signature | sha256=<HMAC-SHA256 van de ruwe body met het secret van het abonnement> |
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" }
}
Bezorgingsregels: je endpoint moet binnen 8 seconden antwoorden met 2xx. Bij een netwerkfout, 5xx of 429 wordt direct één keer opnieuw geprobeerd. Een 410 of 404 verwijdert het abonnement. Elke andere fout wordt gelogd en het event wordt niet opnieuw verzonden — de recap-e-mail en de recap-pagina blijven het duurzame archief. Recap- en transcriptie-links openen voor meeting-deelnemers die zijn ingelogd.