Front

Mit der Integration von Front können Sie die Braze-Datentransformation und Webhooks beider Plattformen nutzen, um eine bidirektionale SMS-Pipeline für Konversationen einzurichten.

Der eingehende Webhook von Front enthält eine Nutzlast mit der vom Live-Agenten gesendeten Nachricht. Die Anfrage muss neu formatiert werden, bevor sie von Braze-Endpunkten akzeptiert werden kann. Das Front-Datentransformations-Template formatiert die Nutzlast um und schreibt ein angepasstes Event mit dem Titel Outbound SMS Sent in das Nutzerprofil, wobei der Nachrichtentext als Event-Eigenschaft übergeben wird.

Bevor Sie eine neue Transformation in Braze einrichten, empfehlen wir Ihnen, die Support-Matrix für jede Ebene in unserer Dokumentation zur Datentransformation zu lesen. Unsere Free- und Pro-Tiers bieten eine unterschiedliche Anzahl aktiver Transformationen und eingehender Anfragen pro Monat. Vergewissern Sie sich, dass Ihr aktueller Plan Ihren Anwendungsfall unterstützen kann.

Voraussetzungen

Bevor Sie beginnen, benötigen Sie Folgendes:

Anwendungsfälle

• Optimieren Sie Ihren Lead-Generierungsprozess mit automatisiertem SMS-Messaging von Braze, um Nutzerpräferenzen zu erkennen und Live-Vertriebsmitarbeitern die Möglichkeit zu geben, nachzufassen und Verkäufe abzuschließen.
• Binden Sie Kund:innen, die ihren Warenkorb verlassen haben, erneut ein, indem Sie Conversions durch automatisierte SMS-Antworten und Live-Chat-Support fördern.

Front integrieren

1. Schritt: Datentransformation erstellen

Zunächst erstellen Sie eine neue Datentransformation in Braze. Die folgenden Schritte sind vereinfacht. Eine vollständige Anleitung finden Sie unter Transformation erstellen.

1. Gehen Sie in Braze zu Dateneinstellungen > Data Transformations und wählen Sie dann Create Transformation.
2. Wählen Sie unter Editing Experience die Option Start from scratch.
3. Wählen Sie unter Select Destination die Option POST: Track Users.

4. Kopieren Sie das folgende Transformations-Template, fügen Sie es ein, speichern und aktivieren Sie den Endpunkt.

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
    // This is a default template that you can use as a starting point. Feel free to delete this entirely to start from
    // scratch, or to delete specific components as you see fit
   
    // First, this code defines a variable, "brazecall", to build up a /users/track request
    // Everything from the incoming webhook is accessible via the special variable "payload". As such, you can template in
    // desired values in your /users/track request with JS dot notation, such as payload.x.y.z
   
    let brazecall = {
    "events": [
      {
      "phone": payload.recipients[1].handle,
      "_update_existing_only": true,
      "name": "Outbound SMS Sent",
      "time": new Date().toISOString(),
      "properties": {
        "message_id": payload.id,
        "message_body": payload.body,
        "front_author_username": payload.author.username
      }
      }
    ]
    };
   
    // After the /users/track request is assigned to brazecall, you will want to explicitly return brazecall to create an output
    return brazecall;
   

   Ihre Transformation sollte dem JavaScript-Beispiel oben entsprechen; passen Sie Eigenschaftsnamen und Pfade an die Payload Ihres Front-Webhooks an.

Tipp

Sie können dieses Template an Ihre speziellen Bedürfnisse anpassen. Sie können zum Beispiel den voreingestellten Namen des angepassten Events ändern. Weitere Informationen finden Sie unter Übersicht über Datentransformationen.

2. Schritt: Ausgehende SMS-Campaign erstellen

Als Nächstes erstellen Sie eine SMS-Campaign, die auf Webhooks von Front wartet und eine angepasste SMS-Antwort an Ihre Kund:innen sendet.

Schritt 2.1: Nachricht verfassen

Fügen Sie in das Textfeld Message den folgenden Liquid-Code ein, zusammen mit einer Opt-out-Sprache oder anderen statischen Inhalten.

1
{{event_properties.${message_body}}}

Ihre Nachricht sollte in etwa so aussehen:

