> For the complete documentation index, see [llms.txt](https://help.1msg.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.1msg.io/docs/es/api-documentation/bsuid-nuevo-identificador-de-destinatarios-de-whatsapp-y-proximos-cambios-en-1msg.md). # 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. {% hint style="info" %} BSUID es un identificador único que WhatsApp asigna a cada usuario dentro de su portfolio empresarial específico. {% endhint %} 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 ↔ phone ``` Esto 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. {% hint style="info" %} Tenga en cuenta: si en la base de datos de 1MSG no existe la vinculación BSUID ↔ phone y el cliente tiene oculto su número de teléfono en WhatsApp, no podrá escribirle primero por número de teléfono — el mensaje no se entregará. Para crear la vinculación BSUID ↔ phone en 1MSG, el cliente debe escribirle primero o recibir un mensaje suyo antes de ocultar su número de teléfono. {% endhint %} 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 {{}}, {{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: | Campo | Descripción | | ---------------- | ---------------------------------------------------------------- | | `authorBsuid` | BSUID del remitente del mensaje entrante (`RU.1504711984690866`) | | `authorUserName` | Username del usuario de WhatsApp | {% embed url="" %} *** #### Webhooks de envío, entrega y lectura En los webhooks ack de: * envío de mensajes; * entrega; * lectura; ahora también se transmiten: | Campo | Descripción | | ---------- | --------------------------------------------------- | | `bsuid` | BSUID del cliente | | `phone` | Número de teléfono del cliente (si está disponible) | | `username` | Username del cliente (si está disponible) | {% embed url="" %} *** ### 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. ``` chatId: 796700000001@c.us o chatId: RU.1504711984690866@lid ``` {% hint style="warning" %} Asegúrese de que su integración procese correctamente el nuevo formato y la longitud del campo chatId: RU.1504711984690866\@lid {% endhint %} #### Lógica actual Para clientes existentes, ChatID seguirá guardándose en el formato anterior: ``` {{phone@c.us}} ``` Por ejemplo: ``` 796700000001@c.us ``` *** #### 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: ``` {{bsuid@lid}} ``` Por ejemplo: ``` RU.1504711984690866@lid ``` Si más adelante el usuario revela su número de teléfono o lo comparte manualmente, ChatID seguirá siendo: ``` {{bsuid@lid}} ``` 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: ``` chatId {{bsuid@lid}} ``` 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
Si mi cliente registra un username, ¿podré escribirle? Sí, si ya tiene su número de teléfono de una conversación anterior, puede seguir enviándole mensajes independientemente de si registró o cambió su username. En el «Libro de contactos», esta vinculación se guarda automáticamente gracias a la correspondencia entre el número de teléfono y BSUID basada en todas las interacciones previas.
¿Qué es BSUID y por qué lo necesita mi sistema? BSUID es un identificador único que WhatsApp asigna a cada usuario dentro de su portfolio empresarial. Cuando un usuario cambia su username y deja de compartir su número de teléfono, su sistema recibe BSUID en su lugar. Sin este identificador, no podrá identificar a esos usuarios ni responderles.
Usamos publicidad con enlace a WhatsApp. ¿Qué significa esto para nosotros? Para comunicarse con usuarios que hayan pasado a usar username, su sistema deberá procesar BSUID en lugar del número de teléfono. Esto será relevante a partir de junio de 2026, cuando comience la transición al uso de usernames.
¿Cuál es el plazo real? La respuesta práctica: hasta que el uso de usernames se generalice en sus mercados. En junio de 2026 comenzará la prueba a nivel de países individuales, tras lo cual la implementación será gradual. El periodo de abril a junio está reservado específicamente para una implementación gradual.
Trabajamos con varios clientes en distintos portfolios. ¿Tendrá el mismo cliente un identificador diferente en cada uno? Sí. Los identificadores BSUID están vinculados al portfolio empresarial, por lo que el mismo cliente aparecerá con distintos identificadores BSUID en cada portfolio.