Automatisierungen: Webhook senden

Mit der Aktion "Webhook senden" können Sie bei bestimmten Ereignissen automatisch externe Systeme benachrichtigen. So lassen sich beispielsweise Projektmanagement-Tools, CRM-Systeme oder eigene Anwendungen anbinden.

Was ist ein Webhook?

Ein Webhook ist eine automatische Benachrichtigung an eine externe URL. Wenn ein bestimmtes Ereignis eintritt (z.B. ein Projekt wird erstellt oder ein Status ändert sich), sendet das System automatisch Daten an die von Ihnen hinterlegte Adresse.

Webhook-Aktion einrichten

Navigieren Sie zu Admin > Automatisierungen
Erstellen Sie eine neue Automatisierung oder bearbeiten Sie eine bestehende
Wählen Sie den gewünschten Ereignistyp (z.B. "Statusänderung Projekt", "Anfrage erstellt")
Klicken Sie auf "Aktion hinzufügen"
Wählen Sie als Aktionstyp "Webhook senden"

Konfiguration

Nach der Auswahl von "Webhook senden" erscheinen folgende Einstellungen:

Webhook-URL: Die Adresse, an die die Daten gesendet werden sollen (z.B. https://hooks.zapier.com/... oder eine eigene Server-URL)
HTTP-Methode: Wählen Sie zwischen POST, GET oder PUT. In den meisten Fällen ist POST die richtige Wahl
Authentifizierung: Falls der Empfänger eine Authentifizierung erfordert, wählen Sie "Bearer Token" oder "API-Key (Header)" und geben Sie den entsprechenden Schlüssel ein. Bei "Keine" wird kein Authentifizierungs-Header mitgeschickt
Token / API-Key: Der Authentifizierungsschlüssel, den Sie vom Empfänger erhalten haben
Ausführung: Legen Sie fest, ob der Webhook sofort oder zeitverzögert gesendet werden soll (z.B. 1 Stunde, 1 Tag oder bis zu 30 Tage später)

Welche Daten werden gesendet?

Der Webhook sendet automatisch alle verfügbaren Informationen zum Ereignis als JSON-Daten. Dazu gehören unter anderem:

Die Art des Ereignisses
Projekt-Daten (Name, Status, Nummer)
Kunden-Daten (Name, E-Mail)
Weitere Informationen je nach Ereignistyp (z.B. Anfrage-Titel, Termin-Daten)

Die Variablen, die in der Automatisierung unter "Verfügbare Variablen" angezeigt werden, sind ebenfalls in den gesendeten Daten enthalten.

Anwendungsbeispiele

Zapier / Make (Integromat): Verbinden Sie das System mit hunderten anderen Anwendungen
Eigenes CRM: Lassen Sie sich bei neuen Anfragen automatisch benachrichtigen
Buchhaltung: Senden Sie Projektdaten bei Statusänderungen an Ihr Buchhaltungssystem
Eigene Formulare: Erhalten Sie die ausgefüllten Formulardaten direkt in Ihrem System

Häufige Fragen

Welche Ereignisse können einen Webhook auslösen?
Alle verfügbaren Ereignistypen: Statusänderung Projekt, Projekt erstellt, Eigene Felder geändert, Eigenes Formular ausgefüllt, Leistungsverzeichnis erstellt, Termin erstellt, Anfrage erstellt, Anfragen-Status geändert und Rapport erstellt.

Was passiert, wenn der Empfänger nicht erreichbar ist?
Der Webhook hat ein Zeitlimit von 5 Sekunden. Ist der Empfänger nicht erreichbar, wird der Versuch protokolliert, aber nicht automatisch wiederholt.

Kann ich mehrere Webhooks pro Automatisierung einrichten?
Ja, Sie können beliebig viele Aktionen pro Automatisierung hinzufügen, auch mehrere Webhooks an unterschiedliche URLs.

Muss die URL mit HTTPS beginnen?
Sowohl HTTP als auch HTTPS sind erlaubt. Aus Sicherheitsgründen empfehlen wir HTTPS.