Nombres de usuario de WhatsApp y BSUID: qué cambia para OTP, CRM y webhooks

Un ID de usuario con alcance empresarial (BSUID) es el identificador que Meta incluye ahora en cada webhook de WhatsApp para que una empresa pueda enviar mensajes a un usuario sin conocer su número de teléfono. Existe porque WhatsApp está introduciendo los nombres de usuario: una vez que un usuario activa uno, una empresa que no haya estado en contacto recientemente puede que ya no reciba el número. Esta guía del equipo de ingeniería de BroadNet explica el formato, el cronograma, qué requiere todavía un número de teléfono y cómo migrar los webhooks, los registros de CRM y los flujos de OTP.

Conclusiones clave

• Los BSUID han aparecido en los webhooks de WhatsApp desde principios de abril de 2026, para cada usuario, independientemente de si utiliza un nombre de usuario o no.
• Un BSUID se parece a US.13491208655302741918: un código de país alfa-2 de ISO 3166, un punto y luego hasta 128 caracteres alfanuméricos.
• Es único para cada par de portafolio empresarial y usuario, y se regenera si el usuario cambia su número de teléfono.
• Desde julio de 2026 se pueden enviar mensajes a un BSUID, excepto las plantillas de autenticación de un toque, de cero toques y de copiar código, que todavía necesitan el número de teléfono.
• Meta dice que los socios y las empresas integradas directamente deben admitir los BSUID para evitar perder la capacidad de procesar mensajes de usuarios con nombre de usuario.
• Conserve el número de teléfono E.164 verificado como el ancla de identidad para OTP, el respaldo de SMS y las verificaciones de fraude. Trate el BSUID como una clave de canal WhatsApp.

¿Qué es un ID de usuario con alcance empresarial?

Meta define un BSUID como "un identificador de usuario único que puede usarse para enviar mensajes a un usuario WhatsApp cuando no se conoce su número de teléfono" (Meta, IDs de usuario con alcance empresarial). El formato es el país del usuario como un código alfa-2 de ISO 3166, un punto y hasta 128 caracteres alfanuméricos, por ejemplo US.13491208655302741918.

Tres propiedades son importantes para el diseño del sistema:

• Alcance. Un BSUID es único para un portafolio empresarial y un usuario. La misma persona tiene un BSUID diferente para cada portafolio empresarial con el que habla, por lo que no puede usarlo para emparejar clientes a través de portafolios no relacionados.
• Estabilidad. Se regenera cuando el usuario cambia su número de teléfono. Meta envía un webhook de mensaje de sistema con tipo user_changed_user_id, y un webhook user_id_update independiente, cuando eso sucede.
• BSUID principales (parent). Las empresas gestionadas con varios portafolios empresariales pueden solicitar a su punto de contacto de Meta que se inscriba en los BSUID principales (parent), los cuales contienen ENT (por ejemplo US.ENT.11815799212886844830) y funcionan en todos los portafolios inscritos.

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

Por privacidad. Meta anunció el 29 de junio de 2026 que las personas pueden reservar un nombre de usuario para usarlo "más adelante este año", y que cuando un usuario haya habilitado uno, la persona o empresa a la que envíe un mensaje por primera vez ya no verá su número de teléfono (Acerca de Meta). La documentación para desarrolladores de Meta dice que los nombres de usuario se implementarán gradualmente en 2026.

Las empresas también pueden tener nombres de usuario. A partir del 29 de junio de 2026, una empresa puede reclamar un nombre de usuario que WhatsApp haya reservado para ella a través de WhatsApp Manager, Meta Business Suite o el Username API, y los nombres de usuario aprobados se activarán cuando se lance la función. Un nombre de usuario de empresa no oculta el número de teléfono de la empresa.

¿Cuál es el cronograma?

¿Perderá el número de teléfono del cliente?

A veces. El BSUID aparece en todos los webhooks de mensajes. El número de teléfono (wa_id, y from en mensajes entrantes) se incluye solo cuando al menos uno de estos es verdadero, según Meta:

• usted envió un mensaje o llamó al número de teléfono del usuario dentro de los 30 días antes de que se activara el webhook;
• recibió un mensaje o una llamada del número de teléfono del usuario dentro de esos 30 días; o
• el usuario está en su libreta de contactos.

