Groupes d’abonnement SMS, MMS et RCS

Les groupes d’abonnement constituent la base de l’envoi de messages SMS, MMS et RCS via Braze. Un groupe d’abonnement est un ensemble d’entités d’envoi (telles que des expéditeurs vérifiés RCS, des codes courts SMS, des codes longs SMS ou des identifiants d’expéditeur alphanumériques SMS) utilisées pour un type spécifique d’envoi de messages. Par exemple, si une marque prévoit d’envoyer des messages SMS transactionnels et promotionnels, deux groupes d’abonnement avec des pools distincts de numéros de téléphone d’envoi devront être configurés dans votre tableau de bord de Braze.

Remarque

Vous pouvez ajouter jusqu’à 350 groupes d’abonnement par espace de travail.

États des groupes d’abonnement

Il existe deux états d’abonnement pour les utilisateurs SMS et RCS : subscribed et unsubscribed. L’état d’abonnement d’un utilisateur est défini au niveau du groupe d’abonnement et n’est pas partagé entre les groupes d’abonnement, ce qui signifie qu’un utilisateur peut être subscribed à un groupe d’abonnement transactionnel mais unsubscribed d’un groupe promotionnel. Pour les marques, cette séparation des états garantit qu’elles peuvent continuer à envoyer des messages SMS et RCS pertinents à leurs utilisateurs.

Définir l’état d’un utilisateur

Lorsqu’un numéro de téléphone est mis à jour sur un profil utilisateur, le nouveau numéro de téléphone hérite du statut du groupe d’abonnement de l’utilisateur. Si le numéro de téléphone est remplacé par un numéro qui existe déjà dans Braze, le statut d’abonnement de ce numéro de téléphone existant est hérité.

Par exemple, si l’utilisateur A possède un numéro de téléphone abonné à plusieurs groupes d’abonnement et que ce numéro est ensuite ajouté à l’utilisateur B, l’utilisateur B est abonné aux mêmes groupes d’abonnement. Pour empêcher un utilisateur d’hériter des abonnements existants, vous pouvez réinitialiser les groupes d’abonnement de l’ancien numéro via la REST API de Braze chaque fois qu’un utilisateur change de numéro. Si plusieurs utilisateurs partagent ce numéro de téléphone, ils sont tous désabonnés.

Pour définir l’état du groupe d’abonnement d’un utilisateur, utilisez l’une des méthodes suivantes :

• REST API : Les profils utilisateur peuvent être définis de manière programmatique via l’endpoint /subscription/status/set en utilisant la REST API de Braze.
• Intégration SDK : Les utilisateurs peuvent être ajoutés à un groupe d’abonnement e-mail ou SMS et RCS en utilisant la méthode addToSubscriptionGroup pour Android, iOS ou Web.
• Formulaire de capture de numéro de téléphone par message in-app : Les numéros de téléphone des utilisateurs peuvent être collectés via le modèle de capture de numéro de téléphone dans l’éditeur par glisser-déposer de messages in-app.
• Gestion automatique lors de l’abonnement/désabonnement de l’utilisateur : Lorsque les utilisateurs envoient un mot-clé d’abonnement ou de désabonnement par défaut, Braze définit et met à jour automatiquement l’état d’abonnement des utilisateurs.
• Importation d’utilisateurs : Les utilisateurs peuvent être ajoutés à des groupes d’abonnement e-mail ou SMS et RCS via Import Users. Lors de la mise à jour du statut du groupe d’abonnement, vous devez avoir ces deux colonnes dans votre CSV : subscription_group_id et subscription_state. Consultez Importation d’utilisateurs pour plus d’informations.
• Tableau de bord de Braze : Sélectionnez User Search dans la barre latérale, ouvrez le profil d’un utilisateur et mettez à jour les groupes d’abonnement SMS ou RCS sous Contact Settings dans l’onglet Engagement.
• Cloud Data Ingestion (CDI) : Incluez subscription_group_id et subscription_state dans les lignes synchronisées. Consultez Configuration des tables Cloud Data Ingestion.
• Étape de mise à jour de l’utilisateur : Mettez à jour le statut d’abonnement dans un Canvas avec une étape User Update. Consultez Mettre à jour l’état d’un utilisateur dans un Canvas pour les considérations de timing.

Mettre à jour l’état d’un utilisateur dans un Canvas

Lorsque vous mettez à jour le statut du groupe d’abonnement d’un utilisateur dans le cadre d’un flux Canvas, utilisez une étape User Update plutôt qu’un webhook. L’étape User Update attend que le traitement soit terminé avant de faire avancer l’utilisateur vers l’étape suivante, de sorte que les étapes de communication suivantes utilisent le statut d’abonnement mis à jour.

Si vous utilisez un webhook pour mettre à jour les groupes d’abonnement, l’utilisateur avance dès que le webhook est envoyé, et non lorsque le changement d’abonnement a fini d’être traité. Cela peut créer une condition de concurrence où une étape SMS de suivi s’exécute avant que l’utilisateur ne soit abonné, ce qui entraîne l’échec du message pour une partie des utilisateurs. Si vous devez utiliser un webhook, ajoutez une étape de délai d’au moins 1 minute avant l’étape de communication suivante.

Comment Braze gère les états d’abonnement orphelins

Un état d’abonnement orphelin est un état d’abonnement stocké pour un numéro de téléphone ou une adresse e-mail qui n’est associé à aucun profil utilisateur. Pour les SMS, l’e-mail, WhatsApp et LINE, Braze gère les états d’abonnement orphelins de la manière suivante :

• Si un utilisateur est supprimé et qu’il est le seul utilisateur associé à un numéro de téléphone ou une adresse e-mail donné, l’état d’abonnement de ce numéro de téléphone ou de cette adresse e-mail est immédiatement supprimé.
• Si vous appelez /subscription/status/set ou /v2/subscription/status/set avec un numéro de téléphone ou une adresse e-mail qui n’est actuellement associé à aucun profil utilisateur, Braze stocke cet état d’abonnement pendant 30 jours maximum, après quoi il est automatiquement supprimé.
  • Si use_double_opt_in_logic est défini sur true et qu’aucun profil utilisateur n’est associé au numéro de téléphone fourni, l’état d’abonnement n’est pas mis à jour ; un utilisateur doit exister pour entrer dans le workflow de double abonnement.
• Si un nouveau profil utilisateur est créé avec un numéro de téléphone ou une adresse e-mail pour lequel un état d’abonnement orphelin est stocké, cet utilisateur hérite de l’état d’abonnement stocké, mais uniquement dans la fenêtre de 30 jours. Ce délai de grâce de 30 jours est intentionnel et existe pour gérer les conditions de concurrence lorsque la création d’un utilisateur et la définition de l’état d’abonnement de son identifiant de canal se produisent dans des appels API distincts. Un exemple de cette condition de concurrence est lorsqu’une requête /subscription/status/set est traitée pour un numéro de téléphone avant que la requête /users/track créant le profil utilisateur correspondant ne soit traitée.

Vérifier le groupe d’un utilisateur

Pour vérifier le groupe d’abonnement d’un utilisateur, utilisez l’une des méthodes suivantes :

• Profil utilisateur : Les profils utilisateur individuels sont accessibles via le tableau de bord de Braze en sélectionnant User Search dans la barre latérale. Vous pouvez rechercher des profils utilisateur par adresse e-mail, numéro de téléphone ou identifiant utilisateur externe. Dans un profil utilisateur, sous l’onglet Engagement, vous pouvez consulter les groupes d’abonnement SMS et RCS d’un utilisateur.
• REST API : Le groupe d’abonnement d’un profil utilisateur individuel peut être consulté via l’endpoint Répertorier les groupes d’abonnement d’un utilisateur ou l’endpoint Répertorier le statut du groupe d’abonnement d’un utilisateur en utilisant la REST API de Braze.

Envoyer des messages avec un groupe d’abonnement

Pour lancer une campagne SMS ou RCS via Braze, sélectionnez un groupe d’abonnement dans le menu déroulant SMS/MMS/RCS Variants. Une fois sélectionné, un filtre d’audience est automatiquement ajouté à votre campagne ou Canvas, garantissant que seuls les utilisateurs subscribed au groupe d’abonnement sélectionné font partie de l’audience cible.

Avant que les utilisateurs puissent recevoir des messages d’une campagne ou d’un Canvas, ils doivent être abonnés au groupe d’abonnement sélectionné. Si les envois échouent pour des utilisateurs par ailleurs valides, confirmez qu’ils sont abonnés en utilisant l’une des méthodes décrites dans Définir l’état d’un utilisateur. Pour les exigences de double abonnement, consultez États des groupes d’abonnement.

Important

Conformément aux lois et réglementations internationales en matière de télécommunications, Braze n’envoie jamais de SMS ou de RCS aux utilisateurs qui ne sont pas abonnés au groupe d’abonnement sélectionné.

Bonnes pratiques pour les groupes d’abonnement SMS

Concevez des groupes d’abonnement SMS distincts pour chaque objectif de communication (par exemple, transactionnel versus marketing) et pour chaque espace de travail. Lorsque vous opérez dans plusieurs pays, envisagez des groupes séparés par région afin de respecter les règles de conformité locales — par exemple, les restrictions du Brésil sur les fenêtres d’envoi promotionnel.

Activer les groupes d’abonnement

Pour activer les groupes d’abonnement pour les SMS, MMS ou RCS, consultez les informations suivantes :

• sms
• mms
• rcs

Gérer les désabonnements en langage naturel dans la console Agent

Pour une gestion complète des abonnements, vous pouvez capturer les intentions de désabonnement qui ne correspondent pas aux mots-clés standard ou personnalisés (comme « Ne m’envoyez plus de SMS »). En créant un agent IA, vous pouvez utiliser l’analyse de sentiment pour identifier et traiter automatiquement ces demandes.

Configuration

1. Dans la console Agent, créez un « Agent d’analyse de sentiment SMS ».

Conseil

Utilisez Operator pour vous aider dans la configuration initiale de l’agent.

2. Créez un Canvas basé sur une action, déclenché par Send an SMS inbound message, dans la catégorie de mots-clés Other.
3. Ajoutez l’étape Agent au Canvas pour identifier l’intention de désabonnement.
4. Ajoutez une étape Message SMS ultérieure pour confirmer la demande : « Il semble que vous souhaitiez vous désabonner des SMS, nous allons donc vous désabonner. Si c’est une erreur, envoyez START pour vous réabonner. »
5. Ajoutez une étape Mise à jour de l’utilisateur pour modifier le statut de l’utilisateur dans le groupe d’abonnement SMS spécifique en « Désabonné ».

Remarque

L’utilisation de la console Agent consomme des crédits de messages ou d’actions.

Migrer le trafic SMS vers RCS

Si vous avez des groupes d’abonnement SMS et RCS distincts, vous pouvez migrer les utilisateurs de SMS vers RCS à l’aide d’un Canvas en une seule étape.

Braze recommande de tester l’envoi de RCS à des volumes d’utilisateurs plus réduits dans un premier temps, puis de migrer progressivement davantage d’utilisateurs vers le groupe d’abonnement RCS. Par exemple, si vous avez 1 000 000 d’utilisateurs abonnés à un groupe d’abonnement SMS, cela pourrait consister à d’abord migrer tous les utilisateurs vers le nouveau groupe d’abonnement, puis à segmenter sur une audience plus restreinte de 50 000 à 100 000 (5-10 %) pour tester les messages RCS.

Étape 1 : Créer un Canvas et remplir le calendrier d’entrée

Créez un Canvas et donnez-lui un nom facilement identifiable (par exemple « Transfert d’utilisateurs du groupe d’abonnement SMS vers RCS »). Ensuite, planifiez la campagne au moment qui vous convient.

Étape 2 : Définir votre audience

Définissez votre audience en utilisant l’une des méthodes suivantes. Ensuite, accédez à l’étape Paramètres d’envoi et sélectionnez Utilisateurs abonnés ou ayant donné leur accord.

Étape 3 : Configurer une étape de mise à jour utilisateur

Ajoutez une étape de mise à jour utilisateur à votre Canvas. Dans cette étape, ouvrez l’éditeur JSON avancé et saisissez le code suivant (pour le champ d’identifiant utilisateur unique, nous recommandons d’utiliser le champ braze_id) :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "attributes": [
    {
      "braze_id": "{{${braze_id}}}",
      "subscription_groups": [
        {
          "subscription_group_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
          "subscription_state": "subscribed",
          "use_double_opt_in_logic": true
        }
      ]
    }
  ]
}

Important

Lorsque vous utilisez use_double_opt_in_logic, un profil utilisateur doit déjà exister pour que l’état d’abonnement soit mis à jour. Si aucun profil utilisateur n’est associé à l’identifiant fourni, l’état d’abonnement n’est pas mis à jour.

Étape 4 : Tester le Canvas

Nous vous recommandons vivement de tester votre Canvas pour confirmer qu’il fonctionne comme prévu avant de l’envoyer à votre audience plus large.

Étape 5 : Lancer votre Canvas

Après avoir testé votre Canvas avec succès, lancez-le pour votre sous-ensemble d’utilisateurs !

Pour confirmer que vos utilisateurs ont été migrés avec succès, nous vous recommandons de vérifier quelques profils utilisateur individuels qui ont été mis à jour. Dans l’onglet Engagement, recherchez Paramètres de contact et faites défiler pour voir les groupes d’abonnement auxquels l’utilisateur est abonné. Le bouton du groupe d’abonnement RCS devrait maintenant être activé.

Pour la configuration de l’expéditeur RCS et du groupe d’abonnement, consultez également Configurer RCS.

Bonnes pratiques

Désigner des groupes d’abonnement distincts

• Type de communication : Créez des groupes d’abonnement distincts pour chaque type de communication, comme les messages transactionnels et marketing.
• Espace de travail : Créez des groupes d’abonnement distincts pour chaque espace de travail afin de maintenir la clarté et l’organisation.

Prenons l’exemple suivant avec quatre groupes d’abonnement répartis sur deux espaces de travail :

• Espace de travail de production
  • Marketing - PROD pour SMS
  • Transactional - PROD pour SMS
• Espace de travail de développement (pour les tests)
  • Marketing - DEV pour SMS
  • Transactional - DEV pour SMS

Utiliser des conventions de nommage claires

Choisissez des noms de groupes d’abonnement descriptifs et clairs afin que le bon groupe soit sélectionné lors de la création de Campaigns SMS.

Séparer les groupes par pays

Les réglementations SMS varient selon les pays. Nous vous recommandons de séparer les groupes d’abonnement SMS par pays. Cela vous aide à respecter les normes de conformité dans toutes les régions où vous envoyez des messages.

Pour chaque groupe d’abonnement, vous pouvez également configurer une liste de pays autorisés sous Autorisations géographiques afin que les SMS, MMS et RCS ne soient envoyés que vers des régions approuvées. Pour en savoir plus, consultez Autorisations géographiques.

Par exemple, au Brésil, l’envoi de messages marketing en dehors des heures de 9 h à 21 h (heure locale) est interdit, et le pays couvre trois fuseaux horaires. Pour respecter ces réglementations, vous pourriez configurer des groupes distincts pour l’envoi de messages au Brésil et aux États-Unis. Cela empêche les utilisateurs au Brésil de recevoir des messages marketing pendant les heures interdites.