Dla programistów

API i webhooki

Pobieraj transkrypcje, podsumowania i zadania automatycznie do własnych systemów, przez REST API lub webhook. Bez pośrednictwa usług z USA: wszystko działa na naszej infrastrukturze w UE.

Wypróbuj za darmo przez 14 dni Zobacz cennik

W cenie od planu Pro. Dostęp do API jest włączony już w 14-dniowym okresie próbnym.

Połączenie w 3 krokach

W MeetingIQ utwórz token API w Einstellungen → API & Webhooks (Ustawienia → API i webhooki). Ze względów bezpieczeństwa jest wyświetlany tylko raz.
Odpytuj REST API albo podaj adres URL webhooka, na który wyślemy każde zakończone spotkanie.
Gotowe. W przypadku Make, Zapier lub n8n wystarczy wygenerowany tam adres URL webhooka.

REST API

Wszystkie endpointy są tylko do odczytu, zwracają JSON i oczekują tokena w nagłówkuAuthorization: Bearer miq_…Limit: 120 żądań na minutę na token.

GET/api/v1/meetingsLista z filtrowaniem według statusu

GET/api/v1/meetings/{id}Podsumowanie, kluczowe punkty, zadania

GET/api/v1/meetings/{id}/transcriptPełny tekst + segmenty mówców

Przykład

curl -H "Authorization: Bearer miq_..." \
  "https://meetingiq.de/api/v1/meetings?status=completed&limit=10"

Odpowiedź

{
  "data": {
    "id": "6165b3df-…", "title": "Jour Fixe Vertrieb", "status": "completed",
    "language": "de", "durationSec": 2984,
    "summaryShort": "…", "summary": "…",
    "keyPoints": ["…"], "decisions": ["…"],
    "participants": [{ "name": "Anna Beispiel", "email": "anna@firma.de" }],
    "tasks": [{ "title": "Angebot nachfassen", "assignee": { "name": "Anna" },
                "dueDate": null, "status": "open" }],
    "links": { "self": "…", "transcript": "…", "app": "…" }
  }
}

Webhooki

Gdy tylko spotkanie zostanie w pełni przetworzone, wysyłamy kompletny wynik na twój adres URL metodą POST, w tej samej strukturze co API. Nieudane dostarczenia są automatycznie ponawiane, a każde dostarczenie wraz ze statusem można sprawdzić w interfejsie.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (ID tego dostarczenia)
X-MeetingIQ-Signature: sha256=…         (HMAC z surowej treści żądania)

{ "event": "meeting.completed", "timestamp": "…", "data": { …Meeting… } }

Weryfikacja podpisu (Node.js)

const expected = "sha256=" + crypto
  .createHmac("sha256", SIGNING_SECRET)
  .update(rawBody)
  .digest("hex");

crypto.timingSafeEqual(
  Buffer.from(expected),
  Buffer.from(req.headers["x-meetingiq-signature"])
);

Make, Zapier i n8n

Nie potrzebujesz do tego dodatkowej integracji. Wszystkie trzy narzędzia przyjmują ogólny przychodzący webhook:

Make: utwórz moduł „Custom Webhook” i skopiuj wygenerowany adres URL.
Zapier: „Webhooks by Zapier” → wyzwalacz „Catch Hook”.
n8n: węzeł Webhook, użyj produkcyjnego adresu URL.

Wpisz adres URL w MeetingIQ w Einstellungen → API & Webhooks (Ustawienia → API i webhooki). Kliknięcie „Testen” (Testuj) od razu wysyła testowe dostarczenie, więc możesz zbudować mapowanie pól bez czekania na kolejne spotkanie.

Ochrona danych

Przetwarzanie i przechowywanie danych odbywa się wyłącznie w UE. Tokeny są przechowywane tylko jako hash, można je w każdej chwili unieważnić, a każde dostarczenie webhooka jest podpisane. Pobieranie danych przez API można prześledzić w dzienniku audytu. Szczegóły znajdziesz w naszym centrum prywatności oraz w umowie powierzenia przetwarzania danych (oba dokumenty w języku niemieckim).

Pytania dotyczące integracji?

Napisz, do jakiego systemu mają trafiać dane, a jednorazowo skonfigurujemy to razem z tobą.

Wypróbuj za darmo Skontaktuj się z nami