En este artículo encontrarás una explicación detallada sobre la transición de WhatsApp hacia los nombres de usuario y el identificador BSUID, incluyendo a quiénes impacta este cambio, las actualizaciones técnicas en la plataforma Botmaker y una guía de preguntas frecuentes para que tu empresa adapte sus procesos y sistemas antes de junio de 2026.
A partir de 2026, WhatsApp Business Platform introduce cambios significativos en la forma en que las empresas identifican y se comunican con sus usuarios. Esta evolución busca priorizar la privacidad, permitiendo que las personas interactúen con negocios sin necesidad de compartir su número de teléfono. La reserva de usernames abre el 29 de junio de 2026 a nivel global, y la activación se habilita por oleadas (waves) según el país.
Puedes:
Tener al menos un canal de WhatsApp Business Platform conectado a Botmaker. Acceso a tu cuenta de Botmaker con permisos para administrar bots, contactos e integraciones.
BSUID (Business Scoped User ID): identificador único y anónimo generado por Meta para cada combinación específica de usuario y empresa. Es una cadena alfanumérica de hasta 128 caracteres.
Username: nombre de usuario público que cada persona puede activar en WhatsApp como alternativa a compartir su número de teléfono.
ChatID: identificador único de cada chat en Botmaker, independiente del canal o de la identidad del usuario.
Contact ID / platformContactId: identificador del usuario en el canal dentro de Botmaker. Puede contener el número de teléfono o el BSUID según el caso.
${whatsappNumber}: variable que almacena el número de teléfono únicamente cuando el usuario lo comparte explícitamente.
Libreta de Contactos (Contact Book): función de Meta Business Suite que permite mantener visibles los números de los clientes actuales una vez que activen su username.
El Business Scoped User ID (BSUID) es un identificador único y anónimo generado por Meta para cada combinación específica de usuario y empresa.
El cambio se despliega en dos planos. Por un lado, la infraestructura del BSUID y la API; por otro, la reserva y activación de los usernames de los usuarios finales, que se habilita por oleadas según el país.
No existe una fecha de “apagado” global del número de teléfono. El número deja de estar disponible en la plataforma de forma individual, cuando cada usuario activa su username (función opt-in).
La reserva de usernames abre el 29 de junio de 2026 a nivel global. Desde esa fecha, todas las empresas del mundo pueden reservar su username preferido; reservarlo temprano protege el nombre de tu marca antes de su activación.
La activación (cuando el username pasa a ser utilizable) se habilita por oleadas:
Oleada | Fecha | Países |
Wave 1 | 7 de julio de 2026 | Argelia, Azerbaiyán, Ghana, Libia, Nepal |
Wave 2 | 20 de julio de 2026 | Colombia, Singapur, Perú, Malasia, República Dominicana |
Disponibilidad global | Fines de agosto de 2026 | Resto de los países |
Las empresas pueden reservar o reclamar sus usernames a través de WhatsApp Manager, Meta Business Suite o la Username API.
Paso a paso: si quieres ver cómo reservar y registrar tu username paso a paso, dentro de Botmaker o en el Business Manager de Meta, te compartimos el artículo “Cómo registrar tu username de WhatsApp en Botmaker”.
Importante para clientes integrados por API: además de reservar el username, debes asegurarte de que tus sistemas soporten los Business-Scoped User IDs (BSUID) junto con los números de teléfono. La documentación técnica está en Business Scoped User IDs (Meta).
Qué comunicar a tus clientes: la reserva de usernames abre a fines de junio de 2026 y la usabilidad real depende de la oleada de rollout de su país. Reservar temprano protege su nombre preferido.
Nota: cuando un usuario activa su username, su número de teléfono deja de estar disponible para la empresa, salvo que haya habido interacción en los últimos 30 días, esté en la libreta de contactos de la empresa, u otras excepciones definidas por Meta.
Botmaker se está adaptando para que esta transición sea fluida:
El identificador único del usuario en Botmaker pasará a ser independiente del medio: podrás escribir, buscar chats o enviar plantillas indistintamente por número de teléfono o por BSUID, y la plataforma resolverá el resto.
Botmaker pone a disposición el BSUID y el número de teléfono dentro de la plataforma a través de la variable del bot ${bsuid}, y también permite consumirlos desde sistemas externos por API o webhooks.
En la medida en que el BSUID esté disponible, podrás encontrar los datos en cuatro lugares:
A partir del cambio, Botmaker maneja tres variables clave que conviene conocer en detalle. Cada una cumple un rol distinto:
Nota: a partir del rollout, el platformContactId puede dejar de ser un número de teléfono y pasar a contener un BSUID. Cualquier lógica del bot, validación o integración que asuma formato numérico deberá ajustarse para soportar cadenas alfanuméricas de hasta 128 caracteres.
El BSUID y el número de teléfono ya están disponibles dentro de las acciones de código. Puedes acceder a ellos directamente desde el contexto del usuario:
Esto te permite consumir ambos identificadores dentro de tu lógica de negocio sin requerir configuración adicional.
Botmaker incorporó el endpoint /contacts, que permite descargar la información de los contactos, incluyendo el BSUID asociado. La API de Contactos ya está disponible.
Además del endpoint /contacts, los endpoints existentes ya permiten referenciar a un usuario por número de teléfono o por BSUID de forma intercambiable. Esto aplica al envío de plantillas, búsqueda de chats y otras operaciones.
Los webhooks de Botmaker ya están enviando el BSUID en su payload, junto con el número de teléfono cuando está disponible. Cuando un usuario interactúa por WhatsApp y Botmaker dispone del BSUID, este se envía automáticamente a través del campo correspondiente, sin requerir cambios en la configuración existente de tus webhooks.
Para que tu integración funcione antes y después del rollout sin requerir ajustes urgentes:
Es importante identificar qué procesos se verán modificados y cuáles permanecerán iguales.
Sí se ven afectados:
No se ven afectados:
Se mantendrá la capacidad de enviar plantillas de notificación utilizando los números de teléfono tradicionales, ya que el sistema permitirá referenciar las conversaciones de WhatsApp mediante el ChatID, el número de teléfono o el nuevo BSUID.
Para los contactos que ya cuentan con un número registrado por interacciones previas, Botmaker conservará ambos datos para garantizar la continuidad del servicio.
Para evitar interrupciones, te recomendamos seguir estos pasos:
Adopta también las nuevas variables y fuentes de datos en la plataforma: usa bsuid**,ContactIDy**{whatsappNumber} según corresponda en cada flujo del bot, consume context.userData.bsuid y context.userData.whatsappNumber desde tus acciones de código, y aprovecha el endpoint /contacts de la API cuando necesites consumir los datos desde sistemas externos.
Preguntas frecuentes (FAQ)
¿Cuándo puedo reservar el username de mi empresa?
La reserva abre el 29 de junio de 2026 a nivel global: cualquier empresa del mundo puede reservar su username preferido desde esa fecha. Reservarlo temprano protege el nombre de tu marca antes de su activación.
¿Desde dónde se reserva o reclama un username?
Desde tres lugares: WhatsApp Manager, Meta Business Suite o la Username API.
¿Cuándo queda usable el username en mi país?
La activación es por oleadas. Wave 1 (7 de julio): Argelia, Azerbaiyán, Ghana, Libia y Nepal. Wave 2 (20 de julio): Colombia, Singapur, Perú, Malasia y República Dominicana. Disponibilidad global: fines de agosto de 2026. Reservar el username no depende de la oleada; la usabilidad sí.
Soy un cliente integrado por API, ¿qué debo tener en cuenta?
Además de reservar el username, asegúrate de que tus sistemas soporten los Business-Scoped User IDs (BSUID) junto con los números de teléfono. Los detalles técnicos están en la documentación de Meta.
¿Dónde puedo encontrar el BSUID y el número de teléfono dentro de Botmaker?
En cuatro lugares, en la medida en que el BSUID esté disponible: en la pantalla de contactos; en los webhooks; en las acciones de código (context.userData.bsuid y context.userData.whatsappNumber); y por API, descargando los contactos a través del endpoint /contacts.
¿Cómo se enviarán las notificaciones?
Las empresas podrán referirse a las conversaciones de WhatsApp y enviar notificaciones utilizando tres tipos de identificadores: ChatID, número de teléfono o BSUID.
¿Qué pasa si un usuario no quiere compartir su número de teléfono? ¿Cómo se le envían plantillas?
Si el usuario opta por ocultar su número, la empresa recibirá su BSUID. Puedes seguir enviando campañas salientes o mensajes a través de la API utilizando este identificador. Si por razones operativas necesitas el número, puedes solicitárselo mediante una plantilla de utilidad o de marketing.
¿Se podrán seguir enviando plantillas a usuarios con número de teléfono?
Sí. Si ya tienes el número de WhatsApp registrado por interacciones previas, Botmaker conservará ambos datos (teléfono y BSUID). Además, para los contactos existentes, el número seguirá siendo visible y utilizable si el usuario ya está en tu libreta de contactos de Meta.
¿Cómo se van a seguir enviando plantillas?
El proceso técnico se mantiene similar, pero con mayor flexibilidad en el identificador. Las campañas de marketing y mensajes de utilidad podrán dispararse usando el BSUID. Las plantillas de autenticación (OTP) no sufrirán cambios y podrán enviarse únicamente por número de teléfono, no por BSUID.
¿Cuál es la variable exacta dentro de Botmaker que traerá el BSUID en conversaciones de WhatsApp?
La variable es ${bsuid}. Ya está disponible en la plataforma. Dentro de las acciones de código, el mismo dato está disponible en context.userData.bsuid.
¿Existe una variable que contenga el número de teléfono cuando el usuario lo comparte?
Sí. La variable ${whatsappNumber} se completa con el número únicamente cuando el usuario lo comparte explícitamente. Si nunca lo compartió, permanecerá vacía. En las acciones de código está en context.userData.whatsappNumber.
¿Existe un endpoint de API para descargar contactos con su BSUID?
Sí. Botmaker incorporó el endpoint /contacts, que permite descargar todos los contactos junto con su BSUID y, cuando aplique, su número de teléfono. Ya está disponible.
¿El BSUID reemplazará el valor actual de platformContactId, customerId u otra variable?
Sí, eventualmente. El platformContactId puede empezar a contener un BSUID en lugar de un número a partir del rollout; no asumas formato numérico en la lógica del bot. La variable bsuid**siemprecontieneelBSUID,y**{whatsappNumber} siempre el número (cuando está disponible).
¿CHAT_CHANNEL_ID seguirá representando únicamente el canal/chat?
No cambia. El CHAT_CHANNEL_ID representa la línea del cliente (el business), no la del usuario. No se ve afectado por la introducción del BSUID.
En conversaciones iniciadas por el usuario, ¿debemos asumir que en algunos casos ya no recibiremos el número telefónico?
Correcto. A partir del rollout progresivo, cada vez que un usuario active su username, el número de teléfono dejará de estar disponible y solo se expondrá el BSUID. No hay una fecha global única: depende de la adopción individual y de la oleada de cada país.
¿Habrá cambios requeridos en acciones como trigger intent, change bot, master bot o autenticaciones por enlaces externos?
No se requieren cambios en esas acciones. Lo único a tener en cuenta es que el platformContactId puede dejar de ser un número de teléfono; cualquier validación que asuma formato numérico debería ajustarse.
Para registrar tu username paso a paso, te compartimos el artículo “Cómo registrar tu username de WhatsApp en Botmaker”.
Recuerda visitar nuestro Centro de Ayuda para mayor información