API i Zapier
API i Zapier
Każde podsumowanie wygenerowane przez InterMIND może trafić do narzędzia, w którym pracujesz — Twojego systemu CRM, help desku, systemu śledzenia zadań lub arkusza kalkulacyjnego — bez ręcznego kopiowania. Dostępne są dwie ścieżki:
- 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, korzystając z poniższego API.
- API (dla deweloperów): osobisty klucz, jedno zdarzenie webhook i trzy punkty końcowe.
Dostępne w: każdym zarejestrowanym koncie. Goście nie mogą tworzyć kluczy. Gdzie: Ustawienia → Klucze API.
Klucze API
- Otwórz Ustawienia i znajdź kartę Klucze API.
- Kliknij Utwórz klucz, nadaj mu etykietę (narzędzie, które będzie go używać, np. "Zapier") i skopiuj klucz. Zaczyna się od
imk_i jest pokazywany tylko raz — InterMIND przechowuje jedynie hash. - Odwołaj klucz z tej samej karty w dowolnym momencie. Subskrypcje webhook utworzone za pomocą tego klucza natychmiast przestają działać.
Maksymalnie 10 kluczy na konto. Wyślij klucz jako token Bearer:
Authorization: Bearer imk_…
Klucze działają tylko na poniższych punktach końcowych /api/v1; nie dają one 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 — uruchamiany raz na każde zakończone spotkanie, które poprowadziłeś, gdy tylko powstanie podsumowanie. Pola: tytuł i link spotkania, link do podsumowania, link do transkrypcji, podsumowanie w formacie 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 adres URL. Umieść go w ofercie CRM, zgłoszeniu wsparcia lub zaproszeniu w kalendarzu; każda osoba otwierająca link puka, a Ty wpuszczasz ją do pokoju.
Typowe Zapy: podsumowanie → nowa notatka w ofercie HubSpot; podsumowanie → wewnętrzny komentarz w zgłoszeniu Zendesk; podsumowanie → wiersz w Google Sheets; nowa oferta Pipedrive → link do spotkania wpisany z powrotem do oferty.
Punkty końcowe
Adres bazowy: https://intermind.com/api/v1. Wszystkie odpowiedzi są w formacie JSON. Kontrakt czytelny maszynowo (OpenAPI 3.1, dla Make, n8n, Pipedream i agentów AI): https://intermind.com/api/v1/openapi.json.
| Metoda | Ścieżka | Cel |
|---|---|---|
GET | /me | Właściciel klucza: { id, email, name } |
POST | /meetings | Tworzy link do spotkania ad-hoc. Treść { "title": "…" } (opcjonalne). Zwraca 201 { id, url, title, created_at } |
GET | /recaps?limit=3 | Twoje najnowsze podsumowania (1–10), najnowsze jako pierwsze, w strukturze ładunku webhook |
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 |
Limity: 10 kluczy i 20 subskrypcji webhook na konto. target_url musi używać https:// i być publicznie dostępny — prywatne adresy sieciowe są odrzucane.
Webhook: recap.ready
Wysyłany jako POST JSON do każdego zasubskrybowanego target_url w momencie, gdy podsumowanie spotkania, które poprowadziłeś, zostanie sfinalizowane z niepustym podsumowaniem. Jest wysyłany raz na sesję spotkania. Nagłówki:
| Nagłówek | Wartość |
|---|---|
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 z użyciem tajnego klucza subskrypcji> |
User-Agent | InterMIND-Webhooks/1 |
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 punkt końcowy powinien odpowiedzieć 2xx w ciągu 8 sekund. Błąd sieciowy, 5xx lub 429 jest ponawiany natychmiast jeden raz. Błąd 410 lub 404 usuwa subskrypcję. Każdy inny błąd jest rejestrowany, a zdarzenie nie jest wysyłane ponownie — e-mail z podsumowaniem i 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, odzwierciedlaj grupy Telegram w kanałach i kieruj czaty do 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.