Todo lo que necesitas saber sobre los nombres de usuario de WhatsApp y BSUID (a partir de junio de 2026)

¿Por qué WhatsApp está introduciendo nombres de usuario?

¿Qué está cambiando?

Los mensajes de autenticación (código de verificación/OTP) deben enviarse mediante el número de teléfono

También hay una limitación importante: los mensajes de autenticación todavía requieren un número de teléfono.
No puedes enviar mensajes de autenticación OTP o de código de copia solo con un BSUID. Si ese flujo es importante para tu negocio, necesitas una forma clara de solicitar y almacenar el número de teléfono del usuario.

Y en algunos casos, WhatsApp aún puede compartir el número de teléfono con la empresa, como cuando:

• El usuario elige activamente compartirlo
• Ya existe una conversación previa entre el usuario y la empresa
• La empresa está guardada en los contactos de WhatsApp del usuario

Así que las empresas ahora deben apoyar ambas situaciones al mismo tiempo:

• Clientes identificados solo mediante BSUID
• Clientes identificados tanto por número de teléfono como por BSUID

Por eso esto no es solo una actualización de producto. Es una actualización del sistema.

¿Qué es el BSUID (ID de Usuario con Alcance Empresarial)?

Cómo funciona el BSUID

• Es generado automáticamente por WhatsApp
• Aparece en las cargas útiles de webhook (como user_id)
• Funciona incluso cuando falta el número de teléfono
• Está vinculado a un portafolio empresarial específico

Así que, desde un punto de vista del sistema, esto se convierte en tu identificador de nuevo usuario en conversaciones entrantes.

Formato BSUID (Cómo luce)

Un BSUID sigue una estructura fija:

• Comienza con el código ISO 3166 alfa-2 Código de país de dos letras
• Seguido por un punto (.)
• Luego una cadena alfanumérica única (hasta 128 caracteres)

Example:
US.13491208655302741918

Al usarlo en APIs, el valor completo debe usarse exactamente como está.
Cualquier cambio o truncamiento hará fallar la solicitud.

Reglas clave que debes conocer

• Un BSUID es único para cada par portfolio de negocio-usuario (los portfolios de negocio antes se conocían como Business Managers)
• Es regenerado si un usuario cambia su número de teléfono (lo que activa un webhook de mensajes de estado del sistema)
• Es limitado a un portfolio de negocio (no puede usarse en diferentes portfolios)
• Aparece en webhooks incluso si el usuario no ha habilitado nombres de usuario

Limitaciones de BSUID

BSUID es potente, pero no un reemplazo completo de números telefónicos.

• No puedes enviar mensajes de autenticación (OTP, códigos de verificación) usando BSUID
• Estos flujos aún requieren un número de teléfono
• Así que si tu caso de uso depende de OTP, debes recolectar el número del usuario

Lo que NO cambiará

Mecanismos de Envío y Recepción de Mensajes

• El uso de plantillas de mensajes permanece sin cambios.
• El soporte para varios tipos de mensajes (texto, imágenes, videos, documentos, etc.) permanece sin cambios.
• La estructura de la interfaz API para enviar mensajes sigue siendo mayormente consistente, excepto que el parámetro de identificador debe ser compatible con BSUID.
• Las empresas que ya tienen información de números de teléfono de conversaciones existentes no la perderán y podrán seguir usándolos para enviar mensajes a sus contactos.

Reglas de Facturación de Conversaciones

• El mecanismo de ventana de conversación de 24 horas permanece sin cambios.
• El método de facturación de conversaciones permanece sin cambios.
• Independientemente de si el cliente usa un número de teléfono o un nombre de usuario, la lógica de facturación sigue siendo consistente.

¿Qué más?

• Los números de teléfono seguirán siendo parte de cómo funciona WhatsApp.
• Si un usuario no ha adoptado nombres de usuario, las empresas recibirán tanto su número de teléfono como el identificador de alcance empresarial.

