Integration für eingehende Webhooks

Eingehende Webhooks ermöglichen es externen Diensten, Events direkt an Pushwoosh zu senden. Wenn ein Drittanbietersystem einen Webhook auslöst, authentifiziert Pushwoosh die Anfrage, identifiziert den Abonnenten und löst das zugeordnete Event aus. Das Event kann dann eine Journey starten oder voranbringen.

Verwenden Sie eingehende Webhooks, um Tools wie CRMs, E-Commerce-Plattformen oder Analysedienste zu verbinden, ohne einen eigenen Server erstellen oder warten zu müssen. Jeder eingehende Webhook löst ein Pushwoosh-Event aus, wenn eine passende Anfrage empfangen und erfolgreich verarbeitet wird.

Bevor Sie beginnen

Bereiten Sie Folgendes vor, bevor Sie die Webhook-Einrichtung öffnen.

Entscheiden Sie, welches Pushwoosh-Event der Webhook auslösen soll. Wählen Sie ein bestehendes Event aus Ihrem Projekt, das Sie vom Drittanbieterdienst auslösen möchten. Zum Beispiel CheckoutSuccess. Wenn Sie noch kein passendes Event haben, erstellen Sie eines mit den Attributen, die Sie aus den eingehenden Daten füllen möchten.
Stellen Sie sicher, dass Ihr Drittanbieterdienst Webhooks senden kann. Der Dienst muss in der Lage sein, eine HTTP-POST-Anfrage an eine externe URL zu senden, wenn das für Sie relevante Ereignis eintritt, zum Beispiel eine neue Bestellung oder eine Formularübermittlung.
Holen Sie sich eine Beispiel-JSON-Payload von Ihrem Drittanbieterdienst. Dies ist ein kleines Beispiel für die Daten, die der Dienst bei jedem Event sendet. Sie benötigen es, um Payload-Felder den Pushwoosh-Event-Attributen zuzuordnen.

Einen Webhook erstellen

Gehen Sie in Ihrem Pushwoosh-Konto zu Settings → Integrations → Inbound webhooks und klicken Sie auf Settings.

Integrationsseite mit der Karte für eingehende Webhooks und der Schaltfläche „Einstellungen“, um die Webhook-Konfiguration zu öffnen

Klicken Sie auf Create webhook, um den Einrichtungsvorgang zu öffnen.

Bildschirm „Webhook erstellen“ mit Name, Event, Beispiel-Payload und Zuordnung der Benutzerkennung

Geben Sie einen Webhook-Namen ein, damit Sie den Webhook später in der Liste identifizieren können.
Wählen Sie das Pushwoosh-Event aus, das ausgelöst werden soll, wenn der Webhook eine gültige Anfrage erhält. Sie können aus Events wählen, die bereits in Ihrem Projekt vorhanden sind. Wenn Sie zuerst ein Event erstellen müssen, siehe Events.

Webhook-Einrichtungsbildschirm mit dem Dropdown-Menü für Pushwoosh-Events zur Auswahl des auszulösenden Events bei eingehender Anfrage

Fügen Sie unter Match incoming data eine Beispiel-JSON-Payload von Ihrem Drittanbieterdienst ein. Pushwoosh lädt die Payload-Felder automatisch in die Dropdown-Menüs.

Beispiel-Payload:

{
  "user_id": "12345",
  "email_address": "jane@example.com",
  "mobile": "+15551234567",
  "purchase_date": "2024-03-15",
  "order_number": "ORD-001",
  "price": 99.99,
  "payment_state": "success"
}

Wählen Sie unter Identify users by aus, wie Pushwoosh die eingehende Anfrage einem Benutzer zuordnen soll:

User ID: Zuordnung über die interne User ID in Pushwoosh.
Email: Zuordnung über die E-Mail-Adresse.
Phone: Zuordnung über die Telefonnummer.
HWID: Zuordnung über die Geräte-, Browser- oder E-Mail-Kennung.

Wählen Sie im Feld Payload field das Feld aus, das den passenden Wert enthält.

Dropdown-Menüs „Identify users by“ und „Payload field“ mit Tooltip für User ID und HWID auf dem Bildschirm „Match incoming data“

Ordnen Sie jedes Event-Attribut einem Payload-Feld zu. In jeder Zuordnungszeile:

Event attribute: der Attributname in Pushwoosh. Wählen Sie aus den für dieses Event definierten Attributen.
Payload field: das Feld aus der eingehenden Payload, das den Wert enthält.

Ordnen Sie zum Beispiel email zu email_address, total zu price und order_id zu order_number.

Zuordnungszeilen für Event-Attribut und Payload-Feld mit Beispiel-Payload und der Schaltfläche „Reload select options“

Klicken Sie auf + Add attribute, um eine Zeile hinzuzufügen. Klicken Sie auf ×, um eine zu entfernen.

Wenn die Konfiguration abgeschlossen ist, klicken Sie auf Enable. Das Fenster Webhook URL öffnet sich.

Kopieren Sie die Werte und fügen Sie sie in die Webhook-Einstellungen Ihres externen Systems ein:

Kopieren Sie die URL und legen Sie sie als Webhook-Ziel in Ihrem Drittanbieterdienst fest.
Kopieren Sie das Secret und fügen Sie es in Ihrem externen Dienst als Wert für den Authorization-Header ein. Der Wert enthält das Präfix Bearer, verwenden Sie ihn also unverändert. Pushwoosh lehnt jede Anfrage ab, bei der dieser Header fehlt oder nicht übereinstimmt.

