Qué es el BSUID de WhatsApp y Por Qué Tu Empresa Necesita Entenderlo
El Business-Scoped User ID es el nuevo identificador único que WhatsApp asigna a cada combinación de usuario + empresa.
BSUID en una oración
Es un identificador único que WhatsApp asigna a cada combinación de usuario + empresa. Pensalo como un 'DNI digital' que tu cliente te muestra — pero que es diferente para cada empresa con la que habla.
Formato técnico
El BSUID tiene un formato específico que lo diferencia de un número de teléfono.
CC.ALFANUMERICODonde CC es el código de país de dos letras y lo que sigue son hasta 128 caracteres alfanuméricos. Ejemplo:
AR.7f3a9b2c1d4e5f6a8b9c0d1e2f3a4b5c6d7e8f9aEsto es radicalmente diferente al formato E.164 de un número de teléfono (+5491123456789). Si tu sistema parsea el campo from asumiendo que siempre empieza con +, va a fallar.
Dónde aparece
El BSUID aparece en un nuevo campo user_id en todos los webhooks de la Cloud API. La clave: aparece siempre, incluso si el usuario no adoptó un username y su número sigue visible. Meta quiere que los sistemas empiecen a almacenar el BSUID desde ahora.
Tabla de escenarios
| Situación del usuario | Campo from | Campo user_id |
|---|---|---|
| Sin username | Número de teléfono | BSUID |
| Con username, número visible | Número de teléfono | BSUID |
| Con username, número oculto | BSUID | BSUID |
Por qué es "scoped" por negocio
El mismo usuario tiene un BSUID diferente con cada empresa. Si tu cliente habla con tu negocio y después con tu competencia, cada uno ve un ID distinto. Esto hace imposible rastrear usuarios entre empresas. Meta lo diseñó así a propósito como medida de protección de datos.
El BSUID no cambia si el usuario cambia su username
Si un cliente que te habla como @maria_lopez después cambia su handle a @mlopez_ok, el BSUID sigue siendo el mismo. No pierdes el historial de conversación ni el perfil del contacto. El BSUID solo cambiaría si el usuario cambia de número de teléfono.
Período de transición de 30 días
WhatsApp tiene una red de seguridad: durante los primeros 30 días después de cualquier interacción, el número de teléfono sigue apareciendo en los webhooks incluso si el usuario adoptó un username. Además, el Contact Book de Meta (que se lanza en abril 2026) almacena automáticamente los pares teléfono-BSUID de interacciones previas.
Qué tienes que hacer
Lo mínimo indispensable:
- Agregar un campo BSUID a tu base de datos de contactos, al lado del teléfono y el email
- Parsear el webhook correctamente: detectar si
fromtrae un número E.164 o un BSUID (formatoCC.alfanum) - Matchear dual: primero por BSUID, después por teléfono. Escribir el BSUID en el perfil cuando matcheás por teléfono
- Nunca descartar el BSUID — almacenarlo siempre, incluso cuando el número está presente
