Noms d’utilisateur WhatsApp et identifiants utilisateur à portée commerciale
Les noms d’utilisateur WhatsApp sont une fonctionnalité de confidentialité facultative qui masque le numéro de téléphone des utilisateurs lorsqu’ils échangent avec des entreprises. Braze gère tout cela automatiquement : pour la plupart des clients, rien ne change dans vos Campaigns ou vos Canvas.
Meta déploie progressivement les noms d’utilisateur WhatsApp et les BSUID. Braze prend entièrement en charge l’envoi de messages par BSUID ; vous verrez donc sans doute de plus en plus d’utilisateurs identifiés uniquement par un BSUID. Pour connaître les dernières mises à jour de Meta, consultez la section Identifiants utilisateur à portée commerciale.
Lorsqu’un utilisateur WhatsApp adopte un nom d’utilisateur, son numéro de téléphone n’est plus automatiquement communiqué aux entreprises avec lesquelles il échange. WhatsApp fournit à la place aux entreprises un identifiant utilisateur à portée commerciale (BSUID), un identifiant unique propre à chaque paire portefeuille commercial/utilisateur.
Braze gère les BSUID automatiquement. Les utilisateurs qui adoptent un nom d’utilisateur continuent d’apparaître dans votre espace de travail Braze, de recevoir des messages, de déclencher des Canvas et de générer des événements. Certains clients devront peut-être se préparer à ce changement.
Identifiant utilisateur propre à l’entreprise (BSUID)
Un BSUID est un identifiant unique et persistant que WhatsApp attribue à un utilisateur au sein de votre portefeuille d’entreprise. Vous pouvez le considérer comme un numéro de téléphone alternatif pour les utilisateurs qui choisissent de garder leur numéro de téléphone privé.
Les BSUID présentent trois caractéristiques clés :
| Caractéristique | Description |
|---|---|
| Unique | Deux utilisateurs ne peuvent pas partager le même BSUID au sein de votre portefeuille d’entreprise. |
| Propre à l’entreprise | Un même utilisateur dispose d’un BSUID différent pour chaque entreprise à laquelle il envoie des messages. Les BSUID ne peuvent pas être partagés ni comparés entre différents portefeuilles d’entreprise. |
| Disponible dans les webhooks | Les BSUID sont inclus dans tous les payloads de webhook qui contiennent le numéro de téléphone de l’utilisateur. |
Modifications des types d’utilisateurs WhatsApp
Il existe deux types d’utilisateurs WhatsApp :
| Type d’utilisateur | Identification WhatsApp | Ce que Braze reçoit |
|---|---|---|
| Utilisateurs sans nom d’utilisateur | Numéro de téléphone (aucun changement) | Numéro de téléphone (aucun changement) |
| Utilisateurs avec un nom d’utilisateur | Nom d’utilisateur (affiché), BSUID (backend) | BSUID, et numéro de téléphone pour les utilisateurs qui ont déjà une conversation en cours avec votre entreprise |
La principale différence : un utilisateur qui adopte un nom d’utilisateur ne partage son numéro de téléphone avec votre entreprise que si vous avez déjà échangé avec lui ou s’il figure dans votre carnet de contacts WhatsApp.
Comment Braze gère les BSUID
Braze stocke les BSUID sous forme d’alias d’utilisateur avec le libellé whats_app_bsuid dans le profil utilisateur. Les utilisateurs identifiés uniquement par un BSUID disposent donc de profils utilisateurs Braze complets : ils peuvent entrer dans des Canvas, recevoir des messages, générer des événements et être mis à jour via l’API.
Envoyer des messages
Lorsque Braze envoie un message WhatsApp, il utilise le numéro de téléphone s’il est disponible. Si l’utilisateur n’a qu’un BSUID (par exemple, un utilisateur qui vous écrit pour la première fois après avoir adopté un nom d’utilisateur), Braze utilise le BSUID pour l’envoi. Vous n’avez rien à modifier dans vos modèles de message, vos campagnes ou vos étapes du Canvas.
Messages entrants et déclencheurs de Canvas
Lorsqu’un utilisateur doté d’un nom d’utilisateur vous envoie un message WhatsApp entrant, Braze :
- Recherche l’utilisateur par BSUID ou par numéro de téléphone (selon ce qui est disponible dans le webhook).
- Si aucun utilisateur correspondant n’est trouvé, crée un nouveau profil utilisateur anonyme avec le BSUID stocké comme alias d’utilisateur.
- Déclenche tout Canvas ou toute campagne configuré pour démarrer à la réception d’un message WhatsApp entrant.
Profil utilisateur
Le BSUID d’un utilisateur est visible dans la section WhatsApp de son profil utilisateur Braze.
Groupes d’abonnement
La gestion des groupes d’abonnement fonctionne de la même manière pour les utilisateurs BSUID que pour tout utilisateur identifié par un alias d’utilisateur. Vous pouvez mettre à jour le statut d’abonnement des utilisateurs BSUID via :
- L’endpoint users/track avec
user_alias - L’étape du Canvas Mise à jour de l’utilisateur (fonctionne automatiquement)
- L’importation CSV
L’endpoint subscription/status/set ne prend pas en charge user_alias. Utilisez l’endpoint users/track pour mettre à jour le statut d’abonnement des utilisateurs identifiés uniquement par un BSUID.
Currents et données d’événements
Tous les événements WhatsApp de Currents (envoi, réception, lecture, échec, message entrant reçu, abandon, nouvelle tentative) incluent un champ BSUID. Pour les utilisateurs qui disposent à la fois d’un numéro de téléphone et d’un BSUID, les deux champs sont inclus. Pour les utilisateurs qui n’ont qu’un BSUID, seul le champ BSUID est renseigné (le champ du numéro de téléphone est vide).
Comment se préparer au changement
Pour la plupart des clients, aucune action n’est requise. Braze gère automatiquement le routage des BSUID, la création des utilisateurs et le suivi des événements. Nous vous recommandons toutefois d’activer le Contact Book WhatsApp et de lier vos portefeuilles d’entreprise si vous utilisez plusieurs comptes WhatsApp Business (WABA).
Si vous attendez des utilisateurs entrants qui ne fournissent qu’un BSUID, vous pouvez également leur demander leurs coordonnées afin d’enregistrer un numéro de téléphone sur le profil et de fusionner les doublons si nécessaire.
Activer le Contact Book WhatsApp
Le Contact Book (carnet de contacts) est une fonctionnalité de Meta qui enregistre les numéros de téléphone des utilisateurs avec lesquels vous avez déjà échangé. Lorsqu’un utilisateur adopte un nom d’utilisateur, son numéro de téléphone reste visible pour votre entreprise s’il figure dans votre Contact Book. Braze peut ainsi continuer à identifier les utilisateurs par leur numéro de téléphone, même après l’activation d’un nom d’utilisateur.
Pour activer le Contact Book :
- Accédez à Meta Business Suite > Paramètres de l’entreprise > Informations sur l’entreprise.
- Vérifiez que la fonctionnalité Contact Book est activée.
La fonctionnalité Contact Book est activée par défaut, mais nous vous recommandons de le vérifier dans vos paramètres Meta Business. Si le Contact Book est désactivé, les utilisateurs qui adoptent un nom d’utilisateur apparaissent comme de nouveaux utilisateurs identifiés uniquement par un BSUID, même si vous leur avez déjà envoyé des messages.
Lier vos portefeuilles d’entreprise si vous utilisez plusieurs WABA
Les BSUID sont propres à un seul portefeuille d’entreprise. Si votre organisation gère des WABA issus de plusieurs portefeuilles d’entreprise au sein du même espace de travail Braze, un même utilisateur possède un BSUID différent pour chaque portefeuille. Cela peut entraîner des profils utilisateurs Braze en double.
Pour éviter cela, contactez votre interlocuteur Meta afin de vérifier si votre entreprise peut lier ses portefeuilles. Pour en savoir plus, consultez Lier les portefeuilles d’entreprise et les BSUID parents.
Si tous vos WABA appartiennent au même portefeuille d’entreprise, aucune action n’est nécessaire.
Associer des portefeuilles d’entreprise et des BSUID parents
Si votre organisation gère plusieurs comptes WhatsApp Business (WABA) répartis sur différents portefeuilles d’entreprise, vous pouvez demander à votre contact chez Meta de vérifier si votre entreprise peut associer ces portefeuilles. C’est Meta qui détermine l’éligibilité, et cette option est réservée aux entreprises gérées.
Comportement des portefeuilles associés
Lorsque vos portefeuilles d’entreprise sont associés, WhatsApp inclut un BSUID parent dans tous les webhooks de message, en plus du BSUID habituel. Le BSUID parent est attribué à une nouvelle propriété parent_user_id dans le payload du webhook.
Les BSUID parents ont les mêmes propriétés que les BSUID classiques, mais ils sont partagés entre tous les numéros de téléphone professionnels de votre ensemble de portefeuilles associés. Ainsi, un même utilisateur dispose d’un identifiant unique et cohérent, quel que soit le WABA auquel il envoie un message, ce qui évite le risque de profils utilisateurs en double.
Un BSUID parent contient ENT entre le code pays et l’identifiant alphanumérique. Par exemple :
US.ENT.11815799212886844830
Un BSUID classique ne contient pas ENT.
Utilisation des BSUID parents par Braze
Lorsqu’un webhook contient à la fois un BSUID classique et un BSUID parent, Braze utilise le BSUID parent comme identifiant principal. Un utilisateur qui envoie des messages à plusieurs WABA de vos portefeuilles associés est ainsi toujours rattaché au même profil utilisateur Braze.
En l’absence de BSUID parent (par exemple, parce que vos portefeuilles ne sont pas associés ou que l’utilisateur écrit à un WABA non associé), Braze utilise le BSUID classique. Les BSUID classiques continuent de fonctionner normalement dans tous les cas.
Meta gère le processus d’association des portefeuilles d’entreprise. Pour commencer, contactez votre interlocuteur chez Meta. Vous pouvez toujours envoyer des messages aux utilisateurs avec leur BSUID classique, même si vos portefeuilles sont associés : les BSUID parents viennent s’ajouter aux BSUID classiques, ils ne les remplacent pas.
| Scénario | Identifiant utilisé par Braze |
|---|---|
| Portefeuille d’entreprise unique | BSUID classique |
| Plusieurs portefeuilles associés | BSUID parent (privilégié). En l’absence de BSUID parent, le BSUID classique est utilisé |
| Plusieurs portefeuilles non associés | BSUID classique (peut entraîner des profils utilisateurs en double pour chaque portefeuille) |
Foire aux questions
Mes Campaigns et Canvas existants vont-ils cesser de fonctionner ?
Non. Vos Campaigns et Canvas existants continuent de fonctionner. Les utilisateurs qui n’adoptent pas de nom d’utilisateur ne sont absolument pas concernés. Pour les utilisateurs qui adoptent un nom d’utilisateur et qui ont déjà un historique de conversation avec votre entreprise, Braze continue d’utiliser leur numéro de téléphone comme identifiant principal.
Que se passe-t-il pour un utilisateur qui adopte un nom d’utilisateur mais qui a déjà envoyé un message à mon entreprise ?
Si votre carnet de contacts WhatsApp (Contact Book) est activé et que vous avez eu une conversation avec l’utilisateur (ou lui avez envoyé un message) au cours des 30 derniers jours, son numéro de téléphone continue d’apparaître dans les payloads de webhook aux côtés du BSUID. Braze l’associe à son profil utilisateur existant. Aucun profil en double n’est créé.
Que se passe-t-il si un utilisateur adopte un nom d’utilisateur sans avoir jamais échangé avec mon entreprise ?
Braze reçoit le BSUID de l’utilisateur dans le webhook entrant, puis l’associe à un profil utilisateur existant (si vous avez déjà enregistré son BSUID) ou crée un nouveau profil d’utilisateur anonyme dans lequel le BSUID est enregistré comme alias d’utilisateur. Cet utilisateur peut ensuite entrer dans des Canvas, recevoir des messages sortants, et être identifié ou fusionné avec d’autres profils à l’aide des outils standard de résolution d’identité de Braze.
Pour obtenir le numéro de téléphone de ces utilisateurs identifiés uniquement par leur BSUID, consultez Demander les coordonnées des utilisateurs WhatsApp identifiés uniquement par BSUID.
Puis-je cibler les utilisateurs BSUID dans des Segments ?
Les utilisateurs BSUID disposent de profils utilisateur Braze complets : vous pouvez donc les cibler à l’aide des filtres d’audience standard (par exemple « a reçu un message WhatsApp » ou l’appartenance à un groupe d’abonnement). En revanche, la segmentation basée spécifiquement sur les valeurs de BSUID (par exemple « le BSUID existe » ou « le BSUID est égal à X ») n’est pas prise en charge.
Comment fonctionne la tarification WhatsApp pour les utilisateurs BSUID ?
La tarification des conversations WhatsApp dépend du pays de l’utilisateur. Pour les utilisateurs identifiés par leur numéro de téléphone, Meta déduit le pays à partir de l’indicatif du numéro. Pour les utilisateurs identifiés par BSUID, le pays est encodé directement dans le BSUID ; par exemple, un BSUID commençant par US correspond à un utilisateur situé aux États-Unis.
La tarification reste donc cohérente, que l’utilisateur soit identifié par son numéro de téléphone ou par son BSUID. Le pays utilisé pour calculer le tarif des conversations est déterminé par l’identifiant fourni par Meta, et Braze le transmet sans modification. Vous n’avez rien à changer, mais gardez à l’esprit que, lorsque vous envoyez des messages à des utilisateurs identifiés uniquement par BSUID, la tarification de Meta se base sur le pays encodé dans le BSUID de l’utilisateur plutôt que sur un numéro de téléphone.
Comment faire référence à un utilisateur BSUID dans les appels d’API ?
Utilisez le paramètre user_alias avec alias_label: "whats_app_bsuid" et définissez alias_name sur la valeur du BSUID de l’utilisateur. Par exemple :
{
"user_alias": {
"alias_label": "whats_app_bsuid",
"alias_name": "DDC91135R"
}
}
Cela fonctionne avec users/track, users/identify, l’importation CSV et l’étape de Canvas Mise à jour de l’utilisateur.
Mes pipelines de données Currents vont-ils cesser de fonctionner ?
Les événements Currents pour WhatsApp incluent un champ bsuid en plus du champ de numéro de téléphone existant. Pour les utilisateurs disposant uniquement d’un BSUID, le champ de numéro de téléphone est vide. Si vos pipelines en aval imposent des exigences strictes sur ce champ, vérifiez qu’ils peuvent gérer une valeur nulle ou vide.
J’ai plusieurs WABA répartis sur différents portefeuilles d’entreprise. Un même utilisateur apparaît-il sous la forme de deux profils distincts dans Braze ?
Sans portefeuilles associés, oui. Un même utilisateur WhatsApp possède un BSUID différent pour chaque portefeuille d’entreprise, et Braze crée un profil distinct pour chacun.
Pour y remédier, contactez votre interlocuteur Meta afin de vérifier votre éligibilité à l’association de portefeuilles. Une fois les portefeuilles associés, Meta fournit un BSUID parent partagé entre tous les portefeuilles, que Braze utilise pour identifier l’utilisateur de manière cohérente sur l’ensemble de vos WABA. Pour en savoir plus, consultez Associer des portefeuilles d’entreprise et des BSUID parents.
Puis-je désactiver le carnet de contacts ?
Nous vous recommandons vivement de laisser le carnet de contacts activé. S’il est désactivé, tout l’historique des numéros de téléphone de vos utilisateurs est perdu. Les utilisateurs qui adoptent un nom d’utilisateur apparaissent alors comme de nouveaux utilisateurs identifiés uniquement par BSUID, même si vous leur avez déjà envoyé des messages.
Ressources supplémentaires
Pour connaître les dernières mises à jour du canal WhatsApp, consultez les notes de version.