Qué hay que saber sobre los nombres de usuario y los BSUID de WhatsApp
¿Qué son los nombres de usuario de WhatsApp?
Un nombre de usuario de WhatsApp es un identificador único y opcional que puede configurar cualquiera de las siguientes entidades para que aparezca en lugar del número de teléfono en la aplicación: un usuario de WhatsApp (que haya iniciado sesión en la aplicación de WhatsApp para particulares) o una empresa (que haya iniciado sesión en la aplicación de WhatsApp Business o en la plataforma API de WhatsApp Business). Los nombres de usuario funcionan de forma similar a los nombres de usuario de Facebook Messenger o Instagram.
Hay dos actores y casos de uso distintos:
| Actor | Por qué eligen un nombre de usuario | Repercusión en la visibilidad del número de teléfono |
|---|---|---|
| Usuario de WhatsApp (conectado a la aplicación de WhatsApp para consumidores) | Privacidad: para evitar compartir su número de teléfono con empresas u otros usuarios | El número de teléfono no se muestra a las empresas en los webhooks (a menos que se cumplan determinadas condiciones) |
| Empresas (que hayan iniciado sesión en la aplicación WhatsApp Business o en la plataforma API de WhatsApp Business) | Imagen de marca: para que a los usuarios les resulte más fácil encontrarlos y reconocerlos | El número de teléfono no está oculto; el nombre de usuario es solo un identificador adicional. |
Los nombres de usuario son un complemento de los números de teléfono, no un sustituto. Todas las cuentas de WhatsApp siguen requiriendo un número de teléfono.
¿Qué es un BSUID?
Un identificador de usuario de ámbito empresarial (BSUID) es un identificador único que Meta asigna a cada usuario de WhatsApp y que está vinculado específicamente a una cartera empresarial concreta. Es la principal forma de identificar a un usuario y enviarle mensajes cuando su número de teléfono no está disponible.
Propiedades clave de un BSUID:
- Formato: prefijo del código de país ISO 3166 alfa-2, seguido de un punto y hasta 128 caracteres alfanuméricos; por ejemplo, US.13491208655302741918
- Ámbito de aplicación: Único para cada par de cartera empresarial y usuario. Un BSUID de una cartera no puede utilizarse con un número de teléfono que pertenezca a otra cartera.
- Disponibilidad: Siempre está presente para los usuarios de WhatsApp (consumidores). No siempre está disponible para las empresas, a menos que se haya adoptado. Además, independientemente del nombre de usuario o del BSUID, los números de teléfono de las empresas siempre están disponibles.
- Regeneración: Se vuelve a generar un BSUID si el usuario cambia su número de teléfono.
- Limitaciones: Los BSUID no se pueden utilizar para enviar plantillas de autenticación de un toque, sin toque o con código de copia. Esos tipos de mensajes requieren un número de teléfono.
¿Qué es un BSUID de padre o madre?
Un BSUID principal es una variante especial del BSUID disponible para las empresas gestionadas que cuentan con varias carteras empresariales de Meta vinculadas. Permite utilizar un único identificador en todas las carteras inscritas.
- Formato:
{COUNTRY_CODE}.ENT.{ALPHANUMERIC_ID}— por ejemplo,US.ENT.11815799212886844830 - Disponibilidad: Solo para empresas registradas en un Account BSUID principal de Meta. Ponte en contacto con tu persona de contacto en Meta o Vonage para comprobar si cumples los requisitos.
- Ámbito de aplicación: Funciona en todas las carteras registradas. Los BSUID normales siguen funcionando junto con los BSUID principales.
¿Cuándo recibirás un BSUID en lugar de un número de teléfono?
La tabla siguiente resume qué identificadores son visibles para Vonage en función del tipo de usuario:
| Tipo de usuario | ¿Se ve el número de teléfono? | ¿Se ve el BSUID? | ¿Se ve el nombre de usuario? |
|---|---|---|---|
| Usuario sin nombre de usuario | Sí | Sí (siempre) | No |
| Usuario con el nombre de usuario «adopted» | De forma condicional (véase más abajo) | Sí (siempre) | Sí |
| Empresa sin nombre de usuario | Sí | No | No |
| Empresa con nombre de usuario adoptado | Sí | No | Sí (solo para la imagen de marca) |
¿En qué casos se sigue incluyendo el número de teléfono de los usuarios que eligen un nombre de usuario?
Meta incluye el número de teléfono del usuario en los webhooks si se cumple alguna de las siguientes condiciones (evaluadas por cada número de teléfono empresarial):
- Has enviado un mensaje o has llamado al número de teléfono de ese usuario en los últimos 30 días
- Has recibido un mensaje o una llamada desde el número de teléfono de ese usuario en los últimos 30 días
- El usuario figura en tu agenda de contactos
Si no se cumple ninguna de estas condiciones, el wa_id El campo se omitirá de la carga útil del webhook. El from Este campo contendrá el BSUID en lugar del número de teléfono.
La agenda de contactos
Meta ofrece una función de agenda de contactos (disponible a partir de principios de abril de 2026) que almacena automáticamente el número de teléfono y el BSUID de un usuario cada vez que se envía o se recibe un mensaje o una llamada a su número de teléfono o desde él. Una vez almacenado, el número de teléfono seguirá apareciendo en los datos de los webhooks, independientemente de si el usuario ha adoptado un nombre de usuario.
La agenda de contactos tiene un alcance limitado al nivel de la cartera de negocios y está alojada en Meta. No es necesario realizar ningún trabajo de integración para activarla, ya que Meta la tiene activada por defecto. Puedes desactivarla en cualquier momento en Meta Business Suite > Configuración de la empresa > Información de la empresa.
Nuevo código de error
Se devuelve un nuevo código de error cuando se intenta enviar un tipo de mensaje que no admite BSUID como destinatarios:
| Código de error | Detalle |
|---|---|
| 131062 | Los destinatarios con identificador de usuario de ámbito empresarial (BSUID) no son compatibles con este mensaje. |