Esto significa que las empresas deben enfocar sus esfuerzos principales en la identificación del cliente y la asociación de datos; las capacidades centrales de comunicación de mensajes y la lógica de negocio seguirán funcionando como hasta ahora

A continuación, veamos los desafíos que enfrentarán las empresas al adaptarse a este nuevo sistema de identificación.

Desafíos que enfrentan las empresas

Desafío 1: Incapacidad de obtener números de teléfono directamente para nuevos usuarios

Cuando un nuevo usuario se comunica usando un nombre de usuario, solo recibirás un BSUID.

No obtendrás su número de teléfono por defecto.

Aún puedes responder y continuar la conversación usando el BSUID. Pero si tu negocio necesita el número de teléfono (por ejemplo, para OTP o verificación), ahora tienes que pedirlo explícitamente dentro del chat y esperar el consentimiento del usuario.

Desafío 2: Mapeo del BSUID con datos existentes de clientes

La mayoría de los CRMs actuales están construidos alrededor de números de teléfono.

• perfiles de clientes
• historial de chat
• pedidos
• segmentación

Todo está vinculado al número de teléfono como clave principal.

Ahora con el BSUID en escena, necesitas decidir:

• ¿Agregas el BSUID como un nuevo campo?
• ¿O creas una capa de mapeo separada entre el número de teléfono y el BSUID?

Esta no es solo una decisión técnica, impacta en la consistencia de datos, la lógica de consulta y la complejidad del sistema.

Desafío 3: Mantener la continuidad de la conversación cuando los clientes cambian entre diferentes identificadores

Desde el lado del usuario, nada cambia. Sigue siendo una conversación.

Pero desde el lado de tu sistema, las cosas pueden romperse.

Ejemplo:

• Primera interacción → Identificada mediante BSUID
• Posteriormente → El usuario comparte su número de teléfono

Si tu sistema no vincula ambos correctamente, el mismo usuario puede ser tratado como dos clientes diferentes.

Consecuencias:

• Registros duplicados
• Historial de chat fragmentado
• Mala experiencia del cliente

Desafío 4: Manejo de Flujos de Verificación y OTP

El BSUID no puede usarse para mensajes de autenticación.

Así que si tu flujo depende de:

• OTP
• Verificación de inicio de sesión
• Vinculación de cuentas

Primero debes recopilar el número de teléfono del usuario.

Esto significa que tus flujos actuales pueden necesitar rediseñarse para:

• Solicitar consentimiento explícitamente
• Capturar el número
• Almacenarlo y mapearlo correctamente

A continuación, veamos qué fallará realmente si estos desafíos no se manejan adecuadamente.

Qué Fallará (Si Ignoras Esto)

Esto es lo que comienza a fallar:

• Puedes perder conversaciones
  Los nuevos usuarios que lleguen a través de nombres de usuario no se mapearán correctamente en tu sistema.
  

• Los flujos de mensajería se interrumpen
  Los mensajes de servicio y los flujos de CTWA (Click-to-WhatsApp Ads) pueden no activarse como se esperaba.
  

• El historial de chat se desconecta
  El mismo usuario puede aparecer con múltiples identidades.
  

• Los datos del CRM se vuelven poco confiables
  Los perfiles de clientes pueden no almacenar o mapear los datos correctamente.
  

• Aumentan los usuarios duplicados
  Un usuario = múltiples registros entre número de teléfono y BSUID.
  

• La automatización deja de funcionar
  Los flujos de trabajo vinculados a números de teléfono no se activarán.
  

• Los flujos de trabajo de extremo a extremo fallan
  Desde la captura de leads hasta los seguimientos, todo comienza a desmoronarse.
  

• Los equipos de ventas pierden visibilidad
  Los leads no pueden identificarse o rastrearse correctamente.
  

Por eso el impacto es mayor de lo que parece.
No es solo un problema de datos, afecta toda la experiencia del cliente.

A continuación, veamos cómo solucionar esto y manejar la identificación de clientes correctamente.