Fenster „Webhook URL“ mit den Feldern URL und Secret sowie Kopierschaltflächen für die Konfiguration des externen Systems

Das Fenster zeigt auch eine Example request mit einer Beispiel-POST-Anfrage. Klicken Sie im Beispielblock auf Copy, um die vollständige Anfrage zu kopieren. Verwenden Sie sie, um eine Testanfrage zu senden und zu bestätigen, dass Pushwoosh den Webhook akzeptiert, oder teilen Sie sie mit Ihrem Team als Vorlage für die Integration.

Fenster „Webhook URL“ mit URL, Secret und dem Beispiel-curl-Befehl für die Einrichtung des externen Systems

Nachdem Sie den Webhook aktiviert haben, erscheint er in der Webhooks-Liste mit dem Status „Enabled“ und beginnt, Anfragen anzunehmen.

Webhooks-Liste

Die Liste der eingehenden Webhooks zeigt jeden Webhook in Ihrem Projekt.

Jede Zeile zeigt:

Name: Webhook-Name.
Event: das Pushwoosh-Event, das ausgelöst wird, wenn der Webhook eine gültige Anfrage erhält.
Status: Enabled oder Disabled.
Received: Anzahl der vom Webhook empfangenen Anfragen.
Last updated: wann der Webhook zuletzt geändert wurde.

Liste der eingehenden Webhooks mit Suche, Statusfiltern, Tabellenspalten und geöffnetem Zeilenaktionsmenü

Webhooks verwalten

Öffnen Sie das Zeilenmenü, um:

Edit settings: öffnet die Webhook-Konfiguration, damit Sie den Namen, das Event, die Feldzuordnung und die Benutzeridentifikation ändern können.
Copy URL: öffnet das Fenster Webhook URL mit der URL und dem Secret, damit Sie sie erneut kopieren können.
Activity log: öffnet das Anforderungsprotokoll für diesen Webhook.
Delete: entfernt den Webhook aus der Liste.

Für einen aktivierten Webhook klicken Sie auf Disable, um ihn zu deaktivieren, ohne die Konfiguration zu löschen. Für einen deaktivierten Webhook klicken Sie auf Enable, um wieder Anfragen anzunehmen.

Aktivitätsprotokoll anzeigen

Das Aktivitätsprotokoll zeigt alle eingehenden Anfragen für den ausgewählten Webhook.

Zusammenfassungsfeld

Überprüfen Sie oben die Zusammenfassung für die letzten 24 Stunden:

Hits: Gesamtzahl der eingegangenen Anfragen.
Success: Anfragen, bei denen die Authentifizierung erfolgreich war, der Benutzer gefunden und das Event ausgelöst wurde.
Failed: Anfragen, die nicht verarbeitet wurden. Eine fehlgeschlagene Anfrage stoppt den Webhook nicht. Pushwoosh akzeptiert und verarbeitet weiterhin spätere Anfragen.

Grund des Fehlschlags	Bedeutung
Auth rejected	Das geteilte Geheimnis stimmt nicht mit der Webhook-Konfiguration überein. Wenn fünf aufeinanderfolgende Anfragen mit diesem Fehler fehlschlagen, sendet Pushwoosh Ihnen eine Benachrichtigung. Aktualisieren Sie das Geheimnis, um fortzufahren. Keine Reaktivierung erforderlich.
User identifier field missing	Das für die Benutzeridentifikation zugeordnete Payload-Feld ist in der Anfrage nicht vorhanden.

Anforderungseinträge

Jeder Eintrag zeigt die Benutzerkennung (zum Beispiel User ID oder Email), ein Success- oder Failed-Badge, den Zeitstempel der Anfrage und eine Vorschau der empfangenen JSON-Payload. Klicken Sie auf Show, um die vollständigen Anfragedetails zu erweitern.

Anforderungseintrag im Aktivitätsprotokoll mit Benutzerkennung, Erfolgs- oder Fehlschlags-Badge, Zeitstempel, JSON-Payload und der Schaltfläche „Show“

Von Webhooks ausgelöste Events im User Explorer anzeigen

Wenn eine Webhook-Anfrage erfolgreich verarbeitet wird, zeichnet Pushwoosh das Event im User Explorer auf. Wo es erscheint, hängt davon ab, wie Sie den Benutzer identifiziert haben:

User ID, Email oder Phone: Das Event wird im Benutzerprofil aufgezeichnet. Öffnen Sie den Benutzer und gehen Sie zu Events history.
HWID: Das Event wird auf dem passenden Gerät aufgezeichnet. Öffnen Sie den Benutzer, finden Sie das Gerät unter Active user devices und gehen Sie zu dessen Events history-Tab.

Finden Sie das Event nach Namen und erweitern Sie es, um die zugeordneten Attribute (zum Beispiel price oder products) und das __webhook-Attribut mit der Webhook-ID zu sehen.

Tab „Events history“ im User Explorer, der ein eingehendes Webhook-Event mit erweiterten Attributen einschließlich der __webhook-ID und zugeordneten Payload-Feldern anzeigt

Eingehende Webhooks mit Journeys verwenden

Nachdem ein Webhook aktiviert ist und erfolgreich Events auslöst, verwenden Sie das ausgewählte Event als triggerbasierten Journey-Einstieg. Wenn der Webhook eine gültige Anfrage erhält, löst Pushwoosh das zugeordnete Event aus. Jede Journey, die dieses Event als Einstiegstrigger verwendet, startet automatisch für den zugeordneten Benutzer.