El periodo de revisión de 30 días se evalúa por número de teléfono empresarial, por lo que un cliente conocido por su línea de ventas puede ser desconocido para su línea de soporte. La libreta de contactos es una función alojada por Meta que almacena números de teléfono y BSUID tras una primera interacción, por lo que los webhooks posteriores pueden seguir transportando el número incluso después de que el usuario adopte un nombre de usuario. Está activada de forma predeterminada y puede desactivarse en Meta Business Suite dentro de la configuración de la empresa, Información de la empresa. Déjela activada a menos que tenga un motivo para no hacerlo.

¿Qué requiere todavía un número de teléfono?

Meta es explícito: los BSUID "pueden utilizarse para enviar cualquier tipo de mensaje, excepto las plantillas de autenticación de un solo toque, de cero toques y de copia de código, que requieren los números de teléfono de los usuarios". Fuera de WhatsApp, cualquier cosa que se ejecute en la red móvil también necesita el número.

¿Cómo se ve el webhook antes y después?

Antes de BSUID, el bloque de contactos en un webhook de mensajes incluía el número de teléfono en wa_id, y la mayoría de las integraciones lo utilizaban como la clave del cliente. El ejemplo de Meta del nuevo objeto de contactos añade el nombre de usuario, el BSUID y, cuando está habilitado, el BSUID principal (parent); wa_id está presente solo cuando el número puede compartirse:

1"contacts": [
2  {
3    "profile": {
4      "name": "<USER_DISPLAY_NAME>",
5      "username": "<USERNAME>"
6    },
7    "wa_id": "<USER_PHONE_NUMBER>",
8    "user_id": "<BSUID>",
9    "parent_user_id": "<PARENT_BSUID>"
10  }
11]

Los mensajes entrantes también incluyen from_user_id (y from_parent_user_id si está habilitado), y los webhooks de estado incluyen recipient_user_id, lo cual Meta afirma que siempre se establece como el BSUID del usuario. Para enviar, coloque el BSUID en el nuevo parámetro recipient. Puede usar el parámetro to (número de teléfono), el parámetro recipient (BSUID) o ambos; cuando ambos están presentes, el número de teléfono tiene precedencia:

1{
2  "messaging_product": "whatsapp",
3  "recipient_type": "individual",
4  "recipient": "<BSUID>",
5  "type": "text",
6  "text": {
7    "body": "<BODY_TEXT>"
8  }
9}

La respuesta de envío incluye entonces user_id en su matriz de contactos, y wa_id pasa a ser opcional. Si su analizador asume que wa_id siempre está presente, fallará con el primer usuario con nombre de usuario. Puede pegar cargas útiles reales en nuestro inspector de carga útil de webhook para verificar qué campos recibe realmente su integración.

¿Qué se rompe para OTP?

Las plantillas de autenticación con botones de un toque, de cero toques o de copiar código no pueden enviarse a un BSUID. Si un usuario con nombre de usuario se comunica con usted a través de WhatsApp y usted no tiene su número de teléfono, no puede enviarle una WhatsApp OTP de esos tipos. Eso tiene dos consecuencias para los flujos de verificación:

• Recopile y verifique el número de teléfono durante el registro, en formato E.164, y almacénelo como la dirección de verificación de la cuenta. No dependa del webhook WhatsApp para que se lo entregue más tarde. Vea qué es E.164.
• Mantenga un canal que funcione en el número mismo. La SMS OTP, la OTP de voz y las comprobaciones de red silenciosas se ejecutan todas en el número de teléfono, razón por la cual un diseño multicanal con respaldo automático sobrevive a este cambio sin cambios. Nuestra guía de OTP multicanal y el producto BroadNet OTP cubren el patrón.

¿Qué se rompe para el CRM y la deduplicación de clientes?

La mayoría de los CRM identifican un contacto WhatsApp mediante el número de teléfono porque SMS, la voz y WhatsApp solían compartirlo. Después de los nombres de usuario, un nuevo contacto entrante puede llegar solo con un BSUID. Si crea un nuevo registro en el CRM para ello, duplicará gradualmente a los clientes. Cuatro reglas mantienen los datos limpios:

1. 1Modele el BSUID como una identidad de canal, no como el ID del cliente. Un cliente puede poseer varios BSUID (uno por cada portafolio empresarial) y uno nuevo tras un cambio de número.
2. 2Mantenga una tabla de mapeo de BSUID, portafolio, número de teléfono cuando se conozca, primera vez visto y última vez visto, y actualícela en cada webhook, incluyendo user_id_update.
3. 3Realice la fusión basándose en evidencia, no en conjeturas: un número de teléfono verificado, un inicio de sesión o una referencia de pedido que el cliente proporcione en el chat.
4. 4Nunca trate la ausencia de wa_id como un nuevo cliente. Solo significa que el número no puede compartirse en ese evento.

