Llegan los nombres de usuario de WhatsApp: tu integración puede dejar de recibir el número del cliente
Para muchas empresas que venden por WhatsApp, el número de teléfono del cliente es la llave de todo. El registro del CRM se guarda con ese número. La consulta de pedidos lo pide. El chatbot y el reporte de anuncios dependen de él. Los nombres de usuario de WhatsApp rompen esa suposición.
En junio de 2026, Meta anunció que las personas ya pueden reservar un nombre de usuario de WhatsApp, y explicó que, cuando la función se lance, “when you message a person or business for the first time they will no longer see your phone number, if you enabled your username” (cuando le escribas por primera vez a una persona o a una empresa, ya no verán tu número de teléfono, si activaste tu nombre de usuario). Para las empresas en la WhatsApp Business Platform, algunos clientes nuevos van a llegar con un ID de usuario con alcance empresarial (business-scoped user ID, o BSUID) en lugar de un número de teléfono.
Este artículo explica qué cambia, quién tiene que actuar y qué revisar en una integración. Todos los datos son de noviembre de 2026, y Meta advierte que su documentación sobre este tema puede cambiar.
Qué está cambiando
- Los nombres de usuario son opcionales y llegan poco a poco. El anuncio de Meta dice que los nombres de usuario se lanzarán “gradually over the coming months” (de forma gradual en los próximos meses) y que WhatsApp te avisará en la app cuando estén disponibles en tu país. A noviembre de 2026, no encontramos una fecha oficial para el lanzamiento global completo. Y como son opcionales, algunos clientes activarán uno y otros no.
- El número de teléfono puede faltar en los webhooks. La documentación para desarrolladores de Meta dice que, si un usuario de WhatsApp activa su nombre de usuario, su número de teléfono no se incluirá en los webhooks, a menos que ya hayas interactuado con esa persona.
- Siempre llega un ID nuevo. Según Meta, los BSUID empezaron a aparecer en los webhooks a comienzos de abril de 2026. El ID viene en el campo
user_idde todos los webhooks de mensajes, tenga o no el usuario un nombre de usuario.
Así que tu integración va a ver dos tipos de clientes durante mucho tiempo: los que llegan con número de teléfono y BSUID, y los que llegan solo con BSUID.
Quién tiene que actuar
La página para desarrolladores de Meta dice que soportar los BSUID “is required for all partners and directly-integrated businesses on the WhatsApp Business Platform” (es obligatorio para todos los partners y para las empresas integradas directamente en la WhatsApp Business Platform). La misma regla aplica a las empresas que pautan con anuncios Click-to-WhatsApp (CTWA). Meta también da la razón: como no puedes controlar si tus usuarios adoptan nombres de usuario, tienes que soportar el BSUID para no perder la capacidad de procesar sus mensajes.
En la práctica:
- Si un proveedor maneja tu integración de WhatsApp (un proveedor de soluciones empresariales, un CRM con conector de WhatsApp, una plataforma de chatbots), pregúntale cómo maneja los BSUID y si pasa ese ID a tus sistemas.
- Si tu equipo construyó la integración sobre la Cloud API, el trabajo le toca a tu equipo.
- Si solo usas la app gratuita WhatsApp Business, las revisiones de abajo no aplican: la app es otro producto, y los requisitos del BSUID son para la Platform. Aun así, según el anuncio de Meta, un cliente nuevo con nombre de usuario tampoco te mostrará su número ahí.
Ten en cuenta que un nombre de usuario de empresa no oculta nada. La página de Meta dice: “Business usernames are not intended for privacy, however. If you adopt a business username, it will not cause your business phone number to be hidden in the app.” (Los nombres de usuario de empresa no están pensados para la privacidad. Si adoptas uno, el número de teléfono de tu empresa no quedará oculto en la app.)
El ID nuevo: el ID de usuario con alcance empresarial
Meta define el BSUID como un identificador único de usuario que sirve para escribirle a un usuario de WhatsApp cuando no conoces su número de teléfono. Algunos detalles importan si lo vas a guardar:
- Formato. Empieza con el código de país ISO de dos letras del usuario (CO para Colombia, por ejemplo) y un punto, seguido de hasta 128 caracteres alfanuméricos. El ejemplo de Meta es
US.13491208655302741918. Una columna de base de datos pensada para un número de teléfono se queda corta. - Alcance. Según Meta, cada BSUID vale solo dentro de un portafolio comercial (business portfolio). Una empresa con varios portafolios ve al mismo cliente con IDs distintos. Meta también ofrece un BSUID padre (parent BSUID) que se mantiene igual en los portafolios inscritos; pregúntale a tu contacto en Meta si puedes usarlo.
- Puede cambiar. Meta dice que el BSUID se regenera si el usuario cambia de número de teléfono, y que eso dispara un webhook de mensaje del sistema. Desde una actualización del 11 de agosto de 2026, estos cambios llegan en el campo
messagesdel webhook como mensajes del sistema. Meta aclara queuser_id_updateno es un campo de webhook al que te puedas suscribir.
Este es un extracto del ejemplo de Meta de un mensaje entrante de un usuario con nombre de usuario. Es solo ilustrativo; revisa la página de Meta para ver el payload completo.
"contacts": [
{
"profile": {
"name": "Sheena Nelson",
"username": "realsheenanelson"
},
"user_id": "US.13491208655302741918",
"parent_user_id": "US.ENT.11815799212886844830"
}
]
Fíjate en lo que falta: no hay wa_id con el número de teléfono. En el mismo ejemplo, el mensaje trae el BSUID en from_user_id y no tiene campo from. parent_user_id solo aparece en empresas que usan BSUID padre.
Cuándo sí recibes el número de teléfono
Meta enumera tres casos en los que el número sigue llegando, incluso si el usuario tiene nombre de usuario:
- Le escribiste o llamaste al número del usuario en los 30 días anteriores al webhook.
- Recibiste un mensaje o una llamada desde el número del usuario en los 30 días anteriores al webhook.
- El usuario está en tu libreta de contactos (contact book).
La revisión de 30 días se hace por cada número de teléfono de la empresa. La libreta de contactos es una función que aloja Meta: cuando le escribes o llamas al número de un usuario, o esa persona te escribe o te llama desde ese número, su número de teléfono y su BSUID se agregan a tu libreta. Meta dice que no requiere trabajo de integración, y que las interacciones anteriores no se agregan de forma retroactiva.
Así que el vacío está sobre todo en los clientes que te escriben por primera vez con un nombre de usuario, y en los clientes antiguos que no están en tu libreta de contactos y no han hablado contigo hace poco.
Qué revisar en tu integración
1. ¿Cómo identifica a los clientes? Si el número de teléfono es la llave principal en tu CRM, tu sistema de pedidos o tu bot, un cliente que llega solo con BSUID no tiene llave. Meta recomienda construir lógica para manejar varios identificadores y mapear los campos relevantes en tu CRM o base de datos. Un enfoque práctico: dale a cada contacto su propio ID interno, guarda el número de teléfono y el BSUID en campos separados y permite que el número quede vacío.
2. ¿Dónde guarda el ID nuevo? Revisa el largo del campo, registra a qué portafolio pertenece el ID y define qué pasa cuando un mensaje del sistema informa un BSUID nuevo para un cliente que ya existe. Si tienes varios portafolios, mira el BSUID padre.
3. ¿Qué flujos necesitan un número de teléfono? Haz la lista de dónde lo necesitas de verdad: entregas, facturas, links de pago, búsqueda de cuentas, una llamada de ventas. Los BSUID sirven para enviar cualquier tipo de mensaje, excepto las plantillas de autenticación de un toque (one-tap), sin toque (zero-tap) y de copiar código (copy code), que necesitan el número del usuario. Para estos flujos, Meta ofrece un botón REQUEST_CONTACT_INFO para plantillas utility y marketing, o como mensaje interactivo. Según Meta, si el usuario toca ese botón, su número de WhatsApp se comparte en la conversación y se dispara un webhook de contactos con ese número. Meta también pide manejar los casos en que el usuario no comparte su número. Pídelo solo donde de verdad hace falta; pedirlo en cada chat agrega fricción para los clientes que decidieron no compartirlo.
4. ¿Puede responder a un BSUID? La página de Meta dice que sus APIs permiten enviar mensajes a un BSUID desde julio de 2026, con un campo nuevo, recipient, junto a to. Si envías los dos, to (el número de teléfono) tiene prioridad. Revisa que tu proveedor o tu librería soporten recipient y manejen el error 131062, que Meta devuelve cuando un mensaje no admite destinatarios BSUID.
5. ¿Tus reportes y la medición de anuncios dependen del número? Si tus reportes de leads, la atribución o tus listas de audiencia se cruzan por número de teléfono, revisa qué hacen con un lead que solo tiene BSUID.
Por dónde empezar
Hazle tres preguntas a tu proveedor o a tus desarrolladores: ¿Guardamos el user_id? ¿Puede existir un contacto sin número de teléfono? ¿Podemos enviar a recipient? Luego vuelve a leer la página de Meta antes de salir a producción. Cambió varias veces en 2026, la última el 5 de noviembre, cuando Meta agregó nuevos códigos de error para nombres de usuario y permitió que la Block Users API acepte un BSUID padre.
Si quieres que alguien más revise cómo tu integración de WhatsApp identifica a los clientes, escríbenos.
Fuentes
Consultadas el 8 de noviembre de 2026. La documentación de Meta cambia seguido, así que revisa los originales antes de decidir.