Soluciones de Identificación de Clientes

Escenario 1: Nuevos clientes que inician contacto por primera vez mediante nombre de usuario (solo BSUID)

Cuando un nuevo cliente inicia una conversación usando un nombre de usuario, tu sistema puede que solo reciba el BSUID.

En este caso, el BSUID se convierte en el punto de partida del perfil de ese cliente.

Así debes manejarlo:

• Tu modelo de datos debe soportar más de un identificador para el mismo cliente.
• Tu CRM debe poder crear un perfil de cliente usando el BSUID.
• Tu sistema debe soportar búsqueda e identificación usando BSUID.
• Si el negocio necesita el número de teléfono (por ejemplo, cuando se requiere una dirección de entrega o hay que enviar un código de verificación), solicítalo en el momento adecuado dentro de la conversación.
• Si el usuario lo comparte, almacena ese número y asócialo al mismo perfil basado en BSUID.

Escenario 2: Clientes cuyo número de teléfono ya tienes

Si tu negocio ya tiene el número de teléfono de un cliente, puedes seguir usándolo.

Esta parte no cambia.

Incluso si el usuario habilita nombres de usuario, aún puedes enviar mensajes usando el número de teléfono que ya conoces. Pero si ese mismo usuario luego inicia una conversación usando un nombre de usuario, tu sistema debe poder conectar el nuevo BSUID con el registro existente basado en número de teléfono.

Así debes manejarlo:

• Tu modelo de datos aún debe soportar múltiples identificadores para un mismo cliente.
• Cuando aparezca un BSUID, asócialo al registro de cliente existente.
• Tu sistema debe soportar búsqueda por número de teléfono o BSUID.
• PriorizE el número de teléfono para mensajería saliente, especialmente para flujos de verificación o autenticación

Línea de tiempo y Plan de acción

WhatsApp está implementando esto en fases, lo que le da tiempo para prepararse, pero solo si comienza temprano.

Línea de tiempo

• 31 de marzo de 2026 → BSUID comenzará a aparecer en los Webhooks.
• Mayo de 2026 → Pruebas de BSUID disponibles (puede comenzar a enviar usando BSUID).
• Junio de 2026 → Las personas en países de prueba pueden comenzar a adoptar nombres de usuario. Comienza el lanzamiento de nombres de usuario.
• Resto de 2026 → Personas en todo el mundo pueden comenzar a adoptar nombres de usuario.

Qué deben hacer las empresas

1. Fase de preparación (Actual)

• Aprenda y comprenda el mecanismo y los detalles técnicos de BSUID.
• Identifique dónde se utilizan los números de teléfono en los flujos de trabajo.
• Defina cómo manejará el número de teléfono frente a BSUID.
• Evalúa el alcance y la carga de trabajo necesarios para modificar los sistemas existentes.
• Desarrolla planes para ajustes de bases de datos y compatibilidad de API.
• Comienza la investigación técnica y el diseño de soluciones.
• Alinea a los equipos internos (producto, ingeniería, marketing) y planifica tu estrategia de nombre de usuario empresarial.

2. Fase de Implementación (Antes del Lanzamiento de la Función)

• Actualiza el CRM y la base de datos para admitir BSUID.
• Completa la transformación de compatibilidad de la capa de integración de API.
• Implementa el proceso de solicitud de autorización de números de teléfono.
• Asegúrate de que los mensajes de código de verificación se envíen usando números de teléfono.
• Completa la verificación del entorno de prueba.
• Prepara un plan de lanzamiento gradual (lanzamiento en gris).

3. Prueba

• Realiza pruebas de extremo a extremo con escenarios reales.
• Valida:
  • Creación de usuarios basada en BSUID
  • Flujos de recopilación de números de teléfono
  • Mapeo entre identificadores
  • Flujos de mensajería y automatización

4. Fase de Go-Live (Después de que la Función entre en Vivo)

