MeetingIQ
Für Entwickler

API & Webhooks

Holen Sie Transkripte, Zusammenfassungen und Aufgaben automatisiert in Ihre eigenen Systeme, per REST-API oder per Webhook. Ohne Umweg über US-Dienste: alles läuft über unsere EU-Infrastruktur.

Enthalten ab dem Pro-Plan. Im 14-tägigen Test ist der API-Zugang bereits freigeschaltet.

In 3 Schritten angebunden

  1. In MeetingIQ unter Einstellungen → API & Webhooks einen API-Token erstellen. Er wird aus Sicherheitsgründen nur einmal angezeigt.
  2. Entweder die REST-API abfragen oder eine Webhook-URL hinterlegen, an die wir jedes fertige Meeting senden.
  3. Fertig. Für Make, Zapier oder n8n genügt die dort erzeugte Webhook-URL.

REST-API

Alle Endpunkte sind lesend, liefern JSON und erwarten den Token im HeaderAuthorization: Bearer miq_…Limit: 120 Anfragen pro Minute und Token.

GET/api/v1/meetingsListe, filterbar nach Status
GET/api/v1/meetings/{id}Zusammenfassung, Kernpunkte, Aufgaben
GET/api/v1/meetings/{id}/transcriptVolltext + Sprecher-Segmente

Beispiel

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

Antwort

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

Webhooks

Sobald ein Meeting fertig ausgewertet ist, senden wir das vollständige Ergebnis per POST an Ihre URL, in derselben Struktur wie die API. Fehlgeschlagene Zustellungen wiederholen wir automatisch, und jede Zustellung ist im Interface mit Status einsehbar.

POST https://ihre-domain.de/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (ID dieser Zustellung)
X-MeetingIQ-Signature: sha256=…         (HMAC über den rohen Body)

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

Signatur prüfen (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"])
);

Make, Zapier und n8n

Dafür brauchen Sie keine zusätzliche Integration. Alle drei nehmen einen generischen eingehenden Webhook entgegen:

  • Make: Modul „Custom Webhook" anlegen, erzeugte URL kopieren.
  • Zapier: „Webhooks by Zapier" → Trigger „Catch Hook".
  • n8n: Webhook-Node, Produktions-URL verwenden.

Die URL tragen Sie bei uns unter Einstellungen → API & Webhooks ein. Ein Klick auf „Testen" schickt sofort eine Testzustellung, damit Sie Ihr Feld-Mapping bauen können, ohne auf das nächste Meeting zu warten.

Datenschutz

Verarbeitung und Speicherung erfolgen ausschließlich in der EU. Tokens werden nur als Hash gespeichert, sind jederzeit widerrufbar, und jede Webhook-Zustellung ist signiert. Der Abruf über die API ist im Audit-Log nachvollziehbar. Details in unserem Datenschutz-Center und im AVV.

Fragen zur Anbindung?

Sagen Sie uns, in welches Zielsystem die Daten laufen sollen, wir richten es einmal gemeinsam mit Ihnen ein.