API a webhooky

1. V MeetingIQ vytvořte API token v Einstellungen → API & Webhooks (Nastavení → API a webhooky). Z bezpečnostních důvodů se zobrazí jen jednou.
2. Buď se dotazujte na REST API, nebo zadejte URL webhooku, na kterou vám pošleme každou dokončenou schůzku.
3. Hotovo. Pro Make, Zapier nebo n8n stačí URL webhooku, kterou tam vygenerujete.

Všechny endpointy jsou jen pro čtení, vracejí JSON a očekávají token v hlavičceAuthorization: Bearer miq_…Limit: 120 požadavků za minutu na token.

Příklad

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

Odpověď

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

Jakmile je schůzka plně zpracována, pošleme kompletní výsledek metodou POST na vaši URL, ve stejné struktuře jako API. Neúspěšná doručení se automaticky opakují a každé doručení si i s jeho stavem můžete prohlédnout v rozhraní.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (ID tohoto doručení)
X-MeetingIQ-Signature: sha256=…         (HMAC přes surové tělo požadavku)

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

Ověření 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"])
);

Nepotřebujete k tomu žádnou další integraci. Všechny tři přijímají obecný příchozí webhook:

• Make: vytvořte modul „Custom Webhook“ a zkopírujte vygenerovanou URL.
• Zapier: „Webhooks by Zapier“ → spouštěč „Catch Hook“.
• n8n: uzel Webhook, použijte produkční URL.

URL zadejte v MeetingIQ v Einstellungen → API & Webhooks (Nastavení → API a webhooky). Kliknutím na „Testen“ (Test) se okamžitě odešle testovací doručení, takže mapování polí můžete sestavit, aniž byste čekali na další schůzku.

Zpracování a ukládání probíhá výhradně v EU. Tokeny ukládáme pouze jako hash, lze je kdykoli zneplatnit a každé doručení webhooku je podepsané. Přístupy přes API jsou dohledatelné v auditním logu. Podrobnosti najdete v našem centru ochrany osobních údajů a ve zpracovatelské smlouvě (obojí v němčině).