API i Zapier

Wysyłaj podsumowania spotkań do swojego CRM, systemu obsługi lub arkusza kalkulacyjnego za pomocą Zapier lub wywołaj API InterMIND bezpośrednio za pomocą osobistego klucza API.

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.

Podsumowania trafiają również do każdego narzędzia posiadającego przychodzący adres e-mail — dodaj go jako odbiorcę kopii podsumowania w spotkaniu lub kanale, nie jest wymagana żadna integracja. Zobacz Kopia podsumowania.

Klucze API

  1. Otwórz Integrations i znajdź kartę API keys.
  2. 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).
  3. 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

  1. 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.
  2. 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.
  3. 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.

MethodPathPurpose
GET/meWłaściciel klucza: { id, email, name }
POST/meetingsTworzy 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=10Spotkania, 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=60000Najnowsza 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=3Twoje najnowsze podsumowania (1–10), od najnowszych, w formacie ładunku webhook
GET/recaps/search?q=&limit=5Podsumowania, których tytuł lub bieżące podsumowanie zawierają słowa (dopasowanie form wyrazowych), wraz z wyróżnionym fragmentem i linkami
GET/channels?limit=20Czaty 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}/messagesOpublikuj { "text": "…" } jako Ty → 201 { id, sent_at, text }; rozesłane na żywo i przetłumaczone dla każdego czytelnika
GET/documents?meeting_id=&limit=50Pliki udostępnione na Twoich spotkaniach — pliki przesłane i połączone z Drive / OneDrive
GET/webhooksTwoje subskrypcje webhook
POST/webhooksSubskrybuj: { "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:

HeaderValue
X-InterMIND-Eventrecap.ready
X-InterMIND-DeliveryUnikalny identyfikator tego zdarzenia (<meeting id>.<session id>) — deduplikuj na jego podstawie
X-InterMIND-Signaturesha256=<HMAC-SHA256 nieprzetworzonej treści (raw body) z użyciem sekretu subskrypcji>
User-AgentInterMIND-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.