API och webhooks

1. Skapa en API-token i MeetingIQ under Einstellungen → API & Webhooks (Inställningar → API och webhooks). Av säkerhetsskäl visas den bara en gång.
2. Anropa REST-API:t eller ange en webhook-URL som vi skickar varje färdigt möte till.
3. Klart. För Make, Zapier eller n8n räcker det med den webhook-URL som genereras där.

Alla endpoints är skrivskyddade, returnerar JSON och förväntar sig token i headernAuthorization: Bearer miq_…Gräns: 120 anrop per minut och token.

Exempel

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 ett möte är färdigbehandlat skickar vi hela resultatet till din URL via POST, i samma struktur som API:t. Misslyckade leveranser görs om automatiskt, och varje leverans kan ses med sin status i gränssnittet.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (ID för den här leveransen)
X-MeetingIQ-Signature: sha256=…         (HMAC över den oförändrade bodyn)

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

Verifiera 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 ingen extra integration för detta. Alla tre tar emot en generisk inkommande webhook:

• Make: skapa en ”Custom Webhook”-modul och kopiera den genererade URL:en.
• Zapier: ”Webhooks by Zapier” → triggern ”Catch Hook”.
• n8n: Webhook-noden, använd produktions-URL:en.

Ange URL:en i MeetingIQ under Einstellungen → API & Webhooks (Inställningar → API och webhooks). Ett klick på ”Testen” (Testa) skickar en testleverans direkt, så att du kan bygga din fältmappning utan att vänta på nästa möte.

Behandling och lagring sker uteslutande i EU. Token sparas bara som hash, kan återkallas när som helst, och varje webhook-leverans är signerad. Hämtningar via API:t är spårbara i granskningsloggen. Detaljer finns i vårt dataskyddscenter och i personuppgiftsbiträdesavtalet (båda på tyska).