• Lanza en fases (no cambies todo de una vez).
• Monitorea la salud operativa del sistema, como la precisión en la creación de perfiles, las tasas de éxito de OTP y el rendimiento del flujo de trabajo.
• Atiende los comentarios de los usuarios y maneja anomalías.
• Optimiza la lógica de identificación de clientes.
• Mejora continuamente la precisión de la asociación de datos.
• Monitorea las tasas de autorización de números de teléfono y optimiza el momento y los mensajes utilizados para las solicitudes.
• Reclama y configura tu nombre de usuario empresarial.

Lista de Verificación Pre-Lanzamiento

Antes de ir en vivo, asegúrate de:

• El BSUID está integrado en todos tus sistemas.
• Puedes seguir enviando y recibiendo mensajes sin números de teléfono.
• Todos los flujos de trabajo están probados para ambos identificadores.
• Los chatbots y journeys pueden solicitar números de teléfono cuando sea necesario.
• Los flujos de trabajo existentes están auditados y actualizados para evitar fallos.

Priorización

• Alta Prioridad → Ajustes en la estructura del CRM y la base de datos, modificaciones en la compatibilidad de la API, ajustes en la lógica de envío de códigos de verificación (afecta la funcionalidad principal).
• Prioridad Media → Adaptación de los sistemas de atención al cliente, actualizaciones de los sistemas de marketing (afecta la eficiencia del negocio).
• Prioridad Baja → Optimización de informes de datos, limpieza de datos históricos (se puede refinar gradualmente).

Esto no es algo que debas solucionar en el último momento.
Cuanto antes te adaptes, más suave será tu transición.

Dónde Encontrar Más Recursos

Si estás implementando esto, no confíes en suposiciones, usa la documentación oficial.

Estos son los recursos clave para comenzar:

• Guía de BSUID
  https://docs.ycloud.com/reference/bsuid
  → Cubre cómo funciona el BSUID, su formato y uso en las APIs
  
  

• Actualizaciones de Webhook (campos BSUID)
  https://docs.ycloud.com/reference/webhook-updates-bsuid
  → Te ayuda a entender cómo aparece el BSUID en las cargas útiles de webhook y qué cambia en la integración
  
  

• Documentación para Desarrolladores de Meta (BSUID)
  https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids
  → Referencia oficial sobre cómo se introduce y utiliza el BSUID en las APIs de WhatsApp
  
  

Estas deberían ser tus referencias principales al actualizar tu sistema.

¡Conclusión!

Glosario

Aquí están los términos clave que verás en webhooks y APIs, explicados de manera simple:

• contactos (nuevo array)
  Una lista de usuarios involucrados en el mensaje. Piensa en esto como la "sección de información del cliente" en el webhook.
  

• perfil
  Detalles básicos sobre el usuario dentro de contactos.
  

• nombre de usuario
  Nuevo atributo. El nombre de usuario de WhatsApp del usuario (si lo ha habilitado).
  Si el usuario no ha establecido un nombre de usuario, este campo no aparecerá.
  
  

• wa_id
  Nuevo atributo. El número de teléfono del usuario.
  Si el número de teléfono está disponible, lo verás aquí.
  Si el usuario está usando un nombre de usuario y el número no se comparte, esto puede faltar.
  
  
  

• user_id (BSUID)
  Nuevo atributo. El campo más importante de ahora en adelante.
  Este es el BSUID, un ID único que representa al usuario para tu negocio.
  Siempre estará presente y debe usarse para identificar usuarios cuando el número de teléfono no esté disponible.
  
  
  

• parent_user_id
  Un BSUID de nivel superior que puede funcionar en múltiples portafolios de negocios (si está habilitado).
  La mayoría de los negocios no usarán esto a menos que gestionen múltiples portafolios.
  
  

Forma sencilla de entenderlo:

• wa_id → Número de teléfono (puede o no estar disponible)
• user_id → BSUID (siempre disponible, nuevo valor predeterminado)
• username → Lo que el usuario muestra públicamente