Webhooks einrichten

Wie Sie Webhooks konfigurieren, um externe Systeme zu benachrichtigen, wenn Änderungen in Ihrem Modell auftreten.

Webhooks ermöglichen es Ihnen, externe Systeme automatisch zu benachrichtigen, wenn Änderungen in Ihrem Metapad-Modell auftreten.

Was sind Webhooks?

Ein Webhook ist ein HTTP-Callback — wenn sich etwas in Ihrem Modell ändert, sendet Metapad einen HTTP-POST-Request an eine von Ihnen angegebene URL mit Details darüber, was sich geändert hat.

Einen Webhook erstellen

Öffnen Sie Ihre Modelleinstellungen
Navigieren Sie zum Webhooks-Tab
Klicken Sie auf Webhook hinzufügen
Konfigurieren Sie:
- URL: Der Endpunkt, der Benachrichtigungen empfängt (muss HTTPS sein)
- Ereignisse: Über welche Änderungen benachrichtigt werden soll (z.B. Knoten erstellt, Beziehung gelöscht)
- Name: Ein beschreibender Name für diesen Webhook
Klicken Sie auf Speichern

Webhook-Payload

Wenn ein Ereignis eintritt, sendet Metapad ein JSON-Payload mit:

Ereignistyp (was passiert ist)
Details des betroffenen Elements (Knoten-/Beziehungsdaten)
Zeitstempel
Modell-ID

Anwendungsfälle

Slack/Teams-Benachrichtigungen: "Eine neue Anforderung wurde dem Modell hinzugefügt"
CI/CD-Auslöser: Automatisch Validierung ausführen, wenn sich das Architekturmodell ändert
Datensynchronisation: Eine externe Datenbank mit Ihrem Modell synchron halten
Audit-Logging: Alle Änderungen in einem externen System aufzeichnen

Voraussetzungen

Webhooks erfordern einen Pro-Plan oder höher
Der empfangende Endpunkt muss öffentlich erreichbar sein (oder von Metapads Servern erreichbar)
HTTPS ist aus Sicherheitsgründen erforderlich

Tipps

Testen Sie Ihren Webhook-Endpunkt zuerst mit einem einfachen Echo-Service
Behandeln Sie Wiederholungsversuche, da Webhooks mehr als einmal zugestellt werden können
Verwenden Sie Webhook-Namen, die die Integration beschreiben (z.B. "Slack #architektur-änderungen")