Nombres de usuario de WhatsApp: Nuevo campo Business Scoped User ID (BSUID) requerido a partir de julio de 2026

A partir de este mes, WhatsApp comenzó a implementar nombres de usuario, una función opcional que permite a los usuarios ocultar sus números telefónicos al enviar mensajes o llamar a empresas. Cuando un usuario adopta un nombre de usuario, su número telefónico puede dejar de aparecer en los webhooks. En su lugar, se proporcionará un ID de Usuario con Alcance de Negocio (BSUID) en los campos "para" y "de", así como en el nuevo campo ExternalUserId.

¿Qué cambia con los nombres de usuario de WhatsApp?

Yampi mapeará el BSUID a un nuevo campo de la API de Mensajería. Este campo se incluye en todos los webhooks de mensajes, independientemente de si el usuario ha adoptado un nombre de usuario o no. Cuando es relevante, también completará los parámetros existentes "para" y "de" con el BSUID:

Si existe un número telefónico, "para" o "de" contiene solo el número telefónico, y ExternalUserId contiene el BSUID.

Si no existe un número telefónico, Yampi completa "para", "de" y ExternalUserId con el BSUID.

El BSUID tiene una longitud de hasta 128 caracteres alfanuméricos (excluyendo el código de país de dos letras), es único por par cartera de negocios-usuario, en el formato whatsapp:CC.BSUID. Los campos "para", "de" y ExternalUserId tienen el prefijo "whatsapp:", independientemente de si el valor es un número telefónico o un BSUID. La longitud del campo ExternalUserId, incluido el prefijo "whatsapp:", es máximo de 140 caracteres. Así es como se ve:

Si un usuario envía un mensaje/llamada a una empresa en WhatsApp:

to: whatsapp:+1800555XXXX

from: whatsapp:BR.1A2B3C4D5E6F7G8H9I0J1K2L3M4N5O6P7Q8R9S0T

ExternalUserId: whatsapp:BR.1A2B3C4D5E6F7G8H9I0J1K2L3M4N5O6P7Q8R9S0T

Si una empresa envía un mensaje/llamada a un usuario en WhatsApp:

to: whatsapp:BR.1A2B3C4D5E6F7G8H9I0J1K2L3M4N5O6P7Q8R9S0T

from: whatsapp:+1800555XXXX

ExternalUserId: whatsapp:BR.1A2B3C4D5E6F7G8H9I0J1K2L3M4N5O6P7Q8R9S0T

Para más información y ejemplos, consulta la documentación de nombres de usuario de WhatsApp.

Meta también está lanzando una función de libreta de contactos a principios de abril de 2026 que almacena automáticamente pares de números telefónicos de usuario y BSUID de interacciones anteriores. Una vez que un usuario está en la libreta de contactos de una empresa, su número telefónico continuará apareciendo en los webhooks independientemente de si ha adoptado un nombre de usuario. Los números telefónicos también se seguirán compartiendo si la empresa está guardada en los contactos de WhatsApp del usuario, o si el usuario no ha adoptado un nombre de usuario.

Cómo prepararse para los nombres de usuario de WhatsApp

Los flujos de mensajería principal deberían seguir funcionando si los sistemas leen y reutilizan los valores de "to" y "from" sin asumir que siempre son números telefónicos. Dependiendo de su configuración, los clientes también pueden querer:

Actualizar los sistemas de registro para prepararse a capturar y almacenar el ExternalUserId (BSUID) de los webhooks junto a los números telefónicos en los perfiles de cliente

Actualizar cualquier lógica de mensajería/llamadas que asuma que "to" o "from" siempre es un número telefónico en formato E.164 para también gestionar BSUIDs

Mapear BSUIDs a perfiles de cliente existentes para una identificación consistente de usuarios

Nota: Las plantillas de autenticación de un toque, cero toques y código de copia aún requieren números telefónicos y no pueden usar BSUIDs.