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 por número de teléfono

También hay una limitación importante: los mensajes de autenticación aún requieren un número de teléfono.
No puedes enviar mensajes de autenticación OTP o copy-code usando solo un BSUID. Si ese flujo es importante para tu empresa, 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 entre el usuario y la empresa
• La empresa está guardada en los contactos de WhatsApp del usuario

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

• Clientes identificados solo a través de 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 BSUID (Business Scoped User ID)?

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 de portafolio de negocio-usuario (los portafolios de negocio antes se conocían como Business Managers)
• Se regenera si un usuario cambia su número de teléfono (lo que activa un webhook de mensajes de estado del sistema)
• Está limitado a un portafolio de negocio (no puede usarse en diferentes portafolios)
• Aparece en webhooks incluso si el usuario no ha habilitado nombres de usuario

Limitaciones del BSUID

El BSUID es potente, pero no reemplaza completamente a los números de teléfono.

• 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
• Por lo tanto, si tu caso de uso depende de OTP, debes recolectar el número del usuario

Qué NO está cambiando

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 ámbito 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 comercial 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 directamente números de teléfono 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 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: Asignación de BSUID con datos de clientes existentes

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 BSUID en juego, necesitas decidir:

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

Esto no es solo una decisión técnica, impacta en la consistencia de los 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 → Identificado 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ícito
• 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 llegan a través de nombres de usuario no se mapearán correctamente en tu sistema.
  

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

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

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

• Los usuarios duplicados aumentan
  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 se rompen
  Desde la captura de leads hasta los seguimientos, las cosas comienzan 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 todo el recorrido del cliente.

A continuación, veamos cómo solucionar esto y manejar la identificación del cliente 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 solo recibir el BSUID.

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

Así es como 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 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 se necesita 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 nuevamente 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í es como manejarlo:

• Tu modelo de datos aún debe soportar múltiples identificadores para un 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.
• Prioriza el número de teléfono para mensajería saliente, especialmente para flujos de verificación o autenticación

Cronograma & Plan de Acción

WhatsApp está implementando esto en fases, lo que te da tiempo para prepararte, pero solo si comienzas temprano.

Cronograma

• 31 de marzo de 2026 → BSUID comenzará a aparecer en Webhook.
• Mayo 2026 → Pruebas de BSUID disponibles (puedes comenzar a enviar usando BSUID).
• Junio 2026 → Personas en países de prueba pueden comenzar a adoptar nombres de usuario. Comienza el despliegue 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)

• Aprender y comprender el mecanismo BSUID y los detalles técnicos.
• Identificar dónde se utilizan los números de teléfono en los flujos de trabajo.
• Definir cómo manejará el número de teléfono frente al BSUID.
• Evaluar el alcance y la carga de trabajo necesarios para modificar los sistemas existentes.
• Desarrollar planes para ajustes en la base de datos y compatibilidad de la API.
• Comenzar la investigación técnica y el diseño de soluciones.
• Alinear a los equipos internos (producto, ingeniería, marketing) y planificar su estrategia de nombre de usuario comercial.

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

• Actualizar el CRM y la base de datos para admitir BSUID.
• Completar la transformación de compatibilidad de la capa de integración de la API.
• Implementar el proceso de solicitud de autorización del número de teléfono.
• Asegurarse de que los mensajes de código de verificación se envíen utilizando números de teléfono.
• Completar la verificación del entorno de prueba.
• Preparar un plan de implementación gradual (lanzamiento en gris).

3. Prueba

• Ejecutar pruebas de extremo a extremo con escenarios reales.
• Validar:
  • 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 Implementación (Después de que la Función Entra en Vigor)

• Implementar en fases (no cambiar todo de una vez).
• Monitorear la salud operativa del sistema, como la precisión en la creación de perfiles, las tasas de éxito de OTP y el rendimiento de los flujos de trabajo.
• Abordar los comentarios de los usuarios y manejar anomalías.
• Optimizar la lógica de identificación de clientes.
• Mejorar continuamente la precisión de la asociación de datos.
• Monitorear las tasas de autorización de números de teléfono y optimizar el momento y los mensajes utilizados para las solicitudes.
• Reclamar y configurar su nombre de usuario comercial.

Lista de Verificación Previo al 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 recorridos 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 bases de datos, modificaciones de compatibilidad de 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).
• Baja Prioridad → Optimización de informes de datos, limpieza de datos históricos (puede refinarse 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 te bases 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 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 API 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 en términos simples:

• contacts (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.
  

• profile
  Detalles básicos sobre el usuario dentro de contacts.
  

• username
  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á utilizando 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 negocio (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 por defecto)
• username → Lo que el usuario muestra públicamente