BSUID y usernames en WhatsApp: qué ya cambió y qué hacer ahora
Meta ya entrega el BSUID en los webhooks y habilitó usernames para empresas. Mira la línea de tiempo real, qué cambia en tu CRM y cómo pedir el teléfono del cliente cuando lo necesites.

Marlos Carmo
Fundador de Tolky
Actualizado el 15 de noviembre de 2026

Compartir
Hay un cambio que no aparece como breaking change y no tumba tu integración de la noche a la mañana, pero deja obsoleta una suposición que muchos CRM, bots y plataformas de atención cargan: el cliente es su número de teléfono.
Ese cambio se llama BSUID, Business-Scoped User ID. Y viene acompañado de un recurso nuevo en WhatsApp: los usernames. Este artículo se actualizó el 15/11/2026 para reflejar lo que Meta ya puso en producción, con base en la documentación oficial de BSUID y el changelog de Meta.
¿Qué son los usernames de WhatsApp?
Los usuarios pueden elegir un nombre de usuario único en WhatsApp, algo como @joaosilva. El despliegue es gradual. El 29/06/2026 Meta abrió la reserva y adopción de usernames para empresas, y la prensa especializada (Mobiletime, 06/07/2026) confirmó que los usuarios en Brasil ya pueden elegir su @username, con acceso todavía escalonado.
La diferencia con el número es radical: el username lo elige el usuario y permite iniciar una conversación con una empresa sin revelar el teléfono. Para quien opera una plataforma de atención en WhatsApp, esto invierte el flujo de información: antes siempre recibías el +55 11 9xxxx-xxxx; ahora puedes recibir solo un identificador.

