API és webhookok

1. A MeetingIQ-ban hozzon létre egy API-tokent az Einstellungen → API & Webhooks (Beállítások → API és webhookok) menüpontban. Biztonsági okokból csak egyszer jelenik meg.
2. Kérdezze le a REST API-t, vagy adjon meg egy webhook-URL-t, amelyre minden elkészült megbeszélést elküldünk.
3. Kész. Make, Zapier vagy n8n esetén elég az ott generált webhook-URL.

Minden végpont csak olvasható, JSON-t ad vissza, és a tokent a fejlécben várjaAuthorization: Bearer miq_…Korlát: tokenenként percenként 120 kérés.

Példa

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

Válasz

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

Amint egy megbeszélés feldolgozása teljesen elkészült, a teljes eredményt POST-kéréssel elküldjük az Ön URL-jére, ugyanabban a struktúrában, mint az API-ban. A sikertelen kézbesítéseket automatikusan újrapróbáljuk, és minden kézbesítés az állapotával együtt megtekinthető a felületen.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (A kézbesítés azonosítója)
X-MeetingIQ-Signature: sha256=…         (HMAC a nyers törzsre)

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

Az aláírás ellenőrzése (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"])
);

Ehhez nincs szükség külön integrációra. Mindhárom fogad általános bejövő webhookot:

• Make: hozzon létre egy „Custom Webhook” modult, és másolja ki a generált URL-t.
• Zapier: „Webhooks by Zapier” → „Catch Hook” trigger.
• n8n: Webhook csomópont, a Production URL-t használja.

Az URL-t a MeetingIQ-ban az Einstellungen → API & Webhooks (Beállítások → API és webhookok) menüpontban adja meg. A „Testen” (Tesztelés) gombra kattintva azonnal kap egy próbakézbesítést, így a mezők megfeleltetését úgy építheti fel, hogy nem kell a következő megbeszélésre várnia.

A feldolgozás és a tárolás kizárólag az EU-ban történik. A tokeneket csak hash formájában tároljuk, bármikor visszavonhatók, és minden webhook-kézbesítés alá van írva. Az API-n keresztüli lekérések az auditnaplóban nyomon követhetők. A részleteket az adatvédelmi központunkban és az adatfeldolgozási szerződésben találja (mindkettő német nyelvű).