API a webhooky

1. V MeetingIQ si vytvorte API token v časti Einstellungen → API & Webhooks (Nastavenia → API a webhooky). Z bezpečnostných dôvodov sa zobrazí iba raz.
2. Buď sa dopytujte na REST API, alebo zadajte URL webhooku, na ktorú pošleme každé dokončené stretnutie.
3. Hotovo. Pre Make, Zapier alebo n8n stačí URL webhooku, ktorá sa tam vygeneruje.

Všetky endpointy sú len na čítanie, vracajú JSON a očakávajú token v hlavičkeAuthorization: Bearer miq_…Limit: 120 požiadaviek za minútu na token.

Príklad

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

Odpoveď

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

Hneď ako je stretnutie úplne spracované, pošleme kompletný výsledok na vašu URL metódou POST, v rovnakej štruktúre ako API. Neúspešné doručenia sa automaticky opakujú a každé doručenie si v rozhraní môžete pozrieť aj s jeho stavom.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (ID tohto doručenia)
X-MeetingIQ-Signature: sha256=…         (HMAC nad surovým telom požiadavky)

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

Overenie 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"])
);

Nepotrebujete na to ďalšiu integráciu. Všetky tri prijímajú všeobecný prichádzajúci webhook:

• Make: vytvorte modul „Custom Webhook“ a skopírujte vygenerovanú URL.
• Zapier: „Webhooks by Zapier“ → spúšťač „Catch Hook“.
• n8n: uzol Webhook, použite produkčnú URL.

URL zadajte v MeetingIQ v časti Einstellungen → API & Webhooks (Nastavenia → API a webhooky). Kliknutím na „Testen“ (Otestovať) hneď odošlete testovacie doručenie, takže si mapovanie polí môžete pripraviť bez čakania na ďalšie stretnutie.

Spracúvanie a ukladanie prebieha výlučne v EÚ. Tokeny sa ukladajú iba ako hash, dajú sa kedykoľvek zrušiť a každé doručenie webhooku je podpísané. Prístupy cez API sú dohľadateľné v auditnom logu. Podrobnosti nájdete v našom centre ochrany súkromia a v zmluve o spracúvaní osobných údajov (oboje v nemčine).