API és Zapier

Küldje el a meeting-összefoglalókat CRM-be, ügyfélszolgálati rendszerbe vagy táblázatba a Zapier segítségével, vagy hívja közvetlenül az InterMIND API-t személyes API-kulccsal.

API és Zapier

Az InterMIND minden összefoglalója megérkezhet abba az eszközbe, amelyben Ön dolgozik – CRM-be, ügyfélszolgálati rendszerbe, feladatkezelőbe vagy táblázatba –, anélkül, hogy bárkinek kézzel kellene másolnia. Három módon kapcsolódhat:

  • Az Ön AI-asszisztense (Claude, ChatGPT, Copilot, Gemini és bármely más MCP-kliens): lásd AI-asszisztensek (MCP).
  • Zapier (kód nélkül): kapcsolja össze az InterMIND-ot egyszer egy API-kulccsal, majd építsen Zapeket a Meeting Recap Ready eseményindítóra és a Create Meeting Link műveletre. Ugyanez az integráció Make-ből, n8n-ből vagy Pipedreamből is működik az általános webhook- és HTTP-moduljaikon keresztül, az alább ismertetett API használatával.
  • Az API (fejlesztőknek): személyes kulcs, egy webhook-esemény és egy tucat végpont – megbeszélések, összefoglalók, átiratok, csatornák, dokumentumok.

Elérhető: minden regisztrált fiókhoz. A vendégek nem hozhatnak létre kulcsot. Hol: Integrations → API keys.

Az összefoglalók minden olyan eszközhöz is eljutnak, amelynek van bejövő e-mail-címe – adja hozzá az összefoglaló másolatának címzettjeként a megbeszélésnél vagy a csatornán, integráció nélkül. Lásd: Az összefoglaló másolata.

API-kulcsok

  1. Nyissa meg az Integrations oldalt, és keresse meg az API keys kártyát.
  2. Kattintson a Create key gombra, adjon a kulcsnak címkét (az eszköz neve, amely használni fogja, pl. „Zapier"), majd másolja ki a kulcsot. A kulcs imk_ előtaggal kezdődik, és csak egyszer jelenik meg – az InterMIND kizárólag a hash-ét tárolja.
  3. A kulcsot ugyanezen a kártyán bármikor visszavonhatja. Az adott kulccsal létrehozott webhook-feliratkozások azonnal leállnak.

Fiókonként legfeljebb 10 kulcs hozható létre. A kulcsot bearer tokenként küldje el:

Authorization: Bearer imk_…

A kulcsok csak az alábbi /api/v1 végpontokon működnek; a webalkalmazás saját API-jához soha nem adnak hozzáférést.

Zapier

  1. A Zapierben adja hozzá az InterMIND alkalmazást egy Zaphez, és kérésre illessze be az API-kulcsát. A kapcsolat az Ön fiókjának e-mail-címével lesz felcímkézve.
  2. Eseményindító: Meeting Recap Ready – megbeszélésenként egyszer aktiválódik, amelyet Ön tartott, amint elkészül az összefoglaló. Mezők: a megbeszélés címe és hivatkozása, az összefoglaló hivatkozása, az átirat hivatkozása, az összefoglaló Markdown formátumban, az összefoglaló nyelve, kezdési és befejezési időpont, résztvevők (név, e-mail-cím), házigazda.
  3. Művelet: Create Meeting Link – létrehoz egy Ön által birtokolt ad hoc megbeszélést, és visszaadja annak URL-jét. Beillesztheti CRM-ügyletbe, ügyfélszolgálati jegybe vagy naptármeghívóba; aki megnyitja a hivatkozást, bekopog, Ön pedig a teremben jóváhagyja a belépését.

Tipikus Zapek: összefoglaló → új jegyzet a HubSpot-ügyleten; összefoglaló → belső megjegyzés a Zendesk-jegyen; összefoglaló → új sor a Google Sheetsben; új Pipedrive-ügylet → a megbeszélés hivatkozása visszaíródik az ügyletbe.

Végpontok

Alap-URL: https://intermind.com/api/v1. Minden válasz JSON formátumú. Gépileg olvasható szerződés (OpenAPI 3.1, Make, n8n, Pipedream és AI-ügynökök számára): https://intermind.com/api/v1/openapi.json.

MethodPathPurpose
GET/meKié a kulcs: { id, email, name }
POST/meetingsAd hoc megbeszélés-hivatkozás létrehozása. Törzs: { "title": "…" } (opcionális). Válasz: 201 { id, url, title, created_at }. Ha megadja a starts_at (YYYY-MM-DDTHH:mm), a time_zone, valamint az opcionális duration_min és invitees mezőt, a megbeszélés a csatlakoztatott naptárába is bekerül; a válasz kiegészül az időablakkal és a calendar: created / not_connected / failed értékkel
GET/meetings?kind=recent|upcoming&type=&limit=10Az Ön által tartott vagy látogatott megbeszélések: a recent az utolsó aktivitás szerint, az upcoming a jövőre ütemezettek
GET/meetings/{id}/transcript?session=&max_chars=60000A legutóbbi véglegesített átirat Markdown formátumban, beszélők szerint, a beszélt nyelven (vagy az Ön gyorsítótárazott fordításában); levágás esetén truncated jelzéssel
GET/recaps?limit=3Az Ön legújabb összefoglalói (1–10), a legújabb elöl, a webhook-adatcsomag szerkezetében
GET/recaps/search?q=&limit=5Azok az összefoglalók, amelyek címében vagy aktuális összegzésében szerepelnek a keresett szavak (a szóalakok is egyeznek), kiemelt részlettel és hivatkozásokkal
GET/channels?limit=20Azok a csapatchatek és postaládák, amelyekhez Ön tartozik
GET/channels/{id}/messages?limit=50&before=Egy csatorna csevegésének egy oldala, a legrégebbi elöl, az Ön csevegési nyelvére készült gyorsítótárazott fordítással, ha a szoba készített ilyet
POST/channels/{id}/messages{ "text": "…" } elküldése az Ön nevében → 201 { id, sent_at, text }; élőben szétküldésre kerül, és minden olvasó számára lefordítódik
GET/documents?meeting_id=&limit=50Az Ön megbeszélésein megosztott fájlok – feltöltések és hivatkozott Drive / OneDrive fájlok
GET/webhooksAz Ön webhook-feliratkozásai
POST/webhooksFeliratkozás: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at }
DELETE/webhooks/{id}Leiratkozás → 204

