API i Zapier
API i Zapier
Każde podsumowanie wygenerowane przez InterMIND może trafić do narzędzia, w którym pracujesz — Twojego CRM-u, serwisu pomocy, trackera zadań czy arkusza kalkulacyjnego — bez ręcznego kopiowania. Trzy metody integracji:
- Twój asystent AI (Claude, ChatGPT, Copilot, Gemini i dowolny inny klient MCP): zobacz Asystenci AI (MCP).
- Zapier (bez kodowania): połącz InterMIND raz za pomocą klucza API, a następnie twórz Zapy na podstawie wyzwalacza Meeting Recap Ready i akcji Create Meeting Link. Ta sama integracja działa również z Make, n8n lub Pipedream za pośrednictwem ich ogólnych modułów webhook i HTTP, przy użyciu poniższego API.
- API (dla deweloperów): osobisty klucz, jedno zdarzenie webhook i kilkanaście endpointów — spotkania, podsumowania, transkrypcje, kanały, dokumenty.
Dostępne dla: każdego zarejestrowanego konta. Goście nie mogą tworzyć kluczy. Gdzie: Integrations → API keys.
Klucze API
- Otwórz Integrations i znajdź kartę API keys.
- Kliknij Create key, nadaj mu etykietę (narzędzie, które będzie go używać, np. „Zapier”) i skopiuj klucz. Zaczyna się od
imk_i jest wyświetlany tylko raz — InterMIND przechowuje jedynie skrót (hash). - Odwołaj klucz z tej samej karty w dowolnym momencie. Subskrypcje webhook utworzone za pomocą tego klucza zostaną natychmiast zatrzymane.
Maksymalnie 10 kluczy na konto. Wyślij klucz jako token Bearer:
Authorization: Bearer imk_…
Klucze działają tylko na poniższych endpointach /api/v1; nigdy nie dają dostępu do własnego API aplikacji internetowej.
Zapier
- W Zapier dodaj aplikację InterMIND do Zapa i wklej swój klucz API, gdy zostaniesz o to poproszony. Połączenie jest oznaczane adresem e-mail Twojego konta.
- Wyzwalacz Meeting Recap Ready — uruchamia się raz na każde zakończone spotkanie, które poprowadziłeś, gdy tylko podsumowanie będzie gotowe. Pola: tytuł i link spotkania, link do podsumowania, link do transkrypcji, podsumowanie w Markdown, język podsumowania, czas rozpoczęcia i zakończenia, uczestnicy (imię i nazwisko, e-mail), gospodarz.
- Akcja Create Meeting Link — tworzy spotkanie ad-hoc, którego jesteś właścicielem, i zwraca jego URL. Umieść go w ofercie CRM, zgłoszeniu do pomocy technicznej lub w zaproszeniu w kalendarzu; każdy, kto otworzy link, „puka”, a Ty wpuszczasz go do pokoju.
Typowe Zapy: podsumowanie → nowa notatka na ofercie w HubSpot; podsumowanie → wewnętrzny komentarz w zgłoszeniu Zendesk; podsumowanie → wiersz w Google Sheets; nowa oferta w Pipedrive → link do spotkania zapisany z powrotem w ofercie.
Endpointy
Bazowy URL: https://intermind.com/api/v1. Wszystkie odpowiedzi to JSON. Kontrakt czytelny dla maszyny (OpenAPI 3.1, dla Make, n8n, Pipedream i agentów AI): https://intermind.com/api/v1/openapi.json.
| Method | Path | Purpose |
|---|---|---|
GET | /me | Właściciel klucza: { id, email, name } |
POST | /meetings | Tworzy link do spotkania ad-hoc. Treść { "title": "…" } (opcjonalnie). Zwraca 201 { id, url, title, created_at }. Z parametrami starts_at (YYYY-MM-DDTHH:mm), time_zone, opcjonalnymi duration_min i invitees, spotkanie jest również zapisywane w Twoim połączonym kalendarzu; odpowiedź dodaje okno czasowe i calendar: created / not_connected / failed |
GET | /meetings?kind=recent|upcoming&type=&limit=10 | Spotkania, które hostujesz lub w których uczestniczysz: recent według ostatniej aktywności, upcoming zaplanowane na przyszłość |
GET | /meetings/{id}/transcript?session=&max_chars=60000 | Najnowsza sfinalizowana transkrypcja jako Markdown według mówcy, w mówionym języku (lub Twojej zbuforowanej translacji); truncated, gdy zostanie obcięta |
GET | /recaps?limit=3 | Twoje najnowsze podsumowania (1–10), od najnowszych, w formacie ładunku webhook |
GET | /recaps/search?q=&limit=5 | Podsumowania, których tytuł lub bieżące podsumowanie zawierają słowa (dopasowanie form wyrazowych), wraz z wyróżnionym fragmentem i linkami |
GET | /channels?limit=20 | Czaty zespołowe i skrzynki odbiorcze, do których należysz |
GET | /channels/{id}/messages?limit=50&before= | Jedna strona czatu kanału, od najstarszych, z zbuforowaną translacją na Twój język czatu, jeśli pokój taką wygenerował |
POST | /channels/{id}/messages | Opublikuj { "text": "…" } jako Ty → 201 { id, sent_at, text }; rozesłane na żywo i przetłumaczone dla każdego czytelnika |
GET | /documents?meeting_id=&limit=50 | Pliki udostępnione na Twoich spotkaniach — pliki przesłane i połączone z Drive / OneDrive |
GET | /webhooks | Twoje subskrypcje webhook |
POST | /webhooks | Subskrybuj: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | Anuluj subskrypcję → 204 |
Klucz ma uprawnienia, z którymi został utworzony: klucze utworzone przed wrześniem 2026 r. otwierają tylko /me, POST /meetings, /recaps i /webhooks — nowsze endpointy zwracają 403, dopóki nie utworzysz nowego klucza (lub ponownie podłączysz aplikację). Odczyt jest ograniczony do spotkań, które hostujesz lub w których uczestniczysz: identyfikator innego spotkania zwraca 404.
Limity: 10 kluczy i 20 subskrypcji webhook na konto. target_url musi używać protokołu https:// i być publicznie osiągalny — prywatne adresy sieciowe są odrzucane.
Webhook: recap.ready
Wysyłane jako POST w formacie JSON do każdego zasubskrybowanego target_url w momencie, gdy podsumowanie dla spotkania, które poprowadziłeś, zostanie sfinalizowane z niepustym podsumowaniem. Jest wysyłane raz na sesję spotkania. Nagłówki:
| Header | Value |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | Unikalny identyfikator tego zdarzenia (<meeting id>.<session id>) — deduplikuj na jego podstawie |
X-InterMIND-Signature | sha256=<HMAC-SHA256 nieprzetworzonej treści (raw body) z użyciem sekretu subskrypcji> |
User-Agent | InterMIND-Webhooks/1 |
Ładunek (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" }
}
Zasady dostarczania: Twój endpoint powinien odpowiedzieć kodem 2xx w ciągu 8 sekund. W przypadku błędu sieci, błędu 5xx lub 429, następuje natychmiastowe jednorazowe ponowienie próby. Kod 410 lub 404 usuwa subskrypcję. Każdy inny błąd jest rejestrowany, a zdarzenie nie jest ponownie wysyłane — e-mail z podsumowaniem oraz strona podsumowania pozostają trwałym zapisem. Linki do podsumowania i transkrypcji otwierają się dla zalogowanych uczestników spotkania.
Telegram
Przekazuj wiadomości do bota InterMIND, klonuj grupy Telegram w kanały i kieruj czaty do swojej skrzynki odbiorczej.
E-mail do kanału
Przekaż dowolnej usłudze adres e-mail kanału, a jej wiadomości trafią do kanału — z zachowanymi załącznikami, czytane przez każdego członka w jego własnym języku.