Noms d'utilisateur WhatsApp et BSUID : ce qui change pour l'OTP, le CRM et les webhooks

Un identifiant utilisateur à portée entreprise (BSUID) est l'identifiant que Meta insère désormais dans chaque webhook WhatsApp afin qu'une entreprise puisse envoyer un message à un utilisateur sans connaître son numéro de téléphone. Il existe car WhatsApp introduit les noms d'utilisateur : une fois qu'un utilisateur en active un, une entreprise qui n'a pas été en contact récemment peut ne plus recevoir le numéro. Ce guide de l'équipe d'ingénierie de BroadNet explique le format, le calendrier, ce qui nécessite encore un numéro de téléphone, et comment migrer les webhooks, les enregistrements CRM et les flux OTP.

Points clés

• Les BSUID sont apparus dans les webhooks de WhatsApp depuis début avril 2026, pour chaque utilisateur, qu'il utilise ou non un nom d'utilisateur.
• Un BSUID ressemble à US.13491208655302741918 : un code pays alpha-2 ISO 3166, un point, puis jusqu'à 128 caractères alphanumériques.
• Il est unique à chaque paire portefeuille d'entreprise et utilisateur, et il est régénéré si l'utilisateur change son numéro de téléphone.
• Depuis juillet 2026, vous pouvez envoyer des messages à un BSUID, à l'exception des modèles d'authentification "one-tap", "zero-tap" et "copy-code", qui nécessitent toujours le numéro de téléphone.
• Meta indique que les partenaires et les entreprises directement intégrées doivent prendre en charge les BSUID pour éviter de perdre la capacité de traiter les messages des utilisateurs avec nom d'utilisateur.
• Conservez le numéro de téléphone E.164 vérifié comme ancrage d'identité pour les OTP, le repli SMS et les contrôles de fraude. Traitez le BSUID comme une clé à canal WhatsApp.

Qu'est-ce qu'un identifiant utilisateur à portée entreprise ?

Meta définit un BSUID comme "un identifiant utilisateur unique qui peut être utilisé pour envoyer un message à un utilisateur WhatsApp lorsque vous ne connaissez pas son numéro de téléphone" (Meta, identifiants utilisateur à portée entreprise). Le format est le pays de l'utilisateur sous la forme d'un code alpha-2 ISO 3166, un point, et jusqu'à 128 caractères alphanumériques, par exemple US.13491208655302741918.

Trois propriétés sont importantes pour la conception du système :

• Portée. Un BSUID est unique à un portefeuille d'entreprise et à un utilisateur. La même personne possède un BSUID différent pour chaque portefeuille d'entreprise avec lequel elle communique, vous ne pouvez donc pas l'utiliser pour faire correspondre des clients entre des portefeuilles non liés.
• Stabilité. Il est régénéré lorsque l'utilisateur change son numéro de téléphone. Meta envoie un webhook de message de service de type user_changed_user_id, ainsi qu'un webhook user_id_update distinct, lorsque cela se produit.
• BSUID parents. Les entreprises gérées possédant plusieurs portefeuilles d'entreprise peuvent demander à leur point de contact Meta de s'inscrire aux BSUID parents, qui contiennent des ENT (par exemple US.ENT.11815799212886844830) et s'appliquent à tous les portefeuilles inscrits.

Pourquoi WhatsApp introduit-il des noms d'utilisateur ?

Pour la confidentialité. Meta a annoncé le 29 juin 2026 que les personnes peuvent réserver un nom d'utilisateur pour l'utiliser « plus tard cette année », et que lorsqu'un utilisateur en a activé un, une personne ou une entreprise à qui il envoie un message pour la première fois ne verra plus son numéro de téléphone (À propos de Meta). La documentation développeur de Meta indique que les noms d'utilisateur seront déployés progressivement en 2026.

Les entreprises peuvent également avoir des noms d'utilisateur. À partir du 29 juin 2026, une entreprise peut revendiquer un nom d'utilisateur que WhatsApp a réservé pour elle via WhatsApp Manager, Meta Business Suite ou le Username API, et les noms d'utilisateur approuvés deviennent actifs lors du lancement de la fonctionnalité. Un nom d'utilisateur d'entreprise ne masque pas le numéro de téléphone de l'entreprise.

Quel est le calendrier ?

Perdrez-vous le numéro de téléphone du client ?

Parfois. Le BSUID apparaît dans tous les webhooks de messages. Le numéro de téléphone (wa_id, et from sur les messages entrants) est inclus uniquement si au moins l'un de ces éléments est vrai, selon Meta :

• vous avez envoyé un message ou appelé le numéro de téléphone de l'utilisateur dans les 30 jours précédant le déclenchement du webhook ;
• vous avez reçu un message ou un appel du numéro de téléphone de l'utilisateur au cours de ces 30 jours ; ou
• l'utilisateur figure dans votre carnet de contacts.

