API és Zapier
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.
API-kulcsok
- Nyissa meg az Integrations oldalt, és keresse meg az API keys kártyát.
- 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. - 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
- 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.
- 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.
- 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.
| Method | Path | Purpose |
|---|---|---|
GET | /me | Kié a kulcs: { id, email, name } |
POST | /meetings | Ad 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=10 | Az Ö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=60000 | A 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=3 | Az Ön legújabb összefoglalói (1–10), a legújabb elöl, a webhook-adatcsomag szerkezetében |
GET | /recaps/search?q=&limit=5 | Azok 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=20 | Azok 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=50 | Az Ön megbeszélésein megosztott fájlok – feltöltések és hivatkozott Drive / OneDrive fájlok |
GET | /webhooks | Az Ön webhook-feliratkozásai |
POST | /webhooks | Feliratkozá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:
| Header | Value |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | Az esemény egyedi azonosítója (<meeting id>.<session id>) – ez alapján szűrje ki a duplikátumokat |
X-InterMIND-Signature | sha256=<a nyers törzs HMAC-SHA256 értéke a feliratkozás titkos kulcsával> |
User-Agent | InterMIND-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.
Telegram
Továbbítsa az üzeneteket az InterMIND botnak, tükrözze a Telegram-csoportokat csatornákba, és irányítsa a csevegéseket a Beérkező üzenetek mappába.
E-mail a csatornába
Add meg a csatornád e-mail-címét bármely szolgáltatásnak, és az üzenetei megérkeznek a csatornába – a mellékletekkel együtt, így minden tag a saját nyelvén olvashatja őket.