¿Qué es el BSUID?
El BSUID es el identificador que Meta crea para cada par único de usuario y portafolio de negocios. El formato es un prefijo de dos letras del país, un punto y hasta 128 caracteres alfanuméricos, por ejemplo BR.13491208655302741918.
La propiedad central es el alcance: el mismo usuario tiene BSUID distintos para cada empresa. João, que habla con tu empresa y con un competidor, tiene dos identificadores sin relación entre sí, lo que protege la privacidad. El BSUID solo se regenera cuando el usuario cambia de número.
Desde principios de abril de 2026 (Meta pospuso el despliegue del 31/03 a "early April" en su changelog), el BSUID aparece en los webhooks sin importar si el usuario adoptó un username. Todo cliente tuyo ya tiene BSUID; solo necesitas capturarlo.
¿Por qué es un cambio estructural?
wa_id siempre fue el número de teléfono. Todo esquema de base de datos, lógica de deduplicación, automatización e integración con ERP nació con esa premisa: el teléfono era canal de contacto, identificador de sistema y dato de CRM a la vez.
El BSUID rompe esa equivalencia. El identificador de sistema (user_id) puede llegar sin el teléfono, y cuantos más usuarios adopten usernames, mayor la proporción de conversaciones sin wa_id. Los sistemas que no se adapten no explotan: pierden conversaciones en silencio (lo llamamos "silencio operativo", expresión de este blog, no un término de Meta). El dashboard no muestra errores, pero un cliente con años de historial aparece como "nuevo" y el agente lo atiende sin contexto.
Cuándo aún aparece el teléfono: Contact Book y la regla de 30 días
Meta mantiene un contact book alojado por ella, a nivel de portafolio y sin trabajo de integración, que relaciona teléfono y BSUID. Solo registra interacciones posteriores a su lanzamiento.
Según la documentación, el teléfono del usuario sigue apareciendo en el webhook cuando:
- hubo mensaje o llamada entre el usuario y ese número de teléfono de la empresa en los últimos 30 días (la regla es por número comercial, no por portafolio); o
- el usuario está en el contact book.
Fuera de esas condiciones, wa_id y el teléfono en from pueden omitirse. El 24/08/2026 Meta también lanzó un endpoint para comprobar si un usuario está en el contact book.
En la práctica: los clientes que ya hablaron contigo suelen estar protegidos; los clientes nuevos con username llegan solo con BSUID.
Línea de tiempo (según Meta)
| Fecha | Qué ocurrió |
|---|---|
| Inicios de abr/2026 | El BSUID empieza a aparecer en los webhooks (despliegue pospuesto desde el 31/03) |
| Abr/2026 | El contact book de Meta empieza a mapear teléfono y BSUID |
| 28/05/2026 | contact_request pasa a llamarse request_contact_info |
| 29/06/2026 | Las empresas pueden reservar y adoptar usernames (WhatsApp Manager, Business Suite, Business app o Username API); el envío por BSUID pasó de mayo a julio |
| Jul/2026 | Disponibles el envío de mensajes a BSUID y el botón para pedir el teléfono |
| 11/08/2026 | user_id_update deja de ser webhook; los cambios de BSUID llegan como mensajes de sistema user_changed_user_id con previous_user_id |
| 24/08/2026 | Endpoint para comprobar presencia en el contact book |
| 15/09/2026 | El webhook business_username_updates incorpora context: revoked |
| 23/10/2026 | Límite de 2 cambios de username cada 14 días por número (error 130429) |
| 05/11/2026 | Block Users acepta parent BSUID |
En resumen, la ventana de "prepararse" terminó. Hoy el trabajo es comprobar que lo implementado funciona en producción.
Cómo cambia el webhook en la práctica
{
"contacts": [
{
"profile": { "name": "João Silva" },
"wa_id": "5511999991234",
"user_id": "BR.13491208655302741918",
"username": "joaosilva"
}
],
"messages": [
{
"from": "BR.13491208655302741918",
"id": "wamid.xxx",
"timestamp": "1748822400",
"text": { "body": "Hola, necesito ayuda" },
"type": "text"
}
]
}Ese es el caso en que el teléfono aún está disponible. Cuando no se cumplen las condiciones de 30 días o de contact book, el wa_id simplemente no llega:
{
"contacts": [
{
"profile": { "name": "Maria Oliveira" },
"user_id": "BR.98765432109876543210",
"username": "mariaoliveira"
}
],
"messages": [
{
"from": "BR.98765432109876543210",
"id": "wamid.yyy",
"text": { "body": "Quiero saber el estado de mi pedido" },
"type": "text"
}
]
}Hay además campos nuevos: parent_user_id y from_parent_user_id (el parent BSUID, con formato US.ENT.…, usado entre portafolios vinculados) y recipient_user_id en los estados de envío. Todo código que haga const customerId = message.from asumiendo un teléfono debe revisarse.
Ejemplo: el lead de anuncio que llega sin teléfono
Imagina un lead que hace clic en un anuncio Click-to-WhatsApp y escribe a la empresa. Usa username, nunca habló contigo y por eso llega solo con el BSUID. Un sistema atado al teléfono descarta el mensaje o crea un registro "fantasma". Un flujo preparado hace tres cosas: crea el contacto con el BSUID, pide el teléfono en el momento adecuado con el botón "Compartir contacto" (solo si el proceso realmente lo necesita) y, al recibir el número, lo fusiona con el registro existente. Es un escenario ilustrativo, pero exactamente el tipo de caso que este cambio vuelve común.
Cuando necesitas el teléfono: el botón de pedir contacto
Para OTP, entrega, cobranza o sistemas heredados, Meta ofrece REQUEST_CONTACT_INFO: un botón en plantillas utility o marketing, o el mensaje interactivo request_contact_info (con ese nombre desde el 28/05/2026). La etiqueta es fija ("Share Contact Info") y no se puede personalizar, y el teléfono llega por webhook cuando el usuario toca el botón. Está disponible desde principios de julio de 2026.
{
"type": "interactive",
"interactive": {
"type": "request_contact_info",
"body": {
"text": "Para continuar, necesitamos tu número de teléfono."
}
}
}Dos cuidados. Primero, las plantillas de autenticación (OTP: one-tap, zero-tap y copy code) no pueden enviarse a un BSUID, solo a un teléfono; si tu onboarding depende de OTP, pide el número antes. Segundo, la solicitud debe ser contextual y, siempre que se pueda, opcional: Meta espera que el usuario tenga control, y bloquear la atención por el teléfono va contra la dirección de privacidad de la plataforma.
Impacto en el CRM: identidad con teléfono y BSUID
El cambio más profundo es de modelo de datos. El CRM debe tratar teléfono y BSUID como campos independientes, ambos utilizables como clave de búsqueda, con una clave interna canónica por contacto. Para quien usa un AI CRM, esto afecta directamente la integración de IA con CRM. Pasos mínimos:
- agregar el campo
bsuida los contactos; - permitir nulos (hay clientes sin interacción reciente);
- indexar el campo, porque la búsqueda debe ser rápida;
- implementar fusión (merge): cuando lleguen BSUID y teléfono juntos, cruzar con los registros existentes.
ALTER TABLE contacts ADD COLUMN whatsapp_bsuid VARCHAR(135) UNIQUE;
CREATE INDEX idx_contacts_bsuid ON contacts (whatsapp_bsuid);El orden recomendado de identificación es: buscar por BSUID (user_id); si no se encuentra, por teléfono (wa_id); si no hay coincidencia, crear un registro nuevo; si se encuentra por teléfono sin BSUID, guardar el BSUID.
async function resolveContact(webhook: WhatsAppWebhook): Promise<Contact> {
const bsuid = webhook.contacts[0]?.user_id;
const phone = webhook.contacts[0]?.wa_id;
if (bsuid) {
const byBsuid = await db.contacts.findByBsuid(bsuid);
if (byBsuid) return byBsuid;
}
if (phone) {
const byPhone = await db.contacts.findByPhone(phone);
if (byPhone) {
if (bsuid && !byPhone.bsuid) {
await db.contacts.update(byPhone.id, { bsuid });
}
return byPhone;
}
}
return db.contacts.create({ phone, bsuid });
}Sin esto, el mismo cliente entra por teléfono en febrero y por username en agosto, y terminas con dos perfiles y dos historiales. Para entender por qué el teléfono nunca fue un buen identificador de CRM, lee también WhatsApp no es un CRM.
Privacidad y alcance del identificador
El BSUID es una protección de privacidad: al adoptar un username, el usuario conversa con varias empresas sin exponer su teléfono. Aunque dos empresas compartieran todos sus BSUID, no podrían cruzar qué usuarios son los mismos. Para las empresas, terminó la era de tratar el teléfono como el "documento de identidad de WhatsApp": el BSUID vale dentro de tu portafolio de negocios y se regenera si el usuario cambia de número. Meta informa que WhatsApp tiene más de 3.000 millones de usuarios mensuales, lo que explica la cautela con un identificador universal.
Cambio de proveedor: valida la continuidad
Una versión anterior de este texto afirmaba que migrar la WABA a otro proveedor genera nuevos BSUID. La documentación de Meta no dice eso: los BSUID tienen alcance de portafolio de negocios y solo se regeneran cuando el usuario cambia de número. Aun así, si piensas cambiar de proveedor, pregunta cómo se exportarán y mantendrán el contact book y el mapeo BSUID y teléfono. Recuerda también que enviar a un BSUID de un número vinculado a otro portafolio falla, y que el parent BSUID puede usarse entre portafolios vinculados.
Anuncios Click-to-WhatsApp, chatbots y automatizaciones
En anuncios CTWA, el from de un usuario con username es un BSUID desconocido para el CRM. Si usas el teléfono para cruzar el lead con el CRM de ventas y medir el CAC, la atribución debe aceptar el BSUID como identificador primario.
En chatbots, no asumas que el teléfono estará disponible desde el inicio. Los bots que hacen buscarCliente(message.from) deben contemplar ambos escenarios. Para la mayoría de los flujos (abrir un caso, consultar un pedido, FAQ), lo que siempre importó fue un identificador único del cliente, no el teléfono en sí. Si el bot confirma identidad con documento o e-mail y usa el teléfono como confirmación secundaria, adapta el flujo para pedir el dato solo cuando haga falta.
Usernames para empresas
Las empresas pueden reservar y adoptar un username desde el 29/06/2026, por WhatsApp Manager, Business Suite, la Business app o la Username API. Un username facilita encontrar la marca sin depender del número. Los requisitos que cita la documentación incluyen:
- límite de mensajes del portafolio suficiente (error 147002 si no);
- número registrado en la API;
- vínculo con la Page o con Instagram si el username ya se usa allí;
- máximo 2 cambios cada 14 días por número (error 130429, desde el 23/10/2026).
Atención al formato del enlace: la documentación oficial no describe un patrón wa.me/c/..., y guías de terceros citan wa.me/<username>. Verifica el enlace generado por el propio WhatsApp Manager antes de usarlo en anuncios, bios y códigos QR. La documentación tampoco menciona prioridad para empresas verificadas.
Impacto por tipo de operación
Atención al cliente: impacto medio. Los clientes existentes suelen estar en el contact book; el riesgo está en los clientes nuevos sin teléfono. Ajustar la deduplicación lo resuelve.
Ventas y SDR: impacto alto, porque la calificación cruza WhatsApp con el CRM. Mira cómo rediseñar el recorrido en calificación de leads B2B con IA.
Marketing y campañas: impacto alto. Las listas conocidas no cambian, pero los leads nuevos de CTWA pueden llegar sin teléfono, afectando segmentación y nutrición. Recuerda que reactivar fuera de la ventana de 24 h exige plantilla y opt-in, y cada mensaje se cobra: mira la nueva tarificación de WhatsApp Business.
Soporte y CX: impacto bajo a medio, siempre que la plataforma se adapte. Un cliente que cambia de número pero conserva el username sigue siendo reconocible.
Plan de acción revisado
- Diagnóstico: lista todos los puntos donde se asume el teléfono como obligatorio (base de datos, validaciones, deduplicación, consultas, APIs).
- Esquema: agrega el BSUID, haz el teléfono opcional donde se pueda e implementa la búsqueda doble.
- Captura: confirma en producción que
user_idse guarda en todos los webhooks y usa el contact book para enriquecer la base. - Prueba de extremo a extremo: simula una conversación que llega solo con BSUID, revisa deduplicación, historial y entrega de la respuesta, y prueba la solicitud de teléfono con
request_contact_info. - Monitoreo: sigue la duplicidad de contactos, las conversaciones perdidas y el mensaje de sistema
user_changed_user_id.
Dónde entra Tolky
Para Tolky, la identidad es parte de la cadena de atención: el objetivo es mantener el historial del cliente unificado, con la IA y los agentes humanos viendo el mismo contacto, llegue la conversación con teléfono o con BSUID. El comportamiento exacto con BSUID, contact book y botón de pedir teléfono en tu operación debe validarse con el equipo. Si usas otra plataforma, pregunta a tu proveedor: ¿se captura el BSUID desde abril? ¿Hay campo en el perfil del contacto? ¿La deduplicación considera ambos identificadores? La respuesta dice mucho sobre la madurez de la solución.
¿Quieres validar tu base de contactos para el BSUID? Habla con el equipo de Tolky. Para entender el impacto del costo por mensaje, mira también la nueva tarificación de WhatsApp Business y nuestra reseña del comunicado de Gupshup sobre BSUID.
El BSUID no es el fin del número de teléfono en WhatsApp: la mayoría de tus clientes seguirá apareciendo con teléfono por bastante tiempo. Pero la identidad del usuario ahora pertenece al usuario, y quienes se adaptaron evitan duplicados en el CRM, historial perdido y automatizaciones que "simplemente dejaron de funcionar" para una porción creciente de contactos.
Compartir
Citado en
- Ventana de 24 horas, plantillas y campañas en WhatsApp sin bloqueos
- Qué cambió el 1 de octubre: costos de WhatsApp Business en Brasil
- Gupshup, BSUID y usernames: qué están haciendo los BSP como Gupshup
- IA conversacional a escala: qué sostiene las conversaciones B2B
- Pérdida de leads en WhatsApp: oportunidades que se escapan en el chat
- WhatsApp no es CRM: por qué pierdes ventas, datos y clientes
- Qué es el CRM conversacional: diferencias con CRM omnicanal y chatbot
- Chatbot con inteligencia artificial: qué es y cómo funciona hoy
- Chatbot para WhatsApp: cómo funciona y cómo crearlo
- Plataforma de atención en WhatsApp: la guía definitiva para empresas
- Software de atención al cliente: cómo elegir la mejor plataforma
- WhatsApp Business API: beneficios para su empresa
- Qué es la atención omnicanal y por qué tu empresa la necesita ahora
- WhatsApp como central de atención: ventajas, riesgos e implementación
Sobre el autor

Marlos Carmo
Fundador de Tolky
Marlos Carmo es un emprendedor en IA y fundador de Tolky, la infraestructura y AI CRM de la era conversacional que unifica el servicio inteligente, la omnicanalidad (como WhatsApp y voz), el CRM en vivo y la inteligencia operativa en un único ecosistema. Es finalista del SXSW Innovation Awards e integrante de la Francesco's Economy, una red global de jóvenes emprendedores enfocados en la innovación y el impacto social. Trabaja conectando la Inteligencia Artificial y la transformación digital en proyectos para grandes organizaciones.
Siguiente paso
¿Quieres llevar esto a tu operación?
Tati, la asistente de IA de Tolky, entiende tu escenario en pocas preguntas, sugiere el mejor camino y te conecta con una persona del equipo con todo el contexto.