2.2 Zustellung planen {#22-schedule-the-delivery}

Wählen Sie als Zustellungstyp Aktionsbasierte Zustellung und dann als angepassten Event-Trigger Outbound SMS Sent.

Hinweis

Bei diesem angepassten Event handelt es sich um die Datentransformation, die in das Profil der Nutzer:innen geschrieben wird. Nachrichten von Agenten werden als Event-Eigenschaft dieses Events gespeichert.

Aktivieren Sie abschließend unter Zustellungs-Kontrollgruppen die Wiederzulassung.

3. Schritt: Angepassten Kanal erstellen

Gehen Sie im Front-Dashboard zu Settings > Channels > Add Channels, wählen Sie dann Custom Channel und geben Sie einen Namen für Ihren neuen Braze-Kanal ein.

4. Schritt: Einstellungen konfigurieren

Geben Sie im Feld für den ausgehenden API-Endpunkt die Datentransformations-Webhook-URL ein, die Sie zuvor erstellt haben. Alle ausgehenden Nachrichten von Live-Agenten auf Ihrem neuen Braze-Kanal werden hierher gesendet. Dieser Kanal stellt auch eine Endpunkt-URL bereit, an die Braze SMS-Nachrichten im Feld Incoming URL weiterleiten kann.

Notieren Sie sich diese URL—Sie werden sie später benötigen.

5. Schritt: Eingehende SMS-Weiterleitung einrichten

Als Nächstes erstellen Sie zwei neue Webhook-Campaigns in Braze, damit Sie eingehende SMS von Kund:innen an den Posteingang von Front weiterleiten können.

Schritt 5.1: SMS-Schlüsselwortkategorie erstellen

Gehen Sie im Braze-Dashboard auf Zielgruppe, wählen Sie Ihre SMS-Abo-Gruppe und wählen Sie dann Add Custom Keyword. Um eine exklusive SMS-Schlüsselwortkategorie für Front zu erstellen, füllen Sie die folgenden Felder aus.

Schritt 5.2: Erste Webhook-Campaign erstellen

Erstellen Sie im Braze-Dashboard Ihre erste Webhook-Campaign mit der URL, die Sie zuvor erstellt haben.

Fügen Sie Ihrem Anfrage-Text Folgendes hinzu:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
 "sender": {
  "handle": "{{${phone_number}}}",
  "name": "{{${user_id}}}"
 },
 "body_format": "markdown",
 "metadata": {
  "headers": {
   "first_name": "{{${first_name}}}",
   "last_name": "{{${last_name}}}"
  }
 },
 "body": "{{sms.${inbound_message_body} | default : "no body available" }}"
}

Konfigurieren Sie auf dem Tab „Einstellungen“ die Anfrage-Header Authorization, content-type und accept.

Schritt 5.3: Erste Zustellung planen

Wählen Sie für Zustellung planen die Option Aktionsbasierte Zustellung und dann als Trigger-Typ Send an SMS Inbound Message. Fügen Sie außerdem die SMS-Abo-Gruppe und die Schlüsselwortkategorie hinzu, die Sie zuvor eingerichtet haben.

Aktivieren Sie unter Zustellungs-Kontrollgruppen die Wiederzulassung.

Schritt 5.4: Zweite Webhook-Campaign erstellen

Da Ihre zweite Webhook-Campaign mit der ersten übereinstimmt, können Sie die erste duplizieren und umbenennen.

Schritt 5.5: Zweite Zustellung planen

Legen Sie für Zustellung planen den aktionsbasierten Trigger und die SMS-Abo-Gruppe genauso fest wie bei der ersten Zustellung. Wählen Sie jedoch für die Keyword Category die Option Other.

Schritt 5.6: Zielgruppen-Filter hinzufügen

Ihre Webhook-Campaign kann jetzt eingehende SMS-Antworten Ihrer Kund:innen weiterleiten. Um SMS-Antworten zu filtern, sodass nur Nachrichten für Live-Chats weitergeleitet werden, fügen Sie den Segmentierungsfilter Last Received Message From Specific Campaign zum Schritt Zielgruppe hinzu.

Konfigurieren Sie dann Ihren Filter:

1. Wählen Sie unter Campaign die SMS-Campaign aus, die Sie zuvor erstellt haben.
2. Wählen Sie für Operator die Option Less Than.
3. Wählen Sie für Time Window die Zeitspanne, die ein Chat ohne Antwort der Kund:innen geöffnet bleiben soll.

Überlegungen

Abrechenbare Segmente

• SMS-Nachrichten werden bei Braze pro Nachrichten-Segment berechnet. Wenn Sie verstehen, was ein Segment definiert und wie diese Nachrichten aufgeteilt werden, können Sie besser nachvollziehen, wie Ihnen Nachrichten in Rechnung gestellt werden. Weitere Informationen finden Sie in unserer Dokumentation.
• Lange Agentenantworten verbrauchen mehr abrechenbare Segmente.

Datenpunkte protokollieren

Derzeit erfordert diese Integration, dass jedes Mal ein angepasstes Event in ein Nutzerprofil geschrieben wird, wenn ein Live-Agent eine SMS von Front sendet. Dies mag für einen schnellen Austausch mit nur wenigen Nachrichten geeignet sein – aber je länger die Konversationen werden, desto mehr Datenpunkte fallen an. Wenn Sie Fragen zu den Feinheiten der Braze-Datenpunkte haben, kann Ihr Braze Account Manager diese beantworten.

Links in SMS-Nachrichten einfügen

Das Senden eines Links aus dem Front-Live-Chat wird mit zusätzlichen HTML-Tags dargestellt.

Bilddatei von Front anhängen

Bilddateien in Front werden in SMS-Nachrichten, die von Braze gesendet werden, nicht dargestellt.

Opt-outs

Bei Konversationsnachrichten besteht ein höheres Risiko, dass sie das Wort „Stopp“ oder ähnliche Formulierungen enthalten, die als unscharfe Opt-outs erkannt werden können.