Front

L’intégration de Front vous permet de tirer parti de la transformation des données de Braze et des webhooks de chaque plateforme pour mettre en place un pipeline SMS conversationnel bidirectionnel.

Le webhook entrant provenant de Front contiendra une charge utile comprenant le message envoyé par l’agent. La requête devra être reformatée pour pouvoir être acceptée par les endpoints de Braze. Le modèle de transformation des données frontales reformatera la charge utile et écrira un événement personnalisé dans le profil utilisateur intitulé SMS sortant envoyé, le corps du message étant transmis en tant que propriété de l’événement.

Avant de configurer une nouvelle transformation dans Braze, nous vous recommandons de consulter la matrice de prise en charge de chaque niveau dans notre documentation sur la transformation des données. Nos niveaux Free et Pro offrent un nombre différent de transformations actives et de requêtes entrantes par mois. Confirmez que le plan actuel que vous avez souscrit peut prendre en charge votre cas d’utilisation.

Prérequis

Avant de commencer, vous avez besoin des éléments suivants :

Cas d’utilisation

• Rationalisez votre processus de production de prospects en utilisant les messages SMS automatisés de Braze pour identifier les préférences des utilisateurs et permettre aux agents commerciaux en ligne/en de faire le suivi et de conclure des ventes.
• Réengagez les clients qui ont abandonné leur panier en stimulant les conversions de ventes grâce aux réponses automatisées par SMS et à l’assistance directe par chat.

Intégration de Front

Étape 1 : Créer une transformation de données

Tout d’abord, vous allez créer une nouvelle transformation de données dans Braze. Les étapes suivantes sont simplifiées ; pour une description complète, voir Création d’une transformation.

1. Dans Braze, accédez à Paramètres des données > Transformations de données, puis sélectionnez Créer une transformation.
2. Sous Modifier l’expérience, sélectionnez Recommencer à zéro.
3. Sous Sélectionner une destination, sélectionnez POST : Suivre les utilisateurs.

4. Copiez et collez le modèle de transformation suivant, puis enregistrez et activez l’endpoint.

   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;
   

   Votre transformation devrait ressembler à ce qui suit :

   

Étape 2 : Créer une campagne de SMS sortants

Ensuite, vous créerez une campagne SMS qui écoutera les webhooks de Front et enverra une réponse SMS personnalisée à vos clients.

Étape 2.1 : Composez votre message

Dans la zone de texte Message, ajoutez le code Liquid suivant, ainsi que tout texte de désabonnement ou autre contenu statique.

1
{{event_properties.${message_body}}}

Votre message devrait ressembler à ce qui suit :

2.2 Planification de la distribution

Pour le type de distribution, sélectionnez Livraison par événement. Pour le déclencheur d’événement personnalisé, sélectionnez Envoi de SMS sortants.

Enfin, sous Contrôle de la distribution, activez la rééligibilité.

Étape 3 : Créer un canal personnalisé

Dans le tableau de bord de Braze, allez dans Paramètres > Canaux > Ajouter des canaux, puis sélectionnez Canal personnalisé et saisissez un nom pour votre nouveau canal Braze.

Étape 4 : Configurez les paramètres

Dans le champ de l’endpoint API sortant, entrez l’URL du webhook de transformation des données que vous avez créé précédemment. Tous les messages sortants des agents en ligne/en production/instantanée sur votre nouveau canal Braze seront envoyés ici. Ce canal fournit également une URL d’endpoint vers laquelle Braze doit transférer les messages SMS dans le champ URL entrant.

Notez bien cette URL, vous en aurez besoin plus tard.

Étape 5 : Mise en place d’une redirection des SMS entrants

Ensuite, vous allez créer deux nouvelles campagnes webhook à Braze afin de pouvoir transférer les SMS entrants des clients vers la boîte de réception du Front.

Étape 5.1 : Créez une catégorie de mots-clés SMS

Dans le tableau de bord de Braze, allez dans Audience, choisissez votre groupe d’abonnement SMS, puis sélectionnez Ajouter un mot-clé personnalisé. Pour créer une catégorie de mots-clés SMS exclusive pour Front, remplissez les champs suivants.

Étape 5.2 : Créez votre première campagne webhook

Dans le tableau de bord de Braze, créez votre première campagne webhook à l’aide de l’URL que vous avez créée précédemment.

Ajoutez ce qui suit au corps de votre requête :

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" }}"
}

Dans l’onglet Paramètres, configurez vos en-têtes de requête Authorization, content-type et accept.

Étape 5.3 : Planifiez la première distribution

Pour Schedule Delivery, sélectionnez Action-Based Delivery, puis choisissez Send an SMS Inbound Message pour votre type de déclencheur. Ajoutez également le groupe d’abonnement SMS et la catégorie de mots-clés que vous avez définis précédemment.

Sous Contrôles de distribution, activez la rééligibilité.

Étape 5.4 : Créez votre deuxième campagne webhook

Étant donné que votre deuxième campagne webhook correspondra à la première, vous pouvez dupliquer la première et la renommer. Vous pouvez le faire dès maintenant.

Étape 5.5 : Planifiez la seconde distribution

Pour la distribution planifiée, définissez le déclencheur basé sur l’action et le groupe d’abonnement SMS de la même manière que pour la première distribution. Toutefois, pour la catégorie de mots-clés, choisissez Autre.

Étape 5.6 : Ajouter un filtre d’audience

Votre campagne webhook peut désormais transmettre les réponses SMS entrantes de vos clients. Pour filtrer les réponses SMS afin que seuls les messages pour les chats en direct soient transférés, ajoutez le filtre de segmentation Dernier message reçu d’une campagne spécifique à l’étape Audiences cibles.

Configurez ensuite votre filtre :

1. Pour Campagne, sélectionnez la campagne SMS que vous avez créée précédemment.
2. Pour Opérateur, sélectionnez Moins que.
3. Pour Fenêtre de temps, choisissez la durée pendant laquelle un chat doit rester ouvert sans réponse de la part du client.

Considérations

Segments facturables

• Chez Braze, les envois de messages SMS sont facturés par segment de message. Il est essentiel de comprendre ce qui définit un segment et comment ces messages seront répartis pour savoir comment vous serez facturé pour les messages. Vous trouverez plus d’informations dans notre documentation.
• Les longues réponses des agents consommeront davantage de segments facturables.

Consommation de points de données

Actuellement, cette intégration nécessite l’écriture d’un événement personnalisé dans le profil de l’utilisateur à chaque fois qu’un agent en ligne envoie un SMS depuis Front. Cela peut convenir à des échanges rapides qui ne durent que quelques messages, mais lorsque les conversations deviennent plus longues, les points de données deviennent de plus en plus importants. Un point de données est consommé pour chaque événement personnalisé enregistré dans Braze.

Inclure des liens dans les messages SMS

Des balises HTML supplémentaires seront ajoutées à un lien envoyé à partir du chat en direct de Front.

Joindre un fichier image depuis Front

Les fichiers images en Front ne s’afficheront pas dans les messages SMS envoyés par Braze.

Options de désabonnement

Les messages conversationnels risquent davantage de contenir le mot “stop” ou un texte informel similaire pouvant être interprété comme une demande de désabonnement.