Webhooks: Echtzeit-Events aus ContractHero in Ihre Systeme senden

Ihr Vorteil

Wer Vertragsdaten in andere Systeme bringen will (Salesforce, Hubspot, Slack, BigQuery, n8n …), wartet sonst entweder auf manuelle Exporte oder pollt im Minutentakt die ContractHero-API ab. Mit Webhooks passiert genau das Gegenteil: ContractHero meldet sich von selbst, wenn etwas passiert. Sie sparen Polling-Last und reagieren in Echtzeit — typischerweise innerhalb von Sekunden nach dem Event.

Voraussetzungen

Webhooks sind ab dem Professional-Plan verfügbar.
Sie benötigen einen erreichbaren HTTPS-Endpoint, der POST-Requests im JSON-Format entgegennimmt.
Eigentümer-Rolle in ContractHero mit Zugriff auf Einstellungen → Integrationen.

So funktioniert's

1. Webhook-Bereich öffnen

Navigieren Sie zu Einstellungen → Integrationen.

Wechseln Sie zum Reiter „Webhooks". Wenn Sie noch keine Webhooks konfiguriert haben, sehen Sie den Hinweis „Keine Webhooks hinzugefügt".

2. Neuen Webhook anlegen

Klicken Sie rechts oben auf „+ Webhook hinzufügen".

Sie landen im Konfigurations-Dialog „Webhook einrichten, um Echtzeit-Updates zu erhalten" mit drei Bereichen:

