Kampagnen
Auslöser
Auslöser - Webhook
8 min
wofür ist der auslöser webhook? durch einen generischen webhook kannst du in 4leads eine kampagne starten lassen der auslöser verarbeitet die webhook daten des externen systems und erstellt dann wahlweise einen kontakt abgrenzung zu formular webhooks es ist ebenfalls möglich eine kampagne durch einen formular webhook zu starten ein formular webhook spiegelt eine formulareintragung durch ein automatisches externes system wieder und verhält sich wie eine formular anmeldung eines kontakts ein formular webhook gibt zudem die parameter und den aufbau des http requests vor der generische webhook dagegen kann auch einfach nur events für kontakte verarbeiten und gibt keinen festen aufbau des http requests vor, sondern liest den vorhandenen aufbau des requests aus übersicht request und datenstruktur die generischen webhook können folgende http request methoden verarbeiten post requests mit klassischen post parametern im form data format post requests mit json im request body get requests mit get parametern urlencoded einrichtung einstellungen wie in der "übersicht" zu sehen, wird der webhook über die automationen als auslöser einer kampagne erstellt als auslösetyp ist webhook zu wählen das system erwartet nun, dass im nächsten schritt die datenstruktur eingelesen wird datenstruktur einlesen die datenstruktur wird bei der erstellung des auslösers oder zu einem späteren zeitpunkt durch den button datenstruktur neu einlesen eingelesen nachdem das einlesen gestartet wurde, wartet das system darauf, dass der webhook mit beispieldaten bespielt wird sobald ein webhook mit beispieldaten eingegangen ist, wechselt die ansicht automatisch und die eingelesenen daten sind zur zuweisung verfügbar gängige bezeichnungen von parametern und felder für die wichtigsten felder werden automatisch erkannt das system wartet maximal 5 minuten auf den eingang eines webhooks zum einlesen die kampagne kann auch ohne zuweisung und datenstruktur aktiviert werden in diesem fall wird der erste request an den webhook zum einlesen der struktur verwendet eine verarbeitung des webhooks ist ohne explizite zuweisung gegebenenfalls nicht möglich felder zuweisen die felder bzw parameter aus dem webhook müssen im nächsten schritt den stammsatzfeldern des kontakts zugewiesen werden teilweise kann dies auch automatisch erfolgen, wenn gängige bezeichnungen verwendet werden das system zeigt hierzu alle verfügbaren parameter die eingelesen wurden diese können über das dynamische eingabesystem ausgewählt oder ergänzt werden der großteil der felder ist unter den erweiterten einstellungen standardmäßig ausgeblendet sonstige einstellungen neue kontakte erstellen es kann festgelegt werden, ob die kampagne nur für bekannte kontakte starten soll oder ob unbekannte kontakte, falls möglich, neu angelegt werden sollen e mail status für neue kontakte (empfohlen) oder für alle kontakte die diesen webhook durchlaufen, kann der e mail status gesetzt werden e mail adressen überschreiben ist diese einstellung aktiv und ein kontakt wird anhand seiner 4leads id identifiziert, kann diese bei einer abweichung die e mail adresse des kontakts überschrieben werden
