BSUID: Nuevo identificador de destinatarios de WhatsApp y próximos cambios en 1MSG
Anteriormente, WhatsApp identificaba a los usuarios por su número de teléfono. Ahora, Meta está pasando gradualmente al identificador BSUID, un ID único del usuario de WhatsApp que funciona incluso cuando el número de teléfono está oculto.
A lo largo de 2026, los usuarios podrán ocultar su número de teléfono indicando un username en su perfil. Después de eso, el envío por phone puede dejar de funcionar si antes no guardó la vinculación BSUID ↔ phone. BSUID se convierte en el nuevo método de identificación, y las integraciones que dependen solo de phone dejarán de funcionar con el tiempo.
Enviamos el BSUID a través de los webhooks, y la introducción del nombre de usuario comenzará en junio de 2026 en determinados países, tras lo cual su implementación se llevará a cabo gradualmente hasta finales de año.
Compatibilidad con versiones anteriores
Nos hemos asegurado de que sus integraciones actuales sigan funcionando sin cambios.
A partir de mayo de 2026, 1MSG guarda internamente la vinculación de su cliente:
BSUID ↔ phoneEsto nos permite realizar el enrutamiento interno. En concreto, podrá:
enviar un mensaje saliente como de costumbre por número de teléfono, incluso si su cliente ha ocultado su número, ya que ya hemos guardado el BSUID y enrutaremos automáticamente a BSUID;
enviar un mensaje saliente de cualquier forma: ya sea por número de teléfono o por BSUID, según le convenga;
mantener la compatibilidad con integraciones antiguas.
Podrá enviar mensajes salientes usando tanto el número de teléfono como BSUID:
a través de
phone— acepta tanto {{phone}} como {{bsuid}};a través de
chatID— acepta tanto {{phone@c.us}}, {{bsuid@lid}} como {{username}}@username;a través de
bsuid— acepta tanto {{bsuid}}
Nuevos campos en los webhooks
Guardamos la vinculación BSUID ↔ phone de nuestro lado, pero usted también puede recibirla y guardarla en su integración. Recordemos que BSUID es único dentro de su portfolio empresarial específico.
Mensajes entrantes
Ya están disponibles campos adicionales en todos los webhooks entrantes:
authorBsuid
BSUID del remitente del mensaje entrante (RU.1504711984690866)
authorUserName
Username del usuario de WhatsApp
Webhooks de envío, entrega y lectura
En los webhooks ack de:
envío de mensajes;
entrega;
lectura;
ahora también se transmiten:
bsuid
BSUID del cliente
phone
Número de teléfono del cliente (si está disponible)
username
Username del cliente (si está disponible)
Cambio en la lógica de ChatID
Dado que Meta está pasando gradualmente a un nuevo modelo en el que el usuario puede:
ocultar su número de teléfono usando username;
interactuar con la empresa a través del identificador interno BSUID;
el número de teléfono deja de ser el identificador principal
El campo chatId admitirá guardar dos formatos.
Lógica actual
Para clientes existentes, ChatID seguirá guardándose en el formato anterior:
Por ejemplo:
Nuevos usuarios sin teléfono
Si un cliente escribe por primera vez tras la implementación del nuevo modelo de Meta (y no existe vinculación BSUID ↔ phone) y el número de teléfono del cliente está oculto, ChatID se guardará en el formato:
Por ejemplo:
Si más adelante el usuario revela su número de teléfono o lo comparte manualmente,
ChatID seguirá siendo:
Esto se hace deliberadamente para no cambiar el identificador de la conversación.
Por qué ChatID no vuelve al teléfono
BSUID es un identificador permanente del usuario dentro de la nueva arquitectura de WhatsApp.
Incluso si el número de teléfono estuviera disponible más adelante, cambiar ChatID podría:
provocar la aparición de dos chats distintos;
romper las vinculaciones entre mensajes;
causar problemas en CRM e integraciones.
Por eso, después de crear un chat a través de BSUID, su identificador permanece sin cambios.
Transición futura a BSUID
Dado que Meta avanza gradualmente hacia BSUID como identificador principal, en el futuro todos los chats usarán el formato:
Los plazos exactos de la transición completa aún no se han anunciado.
Importante
Para garantizar el correcto funcionamiento de la compatibilidad entre phone ↔ BSUID, es muy importante no desactivar la función de almacenamiento y sincronización de contactos en WhatsApp Business.
Si se desactiva la recopilación de contactos en Meta Business Manager:
WhatsApp dejará de guardar la relación entre phone ↔ BSUID;
los nuevos usuarios que oculten su número de teléfono podrían dejar de estar disponibles para el envío de mensajes por número;
parte de las relaciones previamente almacenadas entre phone y BSUID podrían perderse;
esto puede afectar la posibilidad de continuar conversaciones con clientes antiguos después de la transición de Meta al nuevo modelo de identificación.
FAQ
Last updated
