API in webhooki

1. V MeetingIQ ustvarite žeton API v Einstellungen → API & Webhooks (Nastavitve → API in webhooki). Iz varnostnih razlogov je prikazan samo enkrat.
2. Pošiljajte zahteve na REST API ali vnesite URL webhooka, na katerega pošljemo vsak dokončan sestanek.
3. Končano. Za Make, Zapier ali n8n potrebujete samo URL webhooka, ki ga ustvarite tam.

Vse končne točke so samo za branje, vračajo JSON in pričakujejo žeton v glaviAuthorization: Bearer miq_…Omejitev: 120 zahtev na minuto na žeton.

Primer

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

Takoj ko je sestanek v celoti obdelan, pošljemo celoten rezultat na vaš URL z zahtevo POST, v enaki strukturi kot API. Neuspešne dostave se samodejno ponovijo, vsako dostavo in njeno stanje pa si lahko ogledate v vmesniku.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (ID te dostave)
X-MeetingIQ-Signature: sha256=…         (HMAC, izračunan iz surovega telesa zahteve)

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

Preverjanje podpisa (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 ne potrebujete dodatne integracije. Vsa tri orodja sprejemajo splošen dohodni webhook:

• Make: ustvarite modul „Custom Webhook“ in kopirajte ustvarjeni URL.
• Zapier: „Webhooks by Zapier“ → sprožilec „Catch Hook“.
• n8n: vozlišče Webhook, uporabite produkcijski URL.

URL vnesite v MeetingIQ v Einstellungen → API & Webhooks (Nastavitve → API in webhooki). Klik na „Testen“ (Preizkus) takoj pošlje testno dostavo, tako da lahko preslikavo polj pripravite, ne da bi čakali na naslednji sestanek.

Obdelava in shranjevanje potekata izključno v EU. Žetoni so shranjeni samo kot zgoščena vrednost, mogoče jih je kadar koli preklicati, vsaka dostava webhooka pa je podpisana. Pridobivanje prek API je sledljivo v revizijski sledi. Podrobnosti najdete v našem središču za zasebnost in v pogodbi o obdelavi osebnih podatkov (oboje v nemščini).