La période de recherche de 30 jours est évaluée par numéro de téléphone d'entreprise, ainsi un client connu de votre ligne de vente peut être inconnu de votre ligne de support. Le carnet de contacts est une fonctionnalité hébergée par Meta qui stocke les numéros de téléphone et les BSUID après une première interaction, de sorte que les webhooks ultérieurs peuvent continuer à transporter le numéro même après que l'utilisateur adopte un nom d'utilisateur. Elle est activée par défaut et peut être désactivée dans Meta Business Suite sous les paramètres Business, Business info. Laissez-la activée à moins d'avoir une raison de ne pas le faire.

Qu'est-ce qui nécessite encore un numéro de téléphone ?

Meta est explicite : les BSUID "peuvent être utilisés pour envoyer n'importe quel type de message, à l'exception des modèles d'authentification à un seul appui, à zéro appui et de copie de code, qui nécessitent les numéros de téléphone des utilisateurs". En dehors de WhatsApp, tout ce qui fonctionne sur le réseau mobile nécessite également le numéro.

À quoi ressemble le webhook avant et après ?

Avant les BSUID, le bloc contacts d'un webhook de messages transportait le numéro de téléphone dans wa_id, et la plupart des intégrations l'utilisaient comme clé client. L'exemple de Meta pour le nouvel objet contacts ajoute le nom d'utilisateur, le BSUID et, lorsque cela est activé, le BSUID parent ; wa_id est présent uniquement lorsque le numéro peut être partagé :

1"contacts": [
2  {
3    "profile": {
4      "name": "<USER_DISPLAY_NAME>",
5      "username": "<USERNAME>"
6    },
7    "wa_id": "<USER_PHONE_NUMBER>",
8    "user_id": "<BSUID>",
9    "parent_user_id": "<PARENT_BSUID>"
10  }
11]

Les messages entrants transportent également from_user_id (et from_parent_user_id si activé), et les webhooks de statut transportent recipient_user_id, ce que Meta indique être toujours défini sur le BSUID de l'utilisateur. Pour envoyer, placez le BSUID dans le nouveau paramètre recipient. Vous pouvez renseigner le paramètre to (numéro de téléphone), le paramètre recipient (BSUID), ou les deux ; lorsque les deux sont présents, le numéro de téléphone prend la priorité :

1{
2  "messaging_product": "whatsapp",
3  "recipient_type": "individual",
4  "recipient": "<BSUID>",
5  "type": "text",
6  "text": {
7    "body": "<BODY_TEXT>"
8  }
9}

La réponse d'envoi inclut alors user_id dans son tableau de contacts, et wa_id devient optionnel. Si votre analyseur suppose que wa_id est toujours présent, il échouera lors de la première utilisation d'un nom d'utilisateur. Vous pouvez coller de véritables charges utiles dans notre inspecteur de charge utile webhook pour vérifier quels champs votre intégration reçoit réellement.

Qu'est-ce qui s'interrompt pour OTP ?

Les modèles d'authentification avec des boutons à un appui, sans appui ou de copie de code ne peuvent pas être envoyés à un BSUID. Si un utilisateur avec un nom d'utilisateur vous contacte via WhatsApp et que vous n'avez pas de numéro de téléphone pour lui, vous ne pouvez pas lui envoyer un WhatsApp OTP de ces types. Cela a deux conséquences pour les flux de vérification :

• Collectez et vérifiez le numéro de téléphone lors de l'inscription, au format E.164, et stockez-le comme l'adresse de vérification du compte. Ne comptez pas sur le webhook WhatsApp pour vous le transmettre plus tard. Voir ce qu'est E.164.
• Conservez un canal qui fonctionne sur le numéro lui-même. Les SMS OTP, les OTP vocaux et les vérifications réseau silencieuses s'exécutent tous sur le numéro de téléphone, c'est pourquoi une conception multicanal avec repli automatique survit à ce changement sans modification. Notre guide du OTP multicanal et le produit BroadNet OTP couvrent ce modèle.

Qu'est-ce qui s'interrompt pour le CRM et la déduplication des clients ?

La plupart des CRM indexent un contact WhatsApp sur le numéro de téléphone car SMS, la voix et WhatsApp le partageaient tous auparavant. Après l'introduction des noms d'utilisateur, un nouveau contact entrant peut arriver avec seulement un BSUID. Si vous créez un nouvel enregistrement CRM pour celui-ci, vous allez progressivement dupliquer les clients. Quatre règles permettent de garder les données propres :

1. 1Modélisez le BSUID comme une identité de canal, et non comme l'identifiant client. Un client peut détenir plusieurs BSUID (un par portefeuille d'entreprise) et un nouveau après un changement de numéro.
2. 2Conservez une table de correspondance de BSUID, du portefeuille, du numéro de téléphone lorsqu'il est connu, de la première apparition et de la dernière apparition, et mettez-la à jour à chaque webhook, y compris user_id_update.
3. 3Fusionnez sur la base de preuves, et non de suppositions : un numéro de téléphone vérifié, une connexion, ou une référence de commande que le client fournit dans le chat.
4. 4Ne traitez jamais l'absence de wa_id comme un nouveau client. Cela signifie seulement que le numéro ne peut pas être partagé lors de cet événement.

