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 überall dort verwenden können, wo Sie sonst ein Event-Attribut verwenden würden.

Hinweis

Informationen zum Hinzufügen eines Webhook-Elements und zum Konfigurieren der Antwortzuordnung finden Sie unter Webhook.

Speichern eines Webhook-Wertes als Tag mit „Benutzerprofil aktualisieren“

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. Benutzerprofil aktualisieren 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 entsprechenden 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 jedes Mal einen doppelten Datensatz zu erstellen, wenn der Benutzer die Journey erneut betritt.

Journey-Ablauf: Trigger-basierter Einstieg → Webhook → Benutzerprofil aktualisieren → Zweig beenden

1. Erstellen Sie eine Journey mit Trigger-basiertem Einstieg für das SignUp-Event.
2. Fügen Sie nach dem Einstiegsschritt ein Webhook-Element hinzu. Benennen Sie es (z. B. Benutzer im CRM erstellen) und legen Sie die Anfrage-URL auf den Endpunkt zum Erstellen von Benutzern in Ihrem CRM fest.
3. Legen Sie in der Antwortzuordnung den Pfad auf das ID-Feld in der Antwort (z. B. data.user.id) und das Attribut auf crm_user_id fest.

4. Fügen Sie nach dem Webhook-Schritt ein Element Benutzerprofil aktualisieren hinzu.

5. Klicken Sie unter Dynamischer Tag-Wert auf + Dynamischer Wert. Wählen Sie unter Tag den Tag aus, der die CRM-ID speichert (erstellen Sie ihn bei Bedarf im Voraus). Wählen Sie unter Event den Webhook-Schritt anhand des von Ihnen vergebenen Namens aus (Benutzer im CRM erstellen). Wählen Sie unter Dynamischer Wert 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 Pfad konnte nicht aufgelöst werden oder der Aufruf ist fehlgeschlagen), überspringt Pushwoosh diese Tag-Aktualisierung. Der Tag behält seinen vorherigen Wert oder bleibt ungesetzt, und die Journey wird ohne Fehler bei diesem Schritt fortgesetzt. Führen Sie vor dem Start Webhook testen aus, um Ihre Zuordnung zu bestätigen. Erfahren Sie mehr.

Planen einer Verzögerung aus einem Webhook-Wert mit „Zeitverzögerung“

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 Zeitverzögerung die Journey bis zu diesem Moment anhalten, zum Beispiel 2 Tage vor einem Termin, damit die nächste Nachricht rechtzeitig versendet wird.

Beispiel: Planen einer Erinnerung aus einem Datum 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-basiertem Einstieg für das AppointmentBooked-Event.
2. Fügen Sie nach dem Einstiegsschritt ein Webhook-Element hinzu. Benennen Sie es (z. B. Termindetails abrufen) und legen Sie die Anfrage-URL auf die API Ihres Buchungssystems fest.
3. Legen Sie in der Antwortzuordnung den Pfad auf das Datumsfeld in der Antwort (z. B. appointment.date) und das Attribut auf visit_date fest.

4. Fügen Sie nach dem Webhook-Schritt ein Zeitverzögerung-Element hinzu. Wählen Sie Basierend auf Benutzer-/Event-Daten, setzen Sie Datum abrufen von auf Event, setzen Sie Event auf den Webhook-Schritt mit dem von Ihnen vergebenen Namen (Termindetails abrufen), setzen Sie Event-Wert auf visit_date und stellen Sie die Verzögerung auf Vor 2 Tagen ein.

5. Wenn Benutzer weniger als 2 Tage vor dem Besuch buchen können, aktivieren Sie In Zweige aufteilen, wenn das Datum in der Vergangenheit liegt oder leer ist im Zeitverzögerung-Element. Dadurch werden zwei Zweige erstellt: In der Vergangenheit und In der Zukunft. 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 der Vergangenheit (sofort senden) und In der Zukunft (nach der Zeitverzögerung).
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 mit einem Fehler bei diesem Schritt.

Wenn der Besuch weniger als 2 Tage entfernt ist, liegt das Ziel Vor 2 Tagen bereits in der Vergangenheit, wenn der Benutzer die Zeitverzögerung erreicht, und der Benutzer verlässt die Journey ohne Fehler und ohne Erinnerung, es sei denn, Sie aktivieren In Zweige aufteilen, wenn das Datum in der Vergangenheit liegt oder leer ist.

Im Gegensatz zu Benutzerprofil aktualisieren, das den Tag unverändert lässt und fortfährt, stoppt die Zeitverzögerung 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 Webhook testen aus. Erfahren Sie mehr.

Wichtige Hinweise

• Pfadsyntax: Verwenden Sie einen durch Punkte getrennten Pfad (z. B. data.user.id). Platzhalter und Filter werden nicht unterstützt. Weitere Informationen finden Sie unter Webhook-Antwortzuordnung.
• Antwortgröße: Antworten, die größer als 64 KB sind, werden nicht für die Zuordnung verarbeitet.
• Testen: Führen Sie Webhook testen im Webhook-Element aus, bevor Sie zugeordnete Werte in einer Live-Journey verwenden.