API i webhookovi

1. U MeetingIQ-u izradite API token pod Einstellungen → API & Webhooks (Postavke → API i webhookovi). Iz sigurnosnih razloga prikazuje se samo jednom.
2. Šaljite upite REST API-ju ili unesite URL webhooka na koji ćemo slati svaki dovršeni sastanak.
3. Gotovo. Za Make, Zapier ili n8n dovoljan je URL webhooka koji se ondje generira.

Sve krajnje točke služe samo za čitanje, vraćaju JSON i očekuju token u zaglavljuAuthorization: Bearer miq_…Ograničenje: 120 zahtjeva u minuti po tokenu.

Primjer

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

Odgovor

{
  "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": "…" }
  }
}

Čim je sastanak u potpunosti obrađen, cjelokupni rezultat šaljemo na vaš URL metodom POST, u istoj strukturi kao i API. Neuspjele isporuke automatski se ponavljaju, a svaku isporuku s njezinim statusom možete pregledati u sučelju.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (ID ove isporuke)
X-MeetingIQ-Signature: sha256=…         (HMAC izračunat nad neobrađenim tijelom zahtjeva)

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

Provjera potpisa (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"])
);

Za to vam nije potrebna dodatna integracija. Sva tri alata prihvaćaju generički dolazni webhook:

• Make: izradite modul „Custom Webhook” i kopirajte generirani URL.
• Zapier: „Webhooks by Zapier” → okidač „Catch Hook”.
• n8n: čvor Webhook, koristite produkcijski URL.

Unesite URL u MeetingIQ-u pod Einstellungen → API & Webhooks (Postavke → API i webhookovi). Klikom na „Testen” (Testiraj) odmah se šalje probna isporuka, pa mapiranje polja možete izraditi bez čekanja na sljedeći sastanak.

Obrada i pohrana odvijaju se isključivo u EU-u. Tokeni se pohranjuju samo kao hash, mogu se opozvati u bilo kojem trenutku, a svaka isporuka webhooka je potpisana. Dohvaćanje putem API-ja može se pratiti u revizijskom dnevniku. Pojedinosti su u našem centru za privatnost i ugovoru o obradi podataka (oboje na njemačkom).