API og webhooks

1. Opret et API-token i MeetingIQ under Einstellungen → API & Webhooks (Indstillinger → API og webhooks). Af sikkerhedshensyn vises det kun én gang.
2. Forespørg enten REST API'et, eller angiv en webhook-URL, som vi sender hvert færdigt møde til.
3. Færdig. Til Make, Zapier eller n8n skal du kun bruge den webhook-URL, der genereres dér.

Alle endpoints er skrivebeskyttede, returnerer JSON og forventer tokenet i headerenAuthorization: Bearer miq_…Grænse: 120 forespørgsler pr. minut pr. token.

Eksempel

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

Svar

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

Så snart et møde er færdigbehandlet, sender vi det komplette resultat til din URL via POST, i samme struktur som API'et. Mislykkede leveringer forsøges automatisk igen, og hver levering kan ses med sin status i brugerfladen.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (ID for denne levering)
X-MeetingIQ-Signature: sha256=…         (HMAC over den rå body)

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

Verificér signaturen (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"])
);

Du behøver ikke en ekstra integration til dette. Alle tre accepterer en generisk indgående webhook:

• Make: opret et »Custom Webhook«-modul, og kopiér den genererede URL.
• Zapier: »Webhooks by Zapier« → triggeren »Catch Hook«.
• n8n: Webhook-node, brug produktions-URL'en.

Angiv URL'en i MeetingIQ under Einstellungen → API & Webhooks (Indstillinger → API og webhooks). Et klik på »Testen« (Test) sender straks en testlevering, så du kan opbygge din feltmapping uden at vente på næste møde.

Behandling og lagring sker udelukkende i EU. Tokens gemmes kun som hash, kan til enhver tid tilbagekaldes, og hver webhook-levering er signeret. Hentning via API'et kan spores i auditloggen. Detaljer finder du i vores privatlivscenter og i databehandleraftalen (begge på tysk).