Comment migrer ? Une liste de contrôle étape par étape

1. 1Mettez à jour les analyseurs de webhook pour lire user_id, from_user_id, recipient_user_id et le nom d'utilisateur, et pour traiter wa_id et from comme optionnels.
2. 2Ajoutez une colonne BSUID (et le BSUID parent si vous êtes une entreprise gérée) partout où vous stockez les contacts WhatsApp.
3. 3Remplissage rétroactif : pour chaque événement entrant depuis début avril 2026, liez le BSUID au numéro de téléphone que vous détenez déjà.
4. 4Gérez le message de service user_changed_user_id et le webhook user_id_update en reliant à nouveau le nouveau BSUID au client.
5. 5Ajoutez le paramètre recipient à votre chemin d'envoi, et utilisez-le en repli lorsque vous n'avez pas de numéro de téléphone.
6. 6Routez OTP vers le numéro de téléphone, jamais vers un BSUID, et conservez SMS ou la voix comme canal de repli.
7. 7Réservez votre nom d'utilisateur d'entreprise dans WhatsApp Manager, Meta Business Suite ou via Username API.
8. 8Testez avec un compte activé pour les noms d'utilisateur avant que les noms d'utilisateur n'atteignent vos clients.

Si BroadNet est votre fournisseur WhatsApp, demandez un accès de test et confirmez l'apparence des champs BSUID dans les webhooks pour votre compte avant de modifier le code de production. Notre centre de développement et notre page WhatsApp Business API contiennent les détails, et le routage omnicanal gère le repli SMS dont dépendent désormais les flux d'authentification.

Foire aux questions

Qu'est-ce qu'un WhatsApp BSUID ?

Un identifiant utilisateur lié à l'entreprise : un identifiant que Meta attribue à chaque utilisateur WhatsApp pour chaque portefeuille d'entreprise, afin que l'entreprise puisse envoyer un message à l'utilisateur sans connaître son numéro de téléphone. Il apparaît sous la forme de user_id dans les webhooks.

À quoi ressemble un BSUID ?

Un code pays alpha-2 ISO 3166, un point, puis jusqu'à 128 caractères alphanumériques, par exemple US.13491208655302741918. Les BSUID parents pour les entreprises gérées incluent ENT, par exemple US.ENT.11815799212886844830.

Perdrai-je le numéro de téléphone du client lorsqu'il adopte un nom d'utilisateur ?

Seulement dans certains webhooks. Le numéro est toujours inclus si vous avez échangé un message ou un appel avec ce numéro au cours des 30 derniers jours, ou si l'utilisateur est dans votre carnet de contacts. Sinon, wa_id est omis et vous ne recevez que le BSUID.

Puis-je envoyer des messages à un BSUID ?

Oui, depuis juillet 2026, en utilisant le paramètre recipient de l'envoi API. Tous les types de messages fonctionnent, à l'exception des modèles d'authentification "one-tap", "zero-tap" et "copy-code", qui nécessitent le numéro de téléphone de l'utilisateur.

Puis-je envoyer des modèles d'authentification (OTP) à un BSUID ?

Non. Les modèles d'authentification à un appui, à zéro appui et à copie de code nécessitent le numéro de téléphone. Conservez un numéro de téléphone vérifié pour chaque compte et utilisez SMS ou la OTP vocale comme solution de secours.

Les BSUID fonctionnent-ils sur l'ensemble des portefeuilles d'entreprise ?

Non. Un BSUID est unique à une paire portefeuille d'entreprise et utilisateur. Les entreprises gérées peuvent interroger Meta concernant les BSUID parents, qui fonctionnent sur l'ensemble des portefeuilles inscrits ensemble.

Un BSUID peut-il changer ?

Oui. Il est régénéré lorsque l'utilisateur change son numéro de téléphone, et Meta le signale avec un message de système user_changed_user_id et un webhook user_id_update.

Comment réserver mon nom d'utilisateur d'entreprise ?

Depuis le 29 juin 2026, via WhatsApp Manager, Meta Business Suite ou le Username API. Un nom d'utilisateur approuvé devient actif lors du lancement de la fonctionnalité de nom d'utilisateur, et il ne masque pas votre numéro de téléphone d'entreprise.

Sources

• Meta pour les développeurs, Identifiants utilisateur à portée entreprise (format, calendrier, champs webhook, carnet de contacts, paramètre d'envoi, exception au modèle d'authentification), consulté le 26 septembre 2026.
• À propos de Meta, Il est temps de réserver votre nom d'utilisateur WhatsApp, 29 juin 2026, consulté le 26 septembre 2026.