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 un payload comprenant le message envoyé par l’agent. La requête devra être reformatée avant de pouvoir être acceptée par les endpoints de Braze. Le modèle de Transformation des données de Front reformatera le payload et écrira un événement personnalisé dans le profil utilisateur intitulé Outbound SMS Sent, 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. Vérifiez que le plan auquel vous avez souscrit peut prendre en charge votre cas d’utilisation.

Conditions préalables

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

Cas d’utilisation

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

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, consultez 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 Expérience d’édition, 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 :

   

Conseil

Vous pouvez modifier ce modèle pour répondre à vos besoins spécifiques. Par exemple, vous pouvez personnaliser le nom de l’événement personnalisé prédéfini. Pour plus d’informations, consultez l’aperçu de la Transformation des données.

Étape 2 : Créer une campagne SMS sortante

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

Étape 2.1 : Rédigez 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 Planifier la distribution {#22-schedule-the-delivery} {#22-schedule-the-delivery}

Pour le type de distribution, sélectionnez Livraison par événement ; puis pour le déclencheur d’événement personnalisé, sélectionnez Outbound SMS Sent.

Remarque

Cet événement personnalisé est la Transformation des données qui écrit dans le profil de l’utilisateur. Les messages de l’agent seront enregistrés en tant que propriété de cet événement.

Enfin, sous Contrôles de l’envoi, activez la rééligibilité.

Étape 3 : Créer un canal personnalisé

Dans le tableau de bord de Front, accédez à Settings > Channels > Add Channels, puis sélectionnez Custom Channel et saisissez un nom pour votre nouveau canal Braze.

Étape 4 : Configurer les paramètres

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

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

Étape 5 : Configurer le transfert des SMS entrants

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

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

Dans le tableau de bord de Braze, accédez à Audience, choisissez votre groupe d’abonnement SMS, puis sélectionnez Add Custom Keyword. Pour créer une catégorie de mots-clés SMS exclusive pour Front, remplissez les champs suivants.

Étape 5.2 : Créer 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 Settings, configurez vos en-têtes de requête Authorization, content-type et accept.

Étape 5.3 : Planifier 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 l’envoi, activez la rééligibilité.

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

Comme votre deuxième campagne webhook est identique à la première, vous pouvez dupliquer la première et la renommer.

Étape 5.5 : Planifier la seconde distribution

Pour Schedule Delivery, 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 Other.

Étape 5.6 : Ajouter un filtre d’audience

Votre campagne webhook peut désormais transférer les réponses SMS entrantes de vos clients. Pour filtrer les réponses SMS afin que seuls les messages destinés aux chats en direct soient transférés, ajoutez le filtre de segmentation Last Received Message From Specific Campaign à l’étape Audiences cibles.

Configurez ensuite votre filtre :

1. Pour Campaign, sélectionnez la campagne SMS que vous avez créée précédemment.
2. Pour Operator, sélectionnez Less Than.
3. Pour Time Window, choisissez la durée pendant laquelle un chat doit rester ouvert sans réponse de la part du client.

Considérations

Segments de message facturables

• Chez Braze, les 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 découpés pour savoir comment vous serez facturé. Consultez notre documentation pour plus d’informations.
• Les longues réponses des agents consommeront davantage de segments facturables.

Enregistrement des points de données

Actuellement, cette intégration nécessite l’écriture d’un événement personnalisé dans le profil utilisateur à chaque fois qu’un agent en direct envoie un SMS depuis Front. Cela peut convenir à des échanges rapides qui ne durent que quelques messages, mais au fur et à mesure que les conversations s’allongent, les implications en termes de points de données augmentent également. Si vous avez des questions sur les subtilités des points de données de Braze, votre gestionnaire de compte Braze peut y répondre.

Inclure des liens dans les messages SMS

L’envoi d’un lien depuis le chat en direct de Front ajoutera des balises HTML supplémentaires au rendu.

Joindre un fichier image depuis Front

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

Désabonnements

Les messages conversationnels présentent un risque plus élevé de contenir le mot « stop » ou un terme similaire pouvant être interprété comme une demande de désabonnement approximative.