Zum Inhalt springen
Entwicklerdokumentation Support Demo anfordern Anmelden
Pushwoosh.com

Webhook

Mit Webhooks können Sie Journey-Daten an externe Dienste wie Analyse-Systeme, CRM-Systeme und Marketing-Tools senden. Sie können:

  • Externe Systeme benachrichtigen, wenn ein Kunde eine Aktion in der Journey ausführt
  • Kundendaten an Analyse-Tools senden
  • E-Mails, SMS oder WhatsApp von Drittanbietern bei bestimmten Journey-Ereignissen auslösen

So richten Sie das Webhook-Element ein

Anchor link to

Das Webhook-Element hinzufügen

Anchor link to

Ziehen Sie das Webhook-Element per Drag-and-Drop auf die Arbeitsfläche. Platzieren Sie den Webhook an einer beliebigen Stelle und berücksichtigen Sie dabei, welche Journey-Informationen Sie an einen Drittanbieterdienst senden möchten.

Webhook-Element auf der Arbeitsfläche mit Namens- und Anforderungseinstellungen

Den Webhook-Schritt benennen und die Anforderungs-URL und den Typ angeben

Anchor link to

Geben Sie im Feld SCHRITTNAME einen Namen für den Webhook ein. Es kann praktisch sein, Webhooks nach den Diensten, an die sie Daten senden, oder nach dem Anwendungsfall zu benennen.

Geben Sie als Nächstes im Feld URL die Anforderungs-URL an, an die die Daten gesendet werden sollen. Wählen Sie neben dem URL-Feld den Anforderungstyp aus dem Dropdown-Menü ANFORDERUNGSTYP aus: GET oder POST.

Webhook-Konfigurationsoberfläche mit URL-Feld und Dropdown-Menü ANFORDERUNGSTYP zur Auswahl der GET- oder POST-Methode

Header konfigurieren

Anchor link to

Legen Sie im Abschnitt HEADERS den Inhaltstyp fest.

Standardmäßig ist der Inhaltstyp application/json. Wenn der Dienst, an den Sie den Webhook senden, einen anderen Inhaltstyp erfordert, geben Sie den entsprechenden Wert im Header-Wert Content-Type ein.

Beispiele für Inhaltstypen sind:

  • x-www-form-urlencoded
  • text/plain
  • text/xml

Fügen Sie bei Bedarf zusätzliche Header hinzu, indem Sie auf + HEADER HINZUFÜGEN klicken. Sie können jeden Header entfernen, indem Sie auf das ‘x’-Symbol daneben klicken.

Einige APIs erfordern beispielsweise eine HTTP-Basisauthentifizierung. Um solche Anfragen zu authentifizieren, gehen Sie wie folgt vor:

  1. Öffnen Sie einen einfachen Texteditor und geben Sie Ihren Benutzernamen und Ihr Passwort ohne Leerzeichen ein, getrennt durch einen Doppelpunkt. Zum Beispiel: myuser:mypass
  2. Kodieren Sie diese Zeichenfolge in Base64.
  3. Kopieren Sie die resultierende Base64-Zeichenfolge (zum Beispiel bXl1c2VyOm15cGFzcw==).
  4. Fügen Sie in den Webhook-Einstellungen einen Authorization-Header mit dem Wert hinzu: Basic <IHRE BASE64-ZEICHENFOLGE>. Stellen Sie sicher, dass nach dem Wort „Basic“ ein Leerzeichen steht.
Beispiel für einen Authorization-Header für die Basisauthentifizierung in den Webhook-Einstellungen, der die Header Content-Type und Authorization anzeigt

Den JSON-Anforderungstext hinzufügen

Anchor link to

Geben Sie im Abschnitt DATEN Ihren JSON-Anforderungstext ein. Stellen Sie sicher, dass der Anforderungstext im korrekten JSON-Format vorliegt.

Beispiel:

{
  "hwid": "{{device:hwid}}"
}

Dynamische Daten und Makros verwenden

Anchor link to

Das Panel DATEN-BUILDER ermöglicht es Ihnen, dynamische Informationen (wie Benutzer-, Geräte-, Tag- oder Ereignisdaten) direkt in Ihren JSON-Anforderungstext einzufügen. Mit dynamischen Daten können Sie Werte einfügen, die für den einzelnen Benutzer spezifisch sind, der die Journey durchläuft.

Dazu:

  1. Wählen Sie eine Kategorie aus. Sie können Daten aus drei Kategorien abrufen:

  • Gerät: Verwenden Sie Gerätedaten, wenn Sie technische Informationen benötigen, die mit dem Gerät des Benutzers verknüpft sind.

  • Tag: Verwenden Sie Tag-Daten, wenn Sie Informationen senden möchten, die im Benutzerprofil gespeichert sind.

  • Ereignis: Verwenden Sie Ereignisdaten, wenn der Webhook Werte aus dem auslösenden Ereignis der Journey senden soll.

  1. Wählen Sie einen Parameter aus (zum Beispiel HWID, Lieblingskategorie usw.).
  2. Pushwoosh generiert ein Makro, das wie folgt aussieht:
{{tag:Language}}
  1. Kopieren Sie das Makro und fügen Sie es in Ihren JSON-Text im Abschnitt DATEN ein.

Wenn der Webhook in einer Live-Journey ausgeführt wird, ersetzt Pushwoosh das Makro automatisch durch den tatsächlichen Wert für diesen Benutzer.

Platzhalter für dynamische Daten in den Webhook-Anforderungstext einfügen

Webhook-Antwortdaten Variablen zuordnen

Anchor link to

Neben dem Senden von Daten kann das Webhook-Element auch Daten aus der empfangenen Antwort erfassen und in Variablen umwandeln. Diese Variablen können dann später in der Journey verwendet werden. Setzen Sie zum Beispiel einen Tag mit Benutzerprofil aktualisieren oder planen Sie eine Zeitverzögerung basierend auf einem vom externen Dienst zurückgegebenen Wert. Ein vollständiges Journey-Beispiel finden Sie unter Verwendung von Webhook-Antwortdaten in Ihrer Journey.

Klicken Sie im Abschnitt ANTWORTZUORDNUNG auf + ZUORDNUNG HINZUFÜGEN und füllen Sie für jeden Wert, den Sie erfassen möchten, zwei Felder aus:

  • Pfad: der Speicherort des Wertes im JSON-Antworttext
  • Attribut: der Name, den Sie verwenden, um auf diesen Wert später in der Journey zu verweisen
Abschnitt zur Antwortzuordnung mit den Feldern Pfad und Attribut und der Schaltfläche Zuordnung hinzufügen in den Webhook-Einstellungen

Wenn Ihr CRM beispielsweise mit Folgendem antwortet:

{
  "data": {
    "user": {
      "id": "789xyz"
    }
  }
}

Setzen Sie Pfad auf data.user.id und Attribut auf crm_user_id, um diese ID zu erfassen.

Verwendung von Webhook-Antwortdaten in Ihrer Journey

Den Webhook testen

Anchor link to

Klicken Sie auf Webhook testen, um zu überprüfen, ob Ihre Webhook-Konfiguration korrekt ist und die Anfrage erfolgreich gesendet wird.

Ihre Konfiguration speichern

Anchor link to

Klicken Sie auf Anwenden, um Ihre Webhook-Konfiguration zu speichern.