Webhooks einrichten

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")