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 dans un but de communication spécifique (par exemple, transactionnel ou promotionnel). Pour un aperçu cross-canal des groupes d’abonnement, consultez Groupes d’abonnement.

Remarque

Vous pouvez ajouter jusqu’à 450 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 mis à jour avec 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 de téléphone est ensuite ajouté à l’Utilisateur B, l’Utilisateur B est abonné aux mêmes groupes d’abonnement. Pour éviter qu’un utilisateur n’hérite 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 : Utilisez l’endpoint /subscription/status/set pour définir de manière programmatique les profils utilisateur avec la REST API de Braze. Chaque requête peut inclure entre 1 et 25 groupes d’abonnement.
• Intégration SDK : Les utilisateurs peuvent être ajoutés ou retirés d’un groupe d’abonnement e-mail, SMS ou RCS en utilisant addToSubscriptionGroup et removeFromSubscriptionGroup pour Android, iOS ou Web. Les méthodes SDK ne remplacent pas les flux réglementaires d’abonnement ou de désabonnement gérés par les mots-clés et la REST API.
• Formulaire de capture de numéro de téléphone dans les messages 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 par SMS 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, SMS ou RCS via Importer des utilisateurs. Lors de la mise à jour du statut du groupe d’abonnement, vous devez disposer de 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 Recherche d’utilisateurs dans la barre latérale, ouvrez le profil d’un utilisateur et mettez à jour les groupes d’abonnement SMS ou RCS sous Paramètres de contact 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 Mise à jour de l’utilisateur. 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

Lors de la mise à jour du statut du groupe d’abonnement d’un utilisateur dans le cadre d’un flux Canvas, utilisez une étape Mise à jour de l’utilisateur au lieu d’un webhook. L’étape de mise à jour de l’utilisateur attend la fin du traitement avant de faire avancer l’utilisateur vers l’étape suivante, de sorte que les étapes de communication ultérieures 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 la modification de l’abonnement a fini d’être traitée. Cela peut créer une condition de concurrence où une étape SMS ultérieure 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 Recherche d’utilisateurs dans la barre latérale. Vous pouvez rechercher des profils utilisateur par adresse e-mail, numéro de téléphone ou ID 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 Lister les groupes d’abonnement d’un utilisateur ou l’endpoint Lister 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 Campaign 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 Campaign 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 réglementations et directives 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 pour 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ésinscriptions en langage naturel dans la console d’agents

Pour une gestion complète des abonnements, vous pouvez capturer les intentions de désinscription 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 ces demandes et y répondre automatiquement.

Configuration

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

Conseil

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

2. Créez un Canvas basé sur une action, déclenché par Envoyer un message SMS entrant, dans la catégorie de mots-clés Other.
3. Ajoutez l’étape Agent au Canvas pour identifier l’intention de désinscription.
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 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 d’agents consomme des crédits de messages ou d’actions.

Migrer le trafic SMS vers RCS

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

Braze recommande de tester d’abord l’envoi de RCS à un volume réduit d’utilisateurs, 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, vous pourriez 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, passez à l’étape Send Settings et sélectionnez Users who are subscribed or opted-in.

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

Ajoutez une étape de mise à jour utilisateur à votre Canvas. Dans cette étape, ouvrez l’Advanced JSON Editor 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 puisse être 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 à une audience plus large.

Étape 5 : Lancer votre Canvas

Une fois que vous avez 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 Contact Settings et faites défiler pour voir les groupes d’abonnement auxquels l’utilisateur est abonné. Le bouton bascule 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 le RCS.

Bonnes pratiques

Désignez 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
  • Transactionnel - PROD pour SMS
• Espace de travail de développement (pour les tests)
  • Marketing - DEV pour SMS
  • Transactionnel - DEV pour SMS

Utilisez 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éparez les groupes par pays

Les réglementations SMS varient selon les pays. Nous vous suggérons 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 plus d’informations, 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 s’étend sur 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.