Webhook Name — interne Bezeichnung, hilft beim Wiederfinden (z. B. „Slack-Alerts Legal").
URL — Ihr HTTPS-Endpoint, der die Events empfangen soll. Format: https://hooks.your-endpoint.com/updates. Über „URL testen" prüfen Sie, ob ContractHero den Endpoint erreichen kann.
Ereignisse — Sie wählen via Checkbox, bei welchen Events der Webhook ausgelöst wird (Liste siehe unten).

3. Events auswählen

Sie können einzelne Events einzeln aktivieren oder über die Header-Checkbox alle auf einmal abonnieren. Aktuell verfügbar sind:

Event	Auslöser
`contract.created`	Ein Vertrag wird erstellt — inkl. vollständiger Vertragsdaten, Quelle (z. B. per Upload, XML-Import oder E-Mail), Ersteller und Zeitstempel.
`contract.edited`	Ein Vertrag wird bearbeitet — inkl. Feldbewegungen, Bearbeiter (im KI-Fall: `ContractHero KI`) und Zeitstempel.
`member_invitation.created`	Ein Mitglied wird in eine Organisation eingeladen — inkl. Org-Name, Einladender, E-Mail-Adresse, Rolle, Zeitstempel.
`member_invitation.accepted`	Ein Mitglied hat die Einladung angenommen.
`reminder.created`	Eine Aufgabe wird erstellt.
`reminder.updated`	Eine Aufgabe wird aktualisiert.
`reminder.due_date_reached`	Eine Aufgabe hat ihr Fälligkeitsdatum erreicht.
`reminder.sent`	Es wird eine Erinnerung für eine Aufgabe gesendet.
`summary.update`	Eine geplante Zusammenfassung wird gesendet (z. B. der monatliche Statusbericht).

4. Speichern und live schalten

Nach dem Speichern erscheint der Webhook in der Liste „Webhooks". Ab diesem Zeitpunkt sendet ContractHero pro abonniertem Event eine POST-Anfrage im JSON-Format an Ihren Endpoint.

5. Endpoint-Side: Anfragen entgegennehmen

Ihr Endpoint sollte:

HTTPS sprechen (kein HTTP).
Den POST-Request schnell mit HTTP 2xx beantworten (idealerweise unter 5 Sekunden), damit ContractHero nicht in einen Retry läuft.
Den Event-Typ aus dem Payload lesen (Schema je nach Event).
Bei Bedarf den Payload asynchron weiterverarbeiten (Queue, Worker), damit der HTTP-Response nicht blockiert.

Häufige Fragen

Welche Pläne enthalten Webhooks?

Webhooks sind ab dem Professional-Plan verfügbar (Professional, Enterprise).

Sind Webhooks ein- oder ausgehend?

Ausgehend. ContractHero sendet bei Events HTTP-POST-Requests an Ihren Endpoint. Eingehende Aufrufe (externe Systeme schreiben in ContractHero) laufen über die Public REST API, nicht über Webhooks.

Wie schnell werden Events ausgeliefert?

Üblicherweise innerhalb weniger Sekunden nach dem auslösenden Ereignis. Bei Lastspitzen oder wenn Ihr Endpoint langsam antwortet, kann es länger dauern.

Was passiert, wenn mein Endpoint kurz nicht erreichbar ist?

ContractHero versucht den Webhook automatisch erneut zuzustellen. Die Anzahl und Frequenz der Retries kann je nach Event variieren — als Endpoint-Betreiber sollten Sie idempotent verarbeiten (gleicher Webhook darf zweimal ankommen, ohne Doppel-Effekt).

Wie sichere ich den Endpoint gegen Missbrauch ab?

Mindestens HTTPS und ein internes Geheimnis im Payload oder URL-Pfad. Wenn Sie eine Signatur-Prüfung wünschen, sprechen Sie uns an — wir prüfen das individuell.

Welche Datenmenge wird übertragen?

Bei contract.created und contract.edited enthält der Payload die vollständigen Vertragsdaten zum Zeitpunkt des Events — auch Feldbewegungen bei Edits. Bei Aufgaben-Events sind die Aufgaben-Metadaten enthalten.

Kann ich Events filtern (z. B. nur eine bestimmte Kategorie)?

Aktuell wählen Sie pro Webhook nur den Event-Typ aus. Filterung nach Kategorie, Team oder anderen Vertragsfeldern müssen Sie endpoint-seitig vornehmen. Auf Anfrage prüfen wir, ob ein servergestütztes Filtering für Ihren Use-Case sinnvoll ist.

Kann ich mehrere Webhooks parallel betreiben?

Ja. Sie können beliebig viele Webhooks anlegen — typischerweise einen pro Zielsystem (Salesforce, Slack, eigenes Tool).

Wie teste ich, ob mein Endpoint korrekt antwortet?

Im Konfigurations-Dialog steht der Button „URL testen" — ContractHero schickt einen Test-Request, mit dem Sie sofort sehen, ob Ihr Endpoint erreichbar ist und korrekt antwortet.

Können Webhooks nachträglich für ältere Events ausgelöst werden?

Nein — Webhooks senden ausschließlich ab dem Zeitpunkt der Aktivierung. Wenn Sie Bestandsdaten in Ihr Zielsystem überführen möchten, nutzen Sie den Export oder die API.

Gut zu wissen

Idempotente Verarbeitung ist Pflicht. Bei Netzwerk-Problemen kann derselbe Webhook mehrfach ausgeliefert werden. Speichern Sie Event-IDs und prüfen Sie vor der Verarbeitung, ob das Event schon einmal verarbeitet wurde.
Schneller 2xx-Response, asynchrone Logik. Schreiben Sie den Payload sofort in eine Queue und antworten Sie ContractHero mit 200 OK. Lange synchron-Verarbeitung führt zu Timeouts und Retries.
HTTPS nicht verhandelbar. ContractHero akzeptiert nur HTTPS-Endpoints. Self-signed Zertifikate können Probleme machen — nutzen Sie ein gängiges CA-Zertifikat (Let's Encrypt etc.).
Sprechende Webhook-Namen. „Salesforce Vertragsanlagen", „Slack Legal-Team — Fristen erreicht" sind später wiederfindbar. „Webhook 3" nicht.
n8n / Make / Zapier sind perfekte Erstziele. Wenn Sie keinen eigenen Server bauen wollen, sind diese No-Code-Plattformen ideal — sie liefern Ihnen eine fertige HTTPS-URL, die Sie hier eintragen.
Wir unterstützen beim Setup. Wenn Sie unsicher mit der Endpoint-Konfiguration sind, gehen wir den Aufbau im Onboarding-Termin gemeinsam durch — typischerweise eine Stunde.