API e webhook

1. In MeetingIQ, crea un token API in Einstellungen → API & Webhooks (Impostazioni → API e webhook). Per motivi di sicurezza viene mostrato una sola volta.
2. Interroga l'API REST oppure inserisci un URL di webhook a cui inviamo ogni riunione completata.
3. Fatto. Per Make, Zapier o n8n basta l'URL del webhook generato lì.

Tutti gli endpoint sono in sola lettura, restituiscono JSON e si aspettano il token nell'headerAuthorization: Bearer miq_…Limite: 120 richieste al minuto per token.

Esempio

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

Risposta

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

Non appena una riunione è stata elaborata completamente, inviamo il risultato completo al tuo URL tramite POST, con la stessa struttura dell'API. Le consegne non riuscite vengono ritentate automaticamente e ogni consegna è consultabile con il relativo stato nell'interfaccia.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (ID di questa consegna)
X-MeetingIQ-Signature: sha256=…         (HMAC sul body grezzo)

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

Verifica la firma (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"])
);

Non ti serve un'integrazione aggiuntiva. Tutti e tre accettano un webhook in entrata generico:

• Make: crea un modulo «Custom Webhook» e copia l'URL generato.
• Zapier: «Webhooks by Zapier» → trigger «Catch Hook».
• n8n: nodo Webhook, usa l'URL di produzione.

Inserisci l'URL in MeetingIQ in Einstellungen → API & Webhooks (Impostazioni → API e webhook). Un clic su «Testen» (Test) invia subito una consegna di prova, così puoi impostare la mappatura dei campi senza aspettare la riunione successiva.

Il trattamento e l'archiviazione avvengono esclusivamente nell'UE. I token vengono salvati solo come hash, possono essere revocati in qualsiasi momento e ogni consegna webhook è firmata. Gli accessi tramite API sono tracciabili nel registro di audit. Trovi i dettagli nel nostro centro privacy e nell'accordo sul trattamento dei dati (entrambi in tedesco).