API și webhookuri

1. În MeetingIQ, creați un token API din Einstellungen → API & Webhooks (Setări → API și webhookuri). Din motive de securitate, acesta este afișat o singură dată.
2. Fie interogați API-ul REST, fie introduceți un URL de webhook la care trimitem fiecare ședință finalizată.
3. Gata. Pentru Make, Zapier sau n8n, aveți nevoie doar de URL-ul de webhook generat acolo.

Toate endpointurile sunt doar pentru citire, returnează JSON și așteaptă tokenul în headerAuthorization: Bearer miq_…Limită: 120 de cereri pe minut per token.

Exemplu

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

Răspuns

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

Imediat ce o ședință a fost procesată complet, trimitem rezultatul integral la URL-ul dumneavoastră prin POST, în aceeași structură ca API-ul. Livrările eșuate sunt reîncercate automat, iar fiecare livrare poate fi vizualizată în interfață, împreună cu starea ei.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (ID-ul acestei livrări)
X-MeetingIQ-Signature: sha256=…         (HMAC calculat pe corpul brut al cererii)

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

Verificarea semnăturii (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"])
);

Nu aveți nevoie de o integrare suplimentară. Toate trei acceptă un webhook generic de intrare:

• Make: creați un modul „Custom Webhook” și copiați URL-ul generat.
• Zapier: „Webhooks by Zapier” → trigger „Catch Hook”.
• n8n: nodul Webhook, folosiți URL-ul de producție.

Introduceți URL-ul în MeetingIQ la Einstellungen → API & Webhooks (Setări → API și webhookuri). Un clic pe „Testen” (Testare) trimite imediat o livrare de test, astfel încât vă puteți construi maparea câmpurilor fără să așteptați următoarea ședință.

Prelucrarea și stocarea au loc exclusiv în UE. Tokenurile sunt stocate doar ca hash, pot fi revocate oricând, iar fiecare livrare de webhook este semnată. Accesările prin API sunt trasabile în jurnalul de audit. Detalii găsiți în centrul de confidențialitate și în acordul de prelucrare a datelor (ambele în limba germană).