Verwendung von Webhook-Antwortdaten in Ihrer Journey

Übersicht

Wenn Sie Werte aus einer Webhook-Antwort zuordnen, speichert Pushwoosh diese als Variablen, die Sie später in der Journey in Update user profile, Time Delay und zur Personalisierung von Inhalten verwenden können, genauso wie Sie ein Event-Attribut verwenden würden. Die einzige Ausnahme ist Condition split: Es kann nicht direkt auf eine Webhook-Variable verzweigen, da es einen Wert mit einem deklarierten Typ (ein Tag oder ein Event-Attribut) benötigt und ein zugeordneter Webhook-Wert keinen Typ hat. Siehe Vergleichen eines Webhook-Wertes in Condition split unten.

Hinweis

Um ein Webhook-Element hinzuzufügen und die Response-Zuordnung zu konfigurieren, siehe Webhook.

Speichern eines Webhook-Wertes als Tag mit Update user profile

Ein Webhook kann Daten aus einem externen System zurückgeben, wie z. B. eine CRM-Benutzer-ID oder einen Abonnementstatus, die Pushwoosh noch nicht im Benutzerprofil speichert. Update user profile speichert zugeordnete Werte als Tags, sodass Sie sie in Segmenten, dynamischen Inhalten und späteren Journey-Schritten verwenden können.

Beispiel: Speichern einer CRM-Benutzer-ID als Tag

Ein neuer Benutzer meldet sich in Ihrer App an, und die Journey erstellt einen passenden Datensatz in Ihrem CRM. Das Speichern der zurückgegebenen CRM-Benutzer-ID als Tag ermöglicht es Ihnen, denselben CRM-Datensatz später zu referenzieren oder zu aktualisieren, zum Beispiel aus einer anderen Journey oder einem nachfolgenden Webhook-Aufruf, anstatt bei jedem Wiedereintritt des Benutzers in die Journey einen doppelten Datensatz zu erstellen.

Journey-Ablauf: Trigger-based Entry → Webhook → Update user profile → Zweig beenden

1. Erstellen Sie eine Journey mit Trigger-based Entry für das SignUp-Event.
2. Fügen Sie nach dem Eingangsschritt ein Webhook-Element hinzu. Benennen Sie es (z. B. Create user in CRM) und legen Sie die Anfrage-URL auf den Endpunkt zur Benutzererstellung Ihres CRM fest.
3. Setzen Sie in Response mapping den Path auf das ID-Feld in der Antwort (z. B. data.user.id) und das Attribute auf crm_user_id.

4. Fügen Sie nach dem Webhook-Schritt ein Update user profile-Element hinzu.

5. Klicken Sie in Dynamic Tag Value auf + Dynamic Value. Wählen Sie unter Tag das Tag aus, das die CRM-ID speichert (erstellen Sie es bei Bedarf im Voraus). Wählen Sie unter Event den Webhook-Schritt anhand des von Ihnen vergebenen Namens aus (Create user in CRM). Wählen Sie unter Dynamic Value crm_user_id aus.

6. Beenden Sie den Zweig – fügen Sie ein Exit-Element hinzu oder lassen Sie ihn ohne ausgehende Verbindung.

Vorsicht

Wenn der Webhook-Wert für einen Benutzer fehlt (die Antwort war kein JSON, der Path konnte nicht aufgelöst werden oder der Aufruf ist fehlgeschlagen), überspringt Pushwoosh diese Tag-Aktualisierung. Das Tag behält seinen vorherigen Wert oder bleibt ungesetzt, und die Journey wird ohne Fehler an diesem Schritt fortgesetzt. Führen Sie vor dem Start Test webhook aus, um zu bestätigen, dass die Anfrage erfolgreich ist, und vergleichen Sie dann den Antwortkörper mit Ihrem Path im Calls log. Erfahren Sie mehr.

Planen einer Verzögerung aus einem Webhook-Wert mit Time Delay

Besuchstermine, Verlängerungsfristen und Lieferfenster befinden sich oft in einem externen Buchungs- oder Abrechnungssystem. Nachdem ein Webhook das Datum aus der API-Antwort zugeordnet hat, kann Time Delay die Journey bis zu diesem Zeitpunkt unterbrechen, zum Beispiel 2 Tage vor einem Termin, damit die nächste Nachricht rechtzeitig versendet wird.

Beispiel: Planen einer Erinnerung anhand eines Datums in der Antwort

Ein Benutzer bucht einen Termin in Ihrer App. Die Journey ruft das Besuchsdatum aus Ihrem Buchungssystem ab und sendet 2 Tage vor dem Besuch eine Push-Erinnerung.

1. Erstellen Sie eine Journey mit Trigger-based Entry für das AppointmentBooked-Event.
2. Fügen Sie nach dem Eingangsschritt ein Webhook-Element hinzu. Benennen Sie es (z. B. Get appointment details) und legen Sie die Anfrage-URL auf die API Ihres Buchungssystems fest.
3. Setzen Sie in Response mapping den Path auf das Datumsfeld in der Antwort (z. B. appointment.date) und das Attribute auf visit_date.

4. Fügen Sie nach dem Webhook-Schritt ein Time Delay-Element hinzu. Wählen Sie Based on user/event data, setzen Sie Get date from auf Event, setzen Sie Event auf den Webhook-Schritt anhand des von Ihnen vergebenen Namens (Get appointment details), setzen Sie Event value auf visit_date und stellen Sie die Verzögerung auf Before 2 Days ein.

