Comprendre les noms d'utilisateur et les BSUID sur WhatsApp
Que sont les noms d'utilisateur WhatsApp ?
Un nom d'utilisateur WhatsApp est un identifiant unique facultatif que l'un des acteurs suivants peut choisir d'afficher à la place d'un numéro de téléphone dans l'application : un utilisateur WhatsApp (connecté à l'application WhatsApp grand public) ou une entreprise (connectée à l'application WhatsApp Business ou à la plateforme API WhatsApp Business). Les noms d'utilisateur fonctionnent de manière similaire aux pseudonymes sur Facebook Messenger ou Instagram.
On distingue deux acteurs et deux cas d'utilisation distincts :
| Acteur | Pourquoi choisissent-ils un nom d'utilisateur ? | Incidence sur la visibilité du numéro de téléphone |
|---|---|---|
| Utilisateur de WhatsApp (connecté à l'application grand public WhatsApp) | Confidentialité : pour éviter de communiquer leur numéro de téléphone à des entreprises ou à d'autres utilisateurs | Le numéro de téléphone est masqué pour les entreprises dans les webhooks (sauf si certaines conditions sont remplies) |
| Entreprise (connectée à l'application WhatsApp Business ou à la plateforme API WhatsApp Business) | Image de marque : pour permettre aux utilisateurs de les trouver et de les reconnaître plus facilement | Le numéro de téléphone n'est pas masqué ; le nom d'utilisateur n'est qu'un identifiant supplémentaire. |
Les noms d'utilisateur viennent s'ajouter aux numéros de téléphone, ils ne les remplacent pas. Chaque compte WhatsApp nécessite toujours un numéro de téléphone.
Qu'est-ce qu'un BSUID ?
Un identifiant utilisateur professionnel (BSUID) est un identifiant unique attribué par Meta à chaque utilisateur de WhatsApp, spécifiquement lié à un portefeuille d'entreprises donné. Il s'agit du principal moyen d'identifier un utilisateur et de lui envoyer un message lorsque son numéro de téléphone n'est pas disponible.
Principales caractéristiques d'un BSUID :
- Format : préfixe de code pays ISO 3166 alpha-2, suivi d'un point et d'un maximum de 128 caractères alphanumériques — par exemple, US.13491208655302741918
- Champ d'application : unique pour chaque paire « portefeuille d'activité – utilisateur ». Un BSUID issu d'un portefeuille ne peut pas être utilisé avec un numéro de téléphone appartenant à un autre portefeuille.
- Disponibilité : Toujours disponible pour les utilisateurs de WhatsApp (particuliers). Pas toujours disponible pour les entreprises, sauf si la fonctionnalité est activée. Par ailleurs, quel que soit le nom d'utilisateur ou le BSUID, les numéros de téléphone des entreprises sont toujours disponibles.
- Régénération : un BSUID est régénéré si l'utilisateur change de numéro de téléphone.
- Restrictions : les identifiants BSUID ne peuvent pas être utilisés pour envoyer des modèles d'authentification « one-tap », « zero-tap » ou « copy code ». Ces types de messages nécessitent un numéro de téléphone.
Qu'est-ce qu'un BSUID parent ?
Un BSUID parent est une variante particulière du BSUID, accessible aux entreprises gérées disposant de plusieurs portefeuilles d'activités Meta associés. Il permet d'utiliser un identifiant unique pour l'ensemble des portefeuilles enregistrés.
- Format :
{COUNTRY_CODE}.ENT.{ALPHANUMERIC_ID}— par exemple,US.ENT.11815799212886844830 - Disponibilité : réservé aux entreprises enregistrées sous un compte BSUID principal auprès de Meta. Contactez votre interlocuteur chez Meta ou Vonage pour vérifier si vous remplissez les conditions requises.
- Champ d'application : fonctionne pour tous les portefeuilles enregistrés. Les BSUID standard continuent de fonctionner parallèlement aux BSUID parents.
Quand recevrez-vous un BSUID plutôt qu'un numéro de téléphone ?
Le tableau ci-dessous récapitule les identifiants visibles par Vonage en fonction du type d'utilisateur :
| Type d'utilisateur | Le numéro de téléphone est-il visible ? | Le BSUID est-il visible ? | Le nom d'utilisateur est-il visible ? |
|---|---|---|---|
| Utilisateur sans nom d'utilisateur | Oui | Oui (toujours) | Non |
| Utilisateur dont le nom d'utilisateur a été adopté | Sous certaines conditions (voir ci-dessous) | Oui (toujours) | Oui |
| Entreprise sans identifiant | Oui | Non | Non |
| Entreprise dont le nom d'utilisateur a été adopté | Oui | Non | Oui (marquage uniquement) |
Dans quels cas le numéro de téléphone est-il toujours indiqué pour les utilisateurs qui choisissent un nom d'utilisateur ?
Meta inclut le numéro de téléphone de l'utilisateur dans les webhooks si l'une des conditions suivantes est remplie (évaluation effectuée pour chaque numéro de téléphone professionnel) :
- Vous avez envoyé un message ou appelé le numéro de téléphone de cet utilisateur au cours des 30 derniers jours
- Vous avez reçu un message ou un appel provenant du numéro de téléphone de cet utilisateur au cours des 30 derniers jours
- Cet utilisateur figure dans votre répertoire.
Si aucune de ces conditions n'est remplie, le wa_id Ce champ sera omis de la charge utile du webhook. Le from Ce champ contiendra le BSUID à la place du numéro de téléphone.
Le carnet d'adresses
Meta propose une fonctionnalité de répertoire (disponible dès début avril 2026) qui enregistre automatiquement le numéro de téléphone et le BSUID d'un utilisateur chaque fois que vous envoyez ou recevez un message ou un appel vers ou depuis son numéro de téléphone. Une fois enregistré, le numéro de téléphone continuera d'apparaître dans les données des webhooks, que l'utilisateur ait ou non adopté un nom d'utilisateur.
Le carnet de contacts s'applique au niveau du portefeuille d'activités et est hébergé par Meta. Aucune intégration n'est nécessaire pour l'activer, car il est activé par défaut par Meta. Vous pouvez le désactiver à tout moment dans Meta Business Suite > Paramètres de l'entreprise > Informations sur l'entreprise.
Nouveau code d'erreur
Un nouveau code d'erreur est renvoyé lorsque vous tentez d'envoyer un type de message qui ne prend pas en charge les BSUID en tant que destinataires :
| Code d'erreur | Détail |
|---|---|
| 131062 | Les destinataires disposant d'un identifiant utilisateur au niveau de l'entreprise (BSUID) ne sont pas pris en charge pour ce message. |