¿Cómo migrar? Una lista de verificación paso a paso

1. 1Actualice los analizadores de webhook para leer user_id, from_user_id, recipient_user_id y el nombre de usuario, y para tratar wa_id y from como opcionales.
2. 2Agregue una columna BSUID (y el BSUID principal si es una empresa gestionada) dondequiera que almacene contactos WhatsApp.
3. 3Carga de datos históricos: para cada evento entrante desde principios de abril de 2026, vincule el BSUID al número de teléfono que ya posee.
4. 4Gestione el mensaje de servicio user_changed_user_id y el webhook user_id_update volviendo a vincular el nuevo BSUID con el cliente.
5. 5Agregue el parámetro recipient a su ruta de envío, y utilícelo como alternativa cuando no tenga un número de teléfono.
6. 6Enrute OTP al número de teléfono, nunca a un BSUID, y mantenga SMS o voz como el canal de respaldo.
7. 7Reserve su nombre de usuario empresarial en WhatsApp Manager, Meta Business Suite o a través de Username API.
8. 8Pruebe con una cuenta que tenga habilitado el nombre de usuario antes de que los nombres de usuario lleguen a sus clientes.

Si BroadNet es su proveedor de WhatsApp, solicite acceso de prueba y confirme cómo aparecen los campos BSUID en los webhooks de su cuenta antes de cambiar el código de producción. Nuestro centro para desarrolladores y la página de WhatsApp Business API contienen los detalles, y el enrutamiento omnicanal gestiona la alternativa SMS de la que ahora dependen los flujos de autenticación.

Preguntas frecuentes

¿Qué es un WhatsApp BSUID?

Un ID de usuario con alcance empresarial: un identificador que Meta asigna a cada usuario WhatsApp para cada portafolio empresarial, de modo que la empresa pueda enviar mensajes al usuario sin conocer su número de teléfono. Aparece como user_id en los webhooks.

¿Cómo es un BSUID?

Un código de país alfa-2 ISO 3166, un punto y luego hasta 128 caracteres alfanuméricos, por ejemplo US.13491208655302741918. Los BSUID principales para empresas gestionadas incluyen ENT, por ejemplo US.ENT.11815799212886844830.

¿Perderé el número de teléfono del cliente cuando adopte un nombre de usuario?

Solo en algunos webhooks. El número sigue incluyéndose si intercambió un mensaje o una llamada con ese número en los últimos 30 días, o si el usuario está en su libreta de contactos. De lo contrario, se omite wa_id y solo recibe el BSUID.

¿Puedo enviar mensajes a un BSUID?

Sí, desde julio de 2026, utilizando el parámetro recipient del envío de API. Todos los tipos de mensajes funcionan excepto las plantillas de autenticación de un toque, de cero toques y de copiar código, que requieren el número de teléfono del usuario.

¿Puedo enviar plantillas de autenticación (OTP) a un BSUID?

No. Las plantillas de autenticación de un solo toque, de cero toques y de copiar código requieren el número de teléfono. Mantenga un número de teléfono verificado para cada cuenta y utilice SMS o la OTP de voz como alternativa.

¿Los BSUID funcionan en todos los portafolios empresariales?

No. Un BSUID es único para un par de portafolio empresarial y usuario. Las empresas gestionadas pueden preguntar a Meta sobre los BSUID principales (parent), que funcionan en los portafolios inscritos conjuntamente.

¿Alguna vez cambia un BSUID?

Sí. Se regenera cuando el usuario cambia su número de teléfono, y Meta lo señala con un mensaje de sistema user_changed_user_id y un webhook user_id_update.

¿Cómo reservo mi nombre de usuario empresarial?

Desde el 29 de junio de 2026, a través de WhatsApp Manager, Meta Business Suite o el Username API. Un nombre de usuario aprobado se activa cuando se lanza la función de nombre de usuario, y no oculta su número de teléfono empresarial.

Fuentes

• Meta para desarrolladores, IDs de usuario con alcance empresarial (formato, cronograma, campos de webhook, libreta de contactos, parámetro de envío, excepción de plantilla de autenticación), consultado el 26 de septiembre de 2026.
• Acerca de Meta, Es hora de reservar su nombre de usuario WhatsApp, 29 de junio de 2026, consultado el 26 de septiembre de 2026.