5. Wenn Benutzer weniger als 2 Tage vor dem Besuch buchen können, aktivieren Sie Split to branches if the date’s in the past or date is empty auf dem Time Delay-Element. Dies erstellt zwei Zweige, In the past und In the future. Siehe Zweige aufteilen, wenn das Datum in der Vergangenheit liegt oder leer ist.
6. Fügen Sie einen Push-Schritt mit Ihrer Erinnerungsnachricht hinzu. Wenn die Aufteilung aktiviert ist, fügen Sie diesen Push in beiden Zweigen hinzu: In the past (sofort senden) und In the future (nach Time Delay).
7. Beenden Sie jeden Zweig – fügen Sie ein Exit-Element hinzu oder lassen Sie ihn ohne ausgehende Verbindung.

Vorsicht

Wenn der zugeordnete Wert fehlt oder kein gültiges Datum ist, verlässt der Benutzer die Journey an diesem Schritt mit einem Fehler.

Wenn der Besuch weniger als 2 Tage entfernt ist, liegt das Ziel Before 2 Days bereits in der Vergangenheit, wenn der Benutzer Time Delay erreicht, und der Benutzer verlässt die Journey ohne Fehler und ohne Erinnerung, es sei denn, Sie aktivieren Split to branches if the date’s in the past or date is empty.

Im Gegensatz zu Update user profile, das das Tag unverändert lässt und fortfährt, stoppt Time Delay den Benutzer, wenn das Datum fehlt, ungültig ist oder in der Vergangenheit liegt (ohne Zweigaufteilung). Stellen Sie sicher, dass Ihr Webhook zuverlässig ein Datum in einem unterstützten Format zurückgibt. Führen Sie vor dem Start Test webhook aus. Erfahren Sie mehr.

Vergleichen eines Webhook-Wertes in Condition split

Condition split verzweigt auf ein Segment, ein Tag oder ein Event-Attribut mit einem deklarierten Typ. Ein aus einer Webhook-Antwort zugeordneter Wert hat keinen Typ, daher erscheint er nicht in den Dropdown-Menüs von Condition split und kann nicht direkt verglichen werden.

Um auf einen Webhook-Wert zu verzweigen, speichern Sie ihn zuerst als Tag des passenden Typs mit Update user profile und vergleichen Sie dann dieses Tag in Condition split.

Beispiel: Verzweigung basierend auf einem Webhook-Guthaben im Vergleich zum Betrag des auslösenden Events

Ein Benutzer fordert einen Kauf an, und die Journey prüft, ob sein CRM-Guthaben den Preis aus dem auslösenden Event deckt, bevor sie fortfährt.

Journey-Ablauf: Trigger-based Entry → Webhook → Update user profile → Condition split

1. Erstellen Sie eine Journey mit Trigger-based Entry für das PurchaseRequested-Event mit einem numerischen Attribut required_amount.
2. Fügen Sie nach dem Eingangsschritt ein Webhook-Element hinzu. Setzen Sie in Response mapping den Path auf das Guthabenfeld in der Antwort (z. B. current_balance) und das Attribute auf current_balance.
3. Fügen Sie nach dem Webhook-Schritt ein Update user profile-Element hinzu. Setzen Sie in Dynamic Tag Value das Tag auf ein numerisches Tag vom Typ Integer oder Price (erstellen Sie es bei Bedarf im Voraus, z. B. Current_balance), das Event auf den Webhook-Schritt und den Dynamic Value auf current_balance.
4. Fügen Sie nach Update user profile ein Condition split-Element hinzu. Setzen Sie die Bedingung auf Tag Current_balance, Operator greater or equals, und wählen Sie für den Wert Event attribute → das Eingangs-Event → required_amount anstelle einer Konstante.
5. Verbinden Sie jeden Zweig mit den nächsten Schritten.

Hinweis

Das Tag und das Event-Attribut müssen vom gleichen Typ sein (beide numerisch), damit der Vergleich funktioniert.

Wichtige Hinweise

• Pfadsyntax: Verwenden Sie einen durch Punkte getrennten Pfad (z. B. data.user.id) oder ein *-Segment, um jedes Element eines Arrays zuzuordnen. Filter werden nicht unterstützt. Siehe Jedes Element eines Arrays zuordnen für Details.
• Antwortgröße: Antworten, die größer als 64 KB sind, werden für die Zuordnung nicht verarbeitet.
• Condition split: Ein zugeordneter Webhook-Wert hat keinen Typ und kann nicht direkt verwendet werden. Speichern Sie ihn zuerst als Tag. Siehe Vergleichen eines Webhook-Wertes in Condition split.
• Testen: Führen Sie Test webhook im Webhook-Element aus, bevor Sie zugeordnete Werte in einer Live-Journey verwenden. Bestätigen Sie, dass die Anfrage erfolgreich ist, und überprüfen Sie dann den Antwortkörper mit jedem Path im Tab Calls log. Wenn ein Wert für einen bestimmten Reisenden falsch aussieht, sobald die Journey live ist, überprüfen Sie die Zeile dieses Reisenden im Calls log.
• Listen in der Antwort: Verwenden Sie * im Path, um jedes Element zuzuordnen. Wählen Sie item_{n} für separate Attribute oder einen Namen ohne {n} für eine einzelne, durch Kommas getrennte Zeichenfolge. Path-Indizes beginnen bei 0. {n}-Namen beginnen bei 1. Es werden höchstens die ersten 50 Elemente zugeordnet. Siehe Jedes Element eines Arrays zuordnen.