API & webhooks

1. Maak in MeetingIQ een API-token aan onder Einstellungen → API & Webhooks (Instellingen → API & webhooks). Om veiligheidsredenen wordt het maar één keer getoond.
2. Bevraag de REST API of geef een webhook-URL op waarnaar we elke afgeronde vergadering sturen.
3. Klaar. Voor Make, Zapier of n8n hebt u alleen de webhook-URL nodig die daar wordt aangemaakt.

Alle endpoints zijn alleen-lezen, geven JSON terug en verwachten het token in de headerAuthorization: Bearer miq_…Limiet: 120 verzoeken per minuut per token.

Voorbeeld

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

Antwoord

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

Zodra een vergadering volledig is verwerkt, sturen we het complete resultaat per POST naar uw URL, in dezelfde structuur als de API. Mislukte leveringen worden automatisch opnieuw geprobeerd, en elke levering is met haar status in de interface te bekijken.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (ID van deze levering)
X-MeetingIQ-Signature: sha256=…         (HMAC over de ruwe body)

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

Handtekening verifiëren (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"])
);

Hiervoor hebt u geen extra integratie nodig. Alle drie accepteren een generieke inkomende webhook:

• Make: maak een module “Custom Webhook” aan en kopieer de gegenereerde URL.
• Zapier: “Webhooks by Zapier” → trigger “Catch Hook”.
• n8n: Webhook-node, gebruik de productie-URL.

Voer de URL in MeetingIQ in onder Einstellungen → API & Webhooks (Instellingen → API & webhooks). Een klik op “Testen” verstuurt meteen een testlevering, zodat u uw veldkoppeling kunt opbouwen zonder op de volgende vergadering te wachten.

Verwerking en opslag vinden uitsluitend plaats in de EU. Tokens worden alleen als hash opgeslagen en kunnen op elk moment worden ingetrokken, en elke webhooklevering is ondertekend. Opvragingen via de API zijn traceerbaar in het auditlog. Meer details vindt u in ons privacycentrum en in de verwerkersovereenkomst (beide in het Duits).