Webhook-Aktion – Personyze Wiki

Die Aktion Webhook sendet per POST eine Nachricht an eine beliebige URL, wenn ein Besucher auf Ihre Kampagne passt — mit Werten, die live aus seinem Profil, seiner Sitzung oder aus Containern auf der Seite stammen. Nutzen Sie sie, um einen Kontakt in Salesforce oder Zapier zu aktualisieren, eine Slack-Benachrichtigung zu senden, wenn ein Zielkonto eintrifft, oder eine beliebige interne API aufzurufen.

Von unseren Servern aufgerufen, nicht vom Browser. Es gibt kein CORS zu konfigurieren, und der Besucher sieht die Zugangsdaten nie — aber der Endpunkt muss aus dem öffentlichen Internet erreichbar sein.

Einrichtung

Im Schritt Inhalte der Kampagne: Aktion hinzufügen → Webhook.
Quick setup (optional) — klicken Sie auf Slack, Discord, Microsoft Teams, Zapier, Make oder n8n, und Methode, Format und Nachrichtenfeld werden für diesen Dienst voreingestellt. Ihre URL ändern diese Buttons nie.
Endpoint — Methode und Adresse. POST überträgt einen Body; Felder gehen in den Body, außer Sie stellen sie auf die URL um.
Authentication — klassische HTTP-Authentifizierung, wenn der Endpunkt sie nutzt; die meisten modernen APIs erwarten stattdessen ein Token in einem Header — fügen Sie Authorization: Bearer … unter Headers hinzu.
Fields — ein Schlüssel und ein Wert pro Zeile. Ein Wert ist ein fester Text oder wird vom Besucher gelesen: Profilfeld, Sitzungseigenschaft oder ein Container auf der Seite. Stellen Sie eine Zeile auf URL um, um sie als Query-Parameter zu senden.
Body format — application/x-www-form-urlencoded (Standard), JSON usw., mit optionaler Komprimierung.

Editor der Webhook-Aktion — Alles auf einem Bildschirm — mit einer Live-Vorschau der genauen Anfrage unten. Zum Vergrößern klicken.

Die Vorschau der Anfrage

Der Editor zeigt die Anfrage genau so, wie sie gesendet wird — und bietet Copy as cURL, der schnellste Weg, Ihren Endpunkt zu testen und einen falschen Feldnamen zu finden, bevor etwas veröffentlicht wird. Vom Besucher gelesene Werte erscheinen als Platzhalter ‹…› ; sie werden pro Besucher aufgelöst, wenn die Aktion ausgelöst wird.

Mit der Antwort etwas anfangen

Die meisten Webhooks sind „fire and forget“. Wenn der Endpunkt etwas Nützliches zurückgibt — einen Score, ein Segment, eine ID —, aktivieren Sie Store result to user profile und wählen das Profilfeld: Der Antwortwert landet im Profil des Besuchers, bereit, später im Targeting genutzt zu werden. Läuft einmal pro Besucher und Auslösung.

Wann und wo

Wird ausgelöst, wenn das Targeting der Kampagne greift; Beschränken auf grenzt es auf bestimmte Seitengruppen ein. Für das Senden von Formularübermittlungen nutzen Sie besser die eigenen Ziele des Formulars unter Where the data goes.