A kulcs azokkal a jogosultságokkal rendelkezik, amelyekkel létrehozták: a 2026 szeptembere előtt létrehozott kulcsok csak a /me, a POST /meetings, a /recaps és a /webhooks végpontot érik el – az újabb végpontok 403 választ adnak, amíg nem hoz létre új kulcsot (vagy nem csatlakoztatja újra az alkalmazást). Az olvasás az Ön által tartott vagy látogatott megbeszélésekre korlátozódik: másik megbeszélés azonosítójára 404 a válasz.

Korlátok: fiókonként 10 kulcs és 20 webhook-feliratkozás. A target_url csak https:// lehet, és nyilvánosan elérhetőnek kell lennie – a privát hálózati címeket elutasítjuk.

Webhook: recap.ready

POST kérésként, JSON formátumban kerül elküldésre minden feliratkozott target_url címre abban a pillanatban, amikor egy Ön által tartott megbeszélés összefoglalója véglegessé válik, és az összegzés nem üres. Megbeszélés-munkamenetenként egyszer kerül elküldésre. Fejlécek:

HeaderValue
X-InterMIND-Eventrecap.ready
X-InterMIND-DeliveryAz esemény egyedi azonosítója (<meeting id>.<session id>) – ez alapján szűrje ki a duplikátumokat
X-InterMIND-Signaturesha256=<a nyers törzs HMAC-SHA256 értéke a feliratkozás titkos kulcsával>
User-AgentInterMIND-Webhooks/1

Adatcsomag:

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

Kézbesítési szabályok: a végpontnak 8 másodpercen belül 2xx választ kell adnia. Hálózati hiba, 5xx vagy 429 esetén a rendszer egyszer azonnal újrapróbálkozik. 410 vagy 404 törli a feliratkozást. Minden más hiba naplózásra kerül, és az eseményt nem küldjük el újra – az összefoglaló e-mail és az összefoglaló oldala marad a tartós nyilvántartás. Az összefoglaló- és átirat-hivatkozások a bejelentkezett megbeszélés-résztvevők számára nyílnak meg.