API in Zapier
API in Zapier
Vsak povzetek, ki ga ustvari InterMIND, lahko pristane v orodju, v katerem delate: v vašem CRM-ju, sistemu za podporo uporabnikom, orodju za naloge ali preglednici. Nihče ga ne mora kopirati ročno. Tri poti:
- Vaš AI-pomočnik (Claude, ChatGPT, Copilot, Gemini in kateri koli drug odjemalec MCP): glejte AI-pomočniki (MCP).
- Zapier (brez kode): InterMIND povežete enkrat s ključem API, nato pa gradite Zaps na sprožilcu Meeting Recap Ready in dejanju Create Meeting Link. Ista integracija deluje tudi v orodjih Make, n8n ali Pipedream prek njihovih splošnih modulov webhook in HTTP, pri čemer uporabite spodnji API.
- API (za razvijalce): osebni ključ, en dogodek webhook in ducat končnih točk: sestanki, povzetki, prepisi, kanali, dokumenti.
Na voljo: vsak registriran račun. Gostje ne morejo ustvarjati ključev. Kje: Integrations → API keys.
Ključi API
- Odprite Integrations in poiščite kartico API keys.
- Kliknite Create key, ključu dodelite oznako (orodje, ki ga bo uporabljalo, npr. »Zapier«) in ga kopirajte. Začne se z
imk_in je prikazan le enkrat, saj InterMIND shrani samo zgoščeno vrednost (hash). - Ključ lahko kadar koli prekličete na isti kartici. Naročnine na webhook, ustvarjene s tem ključem, se takoj ustavijo.
Na račun je mogoče ustvariti do 10 ključev. Ključ pošljite kot žeton nosilca (bearer token):
Authorization: Bearer imk_…
Ključi delujejo samo na spodnjih končnih točkah /api/v1; nikoli ne omogočajo dostopa do lastnega API-ja spletne aplikacije.
Zapier
- V Zapierju dodajte aplikacijo InterMIND v Zap in ob pozivu prilepite svoj ključ API. Povezava je označena z e-poštnim naslovom vašega računa.
- Sprožilec Meeting Recap Ready se sproži enkrat za vsak zaključen sestanek, ki ste ga gostili, takoj ko povzetek obstaja. Polja: naslov in povezava sestanka, povezava do povzetka, povezava do prepisa, povzetek v obliki Markdown, jezik povzetka, čas začetka in konca, udeleženci (ime, e-pošta), gostitelj.
- Dejanje Create Meeting Link ustvari ad hoc sestanek, ki je vaš, in vrne njegov URL. Vstavite ga v posel v CRM-ju, prijavo v sistemu za podporo ali vabilo v koledarju; vsak, ki odpre povezavo, potrka, vi pa ga v sobi odobrite.
Tipični Zapi: povzetek → nova beležka pri poslu v HubSpotu; povzetek → interni komentar pri prijavi v Zendesku; povzetek → vrstica v Google Sheets; nov posel v Pipedrive → povezava do sestanka, zapisana nazaj v posel.
Končne točke
Osnovni URL: https://intermind.com/api/v1. Vsi odgovori so v obliki JSON. Strojno berljiva pogodba (OpenAPI 3.1, za Make, n8n, Pipedream in AI-agente): https://intermind.com/api/v1/openapi.json.
| Metoda | Pot | Namen |
|---|---|---|
GET | /me | Kdo je lastnik ključa: { id, email, name } |
POST | /meetings | Ustvari ad hoc povezavo do sestanka. Telo { "title": "…" } (neobvezno). Vrne 201 { id, url, title, created_at }. Če podate starts_at (YYYY-MM-DDTHH:mm), time_zone, neobvezno duration_min in invitees, se sestanek zapiše tudi v vaš povezani koledar; odgovor doda časovno okno in calendar: created / not_connected / failed |
GET | /meetings?kind=recent|upcoming&type=&limit=10 | Sestanki, ki jih gostite ali se jih udeležujete: recent po zadnji dejavnosti, upcoming načrtovani v prihodnosti |
GET | /meetings/{id}/transcript?session=&max_chars=60000 | Zadnji dokončani prepis kot Markdown po govorcih, v govorjenem jeziku (ali vaš predpomnjeni prevod); truncated, kadar je prirezan |
GET | /recaps?limit=3 | Vaši najnovejši povzetki (1–10), najnovejši prvi, v obliki vsebine webhooka |
GET | /recaps/search?q=&limit=5 | Povzetki, katerih naslov ali trenutna vsebina omenja iskane besede (ujemajo se tudi besedne oblike), z označenim izsekom in povezavami |
GET | /channels?limit=20 | Skupinski klepeti in nabiralniki, katerih član ste |
GET | /channels/{id}/messages?limit=50&before= | Ena stran klepeta kanala, najstarejša najprej, s predpomnjenim prevodom v vaš jezik klepeta, kadar ga je soba ustvarila |
POST | /channels/{id}/messages | Objavi { "text": "…" } v vašem imenu → 201 { id, sent_at, text }; razposlano sproti in prevedeno za vsakega bralca |
GET | /documents?meeting_id=&limit=50 | Datoteke, deljene na vaših sestankih: naložene in povezane datoteke iz Drive / OneDrive |
GET | /webhooks | Vaše naročnine na webhook |
POST | /webhooks | Naročitev: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | Odjava → 204 |
Ključ ima pravice, s katerimi je bil ustvarjen: ključi, ustvarjeni pred septembrom 2026, odprejo samo /me, POST /meetings, /recaps in /webhooks; novejše končne točke odgovorijo s 403, dokler ne ustvarite novega ključa (ali ponovno povežete aplikacije). Branje je omejeno na sestanke, ki jih gostite ali se jih udeležujete: id drugega sestanka odgovori s 404.
Omejitve: 10 ključev in 20 naročnin na webhook na račun. target_url mora biti https:// in javno dosegljiv; naslovi zasebnega omrežja so zavrnjeni.
Webhook: recap.ready
Pošlje se kot POST JSON na vsak naročen target_url v trenutku, ko je povzetek sestanka, ki ste ga gostili, dokončan in ima neprazno vsebino. Pošlje se enkrat na sejo sestanka. Glave:
| Glava | Vrednost |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | Enolični id tega dogodka (<meeting id>.<session id>): po njem odstranite dvojnike |
X-InterMIND-Signature | sha256=<HMAC-SHA256 surovega telesa s skrivnostjo naročnine> |
User-Agent | InterMIND-Webhooks/1 |
Vsebina:
{
"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" }
}
Pravila dostave: vaša končna točka naj odgovori z 2xx v 8 sekundah. Omrežna napaka, 5xx ali 429 se takoj ponovi enkrat. Odgovor 410 ali 404 izbriše naročnino. Vsaka druga napaka se zabeleži in dogodek se ne pošlje znova; trajen zapis ostaneta e-pošta s povzetkom in stran s povzetkom. Povezave do povzetka in prepisa se odprejo za udeležence sestanka, ki so prijavljeni.