Webhooks

Ein Webhook meldet Deinem eigenen System, sobald in Meeting Metrics etwas passiert, zum Beispiel wenn ein Meeting fertig transkribiert ist. Meeting Metrics sendet dafür eine HTTPS-Anfrage mit den Daten des Meetings an eine Adresse, die Du festlegst.

Webhooks richten sich an Personen, die eigene Software oder Automatisierungen anbinden, etwa mit n8n, Make oder Zapier. Für Slack, Discord, Confluence und OneDrive gibt es fertige Integrationen.

Webhook erstellen

1. Klicke unten links auf Deinen Namen und wähle Webhooks.
2. Klicke auf Webhook hinzufügen.

3. Fülle das Formular aus:
   • Name: zur Unterscheidung in der Liste.
   • HTTPS-Endpunkt: die Adresse, an die gesendet wird. Erlaubt sind nur öffentliche HTTPS-Adressen.
   • Ereignisse: wann gesendet wird, siehe unten.
   • Payload-Bereiche: welche Inhalte mitgeschickt werden: Transkript, Zusammenfassung, Ergebnisse und Aufgaben.
   • Benutzerdefinierte Header: optional, zum Beispiel ein Token für Deinen Endpunkt.
4. Klicke auf Webhook erstellen.

Unter Beispiel-Payload siehst Du im Formular, wie die Daten für Deine Auswahl aussehen.

Ereignisse

Aufbau der Daten

Jede Zustellung ist ein JSON-Dokument. Beispiel für transcription.completed mit dem Bereich Zusammenfassung:

{
    "version": 1,
    "id": "example-event-id",
    "event": "transcription.completed",
    "occurred_at": "2026-01-01T12:00:00Z",
    "metadata": {
        "transcription": {
            "id": "example-transcription-id",
            "name": "Example meeting",
            "status": "completed",
            "language": "en",
            "duration": 3600,
            "folder_id": null,
            "created_at": "2026-01-01T11:00:00Z",
            "completed_at": "2026-01-01T11:30:00Z"
        },
        "duration_limit": {
            "limit_seconds": null,
            "source_duration_seconds": 3600,
            "content_locked": false,
            "reason": null
        }
    },
    "summary": "A short synthetic meeting summary."
}

duration_limit.content_locked ist true, wenn das Meeting länger ist als im Plan erlaubt. Gesperrte Inhalte werden nicht mitgeschickt, siehe Pläne, Testphase und Limiten.

Signatur prüfen

Jeder Webhook hat ein Signaturgeheimnis. Du findest es, wenn Du den Webhook bearbeitest. Damit prüfst Du, ob eine Anfrage wirklich von Meeting Metrics stammt.

Meeting Metrics signiert nach dem Standard Standard Webhooks. Jede Anfrage trägt diese Header:

Die Signatur ist ein HMAC-SHA256 über die Zeichenkette {webhook-id}.{webhook-timestamp}.{Body}, mit dem Signaturgeheimnis als Schlüssel. Bibliotheken für Standard Webhooks übernehmen die Prüfung.

Zusätzlich sendet Meeting Metrics die Header X-Meeting-Metrics-Event-Id, X-Meeting-Metrics-Timestamp und X-Meeting-Metrics-Signature. Letzterer enthält sha256= gefolgt vom hexadezimalen HMAC-SHA256 über {Timestamp}.{Body}.

Zustellung und Wiederholungen

• Dein Endpunkt hat 30 Sekunden Zeit zu antworten.
• Schlägt eine Zustellung fehl, versucht es Meeting Metrics bis zu zwei weitere Male: nach 1 Minute und nach 5 Minuten.
• Antworte mit einem Statuscode 2xx, sobald Du die Daten angenommen hast, und verarbeite sie danach.
• Nutze webhook-id, um doppelte Zustellungen zu erkennen.

Zustellverlauf ansehen

Klicke in der Liste bei einem Webhook unter Verlauf auf Anzeigen. Du siehst die letzten 10 Zustellungen mit Ereignis, Zeit, Antwort Deines Endpunkts und Zahl der Versuche.

Webhook pausieren, bearbeiten oder löschen

• Pausieren: Schalte den Webhook in der Liste aus. Er bleibt gespeichert, sendet aber nichts.
• Bearbeiten: ändert Endpunkt, Ereignisse, Bereiche und Header.
• Löschen: entfernt den Webhook und seinen Zustellverlauf.

Webhooks für einen einzelnen Ordner

Ein Webhook unter Webhooks im Benutzermenü gilt für Deine Meetings. Soll er nur für einen bestimmten Ordner gelten, legst Du ihn im Ordner an: Ordner bearbeiten, Tab Webhooks, Webhook hinzufügen.

Ein Ordner-Webhook sendet für alle Meetings in diesem Ordner, auch für Deine privaten. Private Meetings anderer Personen sind ausgeschlossen.

Wenn nichts ankommt

• Prüfe im Verlauf, ob Meeting Metrics gesendet hat und was Dein Endpunkt geantwortet hat.
• Prüfe, ob der Webhook Aktiv ist und das richtige Ereignis gewählt hat.
• Der Endpunkt muss aus dem Internet erreichbar sein. Adressen im internen Netz oder localhost funktionieren nicht.