Noms d’utilisateur WhatsApp et identifiants utilisateur à portée commerciale
Les noms d’utilisateur WhatsApp sont une fonctionnalité de confidentialité optionnelle qui masque les numéros de téléphone des utilisateurs lorsqu’ils communiquent avec des entreprises. Braze gère cela automatiquement ; pour la plupart des clients, rien dans vos Campaigns ou Canvas n’a besoin de changer.
Lorsque les utilisateurs WhatsApp adoptent un nom d’utilisateur, leur numéro de téléphone n’est plus automatiquement partagé avec les entreprises auxquelles ils envoient des messages. À la place, WhatsApp fournit aux entreprises un identifiant utilisateur à portée commerciale (BSUID), un identifiant unique spécifique à 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 au changement.
Identifiant utilisateur à portée entreprise (BSUID)
Un BSUID est un identifiant unique et persistant que WhatsApp attribue pour représenter un utilisateur au sein de votre portefeuille d’entreprise spécifique. Considérez-le 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 possèdent trois caractéristiques clés :
| Caractéristique | Description |
|---|---|
| Unique | Aucun utilisateur ne partage le même BSUID au sein de votre portefeuille d’entreprise. |
| À portée entreprise | Un même utilisateur dispose d’un BSUID différent pour chaque entreprise avec laquelle il communique. 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 mêmes 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 (pas de changement) | Numéro de téléphone (pas de changement) |
| Utilisateurs avec un nom d’utilisateur | Nom d’utilisateur (affiché), BSUID (backend) | BSUID, numéro de téléphone pour les utilisateurs ayant déjà une conversation avec votre entreprise |
La différence principale est qu’un utilisateur qui adopte un nom d’utilisateur ne partage son numéro de téléphone avec votre entreprise que si vous aviez déjà eu une conversation avec lui ou s’il apparaît dans votre carnet de contacts WhatsApp.
Comment Braze gère les BSUID
Braze stocke les BSUID en tant qu’alias d’utilisateur avec le libellé whats_app_bsuid sur le profil utilisateur. Cela signifie que les utilisateurs identifiés uniquement par un BSUID disposent de profils utilisateur Braze complets et peuvent entrer dans des Canvas, recevoir des messages, générer des événements et être mis à jour via l’API.
Envoi de messages
Lorsque Braze envoie un message WhatsApp, il utilise le numéro de téléphone s’il est disponible. Si l’utilisateur ne dispose que d’un BSUID (par exemple un utilisateur qui vous envoie un premier message après avoir adopté un nom d’utilisateur), Braze envoie le message en utilisant le BSUID à la place. Aucune modification de vos modèles de messages, Campaigns ou étapes Canvas n’est nécessaire.
Messages entrants et déclencheurs Canvas
Lorsqu’un utilisateur disposant 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é en tant qu’alias d’utilisateur.
- Déclenche tout Canvas ou toute Campaign configurée pour démarrer à la réception d’un message WhatsApp entrant.
Profil utilisateur
Vous pouvez consulter le BSUID d’un utilisateur sur son profil utilisateur Braze dans la section WhatsApp.
Groupes d’abonnement
La gestion des groupes d’abonnement fonctionne de la même manière pour les utilisateurs identifiés par 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 en utilisant
user_alias - L’étape Canvas User Update (fonctionne automatiquement)
- L’import CSV
L’endpoint subscription/status/set ne prend pas en charge user_alias. Utilisez l’endpoint users/track pour mettre à jour l’état d’abonnement des utilisateurs identifiés uniquement par un BSUID.
Currents et données d’événements
Tous les événements Currents WhatsApp (envoi, distribution, lecture, échec, réception de message entrant, abandon, nouvelle tentative) incluent un champ BSUID. Pour les utilisateurs disposant à la fois d’un numéro de téléphone et d’un BSUID, les deux champs sont inclus. Pour les utilisateurs ne disposant que d’un BSUID, seul le champ BSUID est inclus (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 BSUID, la création d’utilisateurs et le suivi des événements. Cependant, nous vous recommandons d’activer le carnet de contacts WhatsApp et de lier les portefeuilles d’entreprise si vous utilisez plusieurs comptes WhatsApp Business (WABA).
Activer le carnet de contacts WhatsApp
Le carnet de contacts est une fonctionnalité Meta qui enregistre les numéros de téléphone des utilisateurs avec lesquels vous avez déjà conversé. 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 carnet de contacts. Cela signifie que Braze peut continuer à identifier les utilisateurs par numéro de téléphone même après qu’ils ont activé un nom d’utilisateur.
Pour activer le carnet de contacts :
- Accédez à Meta Business Suite > Paramètres > Informations sur l’entreprise.
- Vérifiez que la fonctionnalité Carnet de contacts est activée.
La fonctionnalité Carnet de contacts est activée par défaut, mais nous vous recommandons de le confirmer dans vos paramètres Meta Business. Si le carnet de contacts est désactivé, les utilisateurs qui adoptent un nom d’utilisateur apparaissent comme de nouveaux utilisateurs avec un BSUID uniquement, même si vous leur avez déjà envoyé des messages.
Lier les portefeuilles d’entreprise si vous utilisez plusieurs WABA
Les BSUID sont limités à un seul portefeuille d’entreprise. Si votre organisation gère des WABA provenant de plusieurs portefeuilles d’entreprise au sein du même espace de travail Braze, le même utilisateur possède un BSUID différent pour chaque portefeuille. Cela peut entraîner la création de profils utilisateur Braze en double.
Pour éviter cela, contactez votre interlocuteur Meta pour vérifier si votre entreprise est éligible au regroupement de portefeuilles. Consultez Lier les portefeuilles d’entreprise et les BSUID parents pour plus de détails.
Si tous vos WABA se trouvent dans le même portefeuille d’entreprise, aucune action n’est nécessaire.
Lier des portfolios d’entreprise et des BSUID parents
Si votre organisation exploite plusieurs comptes WhatsApp Business (WABA) répartis dans différents portfolios d’entreprise, vous pouvez demander à votre contact Meta de vérifier si votre entreprise est éligible pour lier ces portfolios entre eux. L’éligibilité est déterminée par Meta et est disponible pour les entreprises gérées.
Comportement des portfolios liés
Lorsque vos portfolios d’entreprise sont liés, WhatsApp inclut un BSUID parent dans tous les webhooks de messages en plus du BSUID habituel. Le BSUID parent est assigné à 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 habituels, mais sont partagés entre tous les numéros de téléphone professionnels au sein de votre ensemble de portfolios liés. Cela signifie qu’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 utilisateur en double.
Un BSUID parent inclut ENT entre le code pays et l’identifiant alphanumérique. Par exemple :
US.ENT.11815799212886844830
Un BSUID habituel n’inclut pas ENT.
Comment Braze utilise les BSUID parents
Lorsqu’un webhook contient à la fois un BSUID habituel et un BSUID parent, Braze utilise le BSUID parent comme identifiant principal. Cela permet à un utilisateur qui envoie des messages à travers plusieurs WABA dans vos portfolios liés d’être systématiquement associé au même profil utilisateur Braze.
Si aucun BSUID parent n’est présent (par exemple, parce que vos portfolios ne sont pas liés ou que l’utilisateur envoie un message à un WABA non lié), Braze utilise le BSUID habituel. Les BSUID habituels continuent de fonctionner normalement dans tous les cas.
Meta gère le processus de liaison des portfolios d’entreprise. Pour commencer, contactez votre contact Meta. Vous pouvez toujours envoyer des messages aux utilisateurs en utilisant leur BSUID habituel même si vos portfolios sont liés ; les BSUID parents sont additifs, et non un remplacement.
| Scénario | Identifiant utilisé par Braze |
|---|---|
| Portfolio d’entreprise unique | BSUID habituel |
| Plusieurs portfolios liés | BSUID parent (préféré). S’il n’existe pas de BSUID parent, le BSUID habituel est utilisé |
| Plusieurs portfolios non liés | BSUID habituel (peut entraîner des profils utilisateur en double par portfolio) |
Questions fréquentes
Mes Campaigns et Canvas existants cessent-ils de fonctionner ?
Non. Les Campaigns et Canvas existants continuent de fonctionner. Les utilisateurs qui n’adoptent pas de nom d’utilisateur ne sont absolument pas affectés. Pour les utilisateurs qui adoptent un nom d’utilisateur et qui ont un historique de conversation existant 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 a déjà envoyé un message à mon entreprise ?
Si votre carnet de contacts WhatsApp est activé et que vous avez eu une conversation préalable avec l’utilisateur (ou que vous 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 les associe à leur 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 eu de conversation préalable avec mon entreprise ?
Braze reçoit le BSUID de l’utilisateur dans le webhook entrant et l’associe à un profil utilisateur existant (si vous avez précédemment stocké son BSUID) ou crée un nouveau profil utilisateur anonyme avec le BSUID 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.
Puis-je cibler les utilisateurs BSUID dans des Segments ?
Les utilisateurs BSUID sont des profils utilisateur Braze à part entière, vous pouvez donc les cibler via des filtres d’audience standard (tels que « a reçu un message WhatsApp » ou l’appartenance à un groupe d’abonnement). Cependant, la segmentation spécifique sur les valeurs BSUID (telles que « 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 est déterminée par le pays de l’utilisateur. Pour les utilisateurs identifiés par numéro de téléphone, Meta détermine le pays à partir de l’indicatif téléphonique du numéro. Pour les utilisateurs identifiés par BSUID, le pays est encodé directement dans le BSUID lui-même ; par exemple, un BSUID commençant par US représente un utilisateur aux États-Unis.
Cela signifie que le comportement tarifaire est cohérent, que l’utilisateur soit identifié par numéro de téléphone ou par BSUID. Le pays utilisé pour calculer les tarifs de conversation est déterminé par l’identifiant fourni par Meta, et Braze le transmet sans modification. Vous n’avez rien à faire différemment, mais sachez que lorsque vous envoyez des messages à des utilisateurs identifiés uniquement par BSUID, la tarification basée sur le pays de Meta repose sur le pays encodé dans le BSUID de l’utilisateur plutôt que sur un numéro de téléphone.
Comment référencer un utilisateur BSUID dans les appels API ?
Utilisez le paramètre user_alias avec alias_label: "whats_app_bsuid" et alias_name défini sur la valeur BSUID de l’utilisateur. Par exemple :
{
"user_alias": {
"alias_label": "whats_app_bsuid",
"alias_name": "DDC91135R"
}
}
Cela fonctionne avec users/track, users/identify, l’import CSV et l’étape de mise à jour utilisateur dans Canvas.
Mes pipelines de données Currents cessent-ils de fonctionner ?
Les événements Currents pour WhatsApp incluent un champ bsuid aux côtés du champ de numéro de téléphone existant. Pour les utilisateurs disposant uniquement d’un BSUID, le champ du numéro de téléphone est vide. Si vos pipelines en aval ont des exigences strictes sur le champ du numéro de téléphone, vérifiez qu’ils peuvent gérer une valeur nulle ou vide.
J’ai plusieurs WABA répartis sur différents portfolios d’entreprise. Le même utilisateur apparaît-il sous deux profils différents dans Braze ?
Sans portfolios liés, oui. Le même utilisateur WhatsApp possède un BSUID différent par portfolio d’entreprise, et Braze crée des profils séparés pour chacun.
Pour résoudre ce problème, contactez votre interlocuteur Meta pour vérifier votre éligibilité au couplage de portfolios. Une fois liés, Meta fournit un BSUID parent partagé entre tous les portfolios, et Braze l’utilise pour identifier l’utilisateur de manière cohérente à travers vos WABA. Consultez Lier les portfolios d’entreprise et les BSUID parents pour plus de détails.
Puis-je désactiver le carnet de contacts ?
Nous recommandons vivement de garder le carnet de contacts activé. Si le carnet de contacts est désactivé, tous les enregistrements historiques de numéros de téléphone de vos utilisateurs sont perdus. Les utilisateurs qui adoptent un nom d’utilisateur apparaissent alors comme de nouveaux utilisateurs identifiés uniquement par BSUID, même si vous leur aviez précédemment envoyé des messages.