Zapier-Integration

Zapier ist ein Web-Automatisierungstool, mit dem Sie Daten zwischen Web-Apps austauschen und diese Informationen dann zur Automatisierung von Aktionen verwenden können.

Die Partnerschaft zwischen Braze und Zapier nutzt die Braze API und Braze-Webhooks, um sich mit Drittanbieter-Anwendungen zu verbinden – wie Google Workplace, Slack, Salesforce, WordPress usw. – und verschiedene Aktionen zu automatisieren.

Voraussetzungen

Integration

Im folgenden Zapier-Beispiel senden wir Informationen von WordPress an Braze über einen POST-Webhook. Diese Informationen können dann zur Erstellung eines Braze-Canvas verwendet werden.

Schritt 1: Erstellen Sie einen Zapier-Trigger

In der Terminologie von Zapier ist ein „Zap“ ein automatisierter Workflow, der Ihre Apps und Dienste miteinander verbindet. Der erste Teil eines Zaps besteht darin, einen Trigger zu bestimmen. Nachdem Ihr Zap aktiviert wurde, führt Zapier automatisch die entsprechenden Aktionen aus, sobald Ihr Trigger erkannt wird.

Anhand unseres WordPress-Beispiels richten wir in der Zapier-Plattform unseren Zap so ein, dass er triggert, wenn ein neuer WordPress-Beitrag hinzugefügt wird, und wählen als Post Status und Post Type die Optionen Published und Posts aus.

Schritt 2: Einen Aktions-Webhook hinzufügen

Definieren Sie als Nächstes die Zap-Aktion. Wenn Ihr Zap aktiviert ist und Ihr Trigger erkannt wird, wird die Aktion automatisch ausgeführt.

Um unser Beispiel fortzusetzen, möchten wir eine POST-Anfrage als JSON an einen Braze-Endpunkt senden. Wählen Sie dazu unter Apps die Option Webhooks aus.

Schritt 3: Braze-POST einrichten

Wenn Sie Ihren Webhook einrichten, verwenden Sie die folgenden Einstellungen und geben Sie Ihren Braze-REST-Endpunkt in der Webhook-URL an. Wenn Sie fertig sind, wählen Sie Publish.

• Method: POST
• Webhook URL: https://rest.iad-01.braze.com/canvas/trigger/send
• Data Pass-Through: False
• Unflatten: No
• Anfrage-Header:
  • Content-Type: application/json
  • Authorization: Bearer YOUR-API-KEY
• Data:

1
2
3
4
5
6
7
8
9
10
11
12

{
  "canvas_id": "your_canvas_identifier",
  "recipients": [
    {
      "external_user_id": "external_user_identifier",
      "context":{
        "string_property": "Your example string",
        "example_integer_property": 1
      }
    }
  ]
}

Schritt 4: Erstellen Sie eine Braze-Campaign

Sobald Sie Ihren Zap erfolgreich eingerichtet haben, können Sie Ihre Braze-Campaigns oder Canvases mit WordPress-Daten anpassen, indem Sie die Informationen in Ihren Nachrichten mit Liquid formatieren.

Zapier mit dem Endpunkt /users/track verwenden

Um Daten an den Braze-Endpunkt /users/track zu senden (zum Beispiel bei Verwendung eines Triggers wie New or Updated Spreadsheet Row in Google Sheets), verwenden Sie Webhooks by Zapier mit einem Custom Request – verwenden Sie nicht die Standard-Aktion POST. Die Standard-POST-Aktion formatiert die Anfrage auf eine Weise, die nicht mit dem Endpunkt /users/track kompatibel ist.

1. Wählen Sie in Zapier Ihren Trigger aus (zum Beispiel New or Updated Spreadsheet Row in Google Sheets).
2. Wählen Sie als Aktion Webhooks by Zapier und dann Custom Request (nicht POST).
3. Setzen Sie die Method auf POST, geben Sie Ihre Braze-REST-Endpunkt-URL ein (zum Beispiel https://rest.iad-01.braze.com/users/track) und formatieren Sie den Anfrage-Body mit doppelten Anführungszeichen um jedes Element, wie Sie es bei einem Postman- oder API-Aufruf tun würden. Ordnen Sie die Felder aus Ihrem Trigger (zum Beispiel Tabellenkalkulationsspalten) an den entsprechenden Stellen im JSON-Body zu.
4. Fügen Sie die erforderlichen Header hinzu:
   • Content-Type: application/json
   • Authorization: Bearer YOUR-REST-API-KEY (verwenden Sie Ihren Braze-REST-API-Schlüssel ohne Klammern oder Anführungszeichen)
5. Testen Sie den Schritt und aktivieren Sie Ihren Zap.