Nombres de usuario de WhatsApp e ID de usuario con alcance de negocio
Los nombres de usuario de WhatsApp son una característica de privacidad opcional que oculta los números de teléfono de los usuarios cuando envían mensajes a empresas. Braze gestiona esto automáticamente; para la mayoría de los clientes, no es necesario cambiar nada en tus Campaigns o Canvas.
Meta está implementando los nombres de usuario de WhatsApp y los BSUID por fases. Braze admite por completo la mensajería con BSUID, por lo que es posible que con el tiempo veas más usuarios que solo tienen BSUID. Para conocer las últimas novedades de Meta, consulta ID de usuario con alcance de negocio.
Cuando los usuarios de WhatsApp adoptan un nombre de usuario, su número de teléfono ya no se comparte automáticamente con las empresas a las que envían mensajes. En su lugar, WhatsApp proporciona a las empresas un ID de usuario con alcance de negocio (BSUID), un identificador único que es específico para cada par de portafolio de negocio y usuario.
Braze gestiona los BSUID automáticamente. Los usuarios que adoptan un nombre de usuario siguen apareciendo en tu espacio de trabajo de Braze, reciben mensajes, desencadenan Canvas y generan eventos. Es posible que algunos clientes necesiten prepararse para el cambio.
ID de usuario con ámbito empresarial (BSUID)
Un BSUID es un identificador único y persistente que WhatsApp asigna para representar a un usuario dentro de tu portafolio empresarial específico. Piensa en él como un número de teléfono alternativo para los usuarios que eligen mantener su número de teléfono en privado.
Los BSUID tienen tres características clave:
| Característica | Descripción |
|---|---|
| Único | No hay dos usuarios que compartan el mismo BSUID dentro de tu portafolio empresarial. |
| Con ámbito empresarial | El mismo usuario tiene un BSUID diferente con cada empresa a la que envía mensajes. Los BSUID no se pueden compartir ni comparar entre distintos portafolios empresariales. |
| Disponible en webhooks | Los BSUID se incluyen en todas las mismas cargas útiles de webhook que contienen el número de teléfono del usuario. |
Cambios en los tipos de usuarios de WhatsApp
Hay dos tipos de usuarios de WhatsApp:
| Tipo de usuario | Identificación en WhatsApp | Lo que recibe Braze |
|---|---|---|
| Usuarios sin nombre de usuario | Número de teléfono (sin cambios) | Número de teléfono (sin cambios) |
| Usuarios con nombre de usuario | Nombre de usuario (visible), BSUID (backend) | BSUID, número de teléfono para los usuarios que tienen una conversación existente con tu empresa |
La diferencia clave es que un usuario que adopta un nombre de usuario solo comparte su número de teléfono con tu empresa si ya tuviste una conversación previa con él o si aparece en tu libreta de contactos de WhatsApp.
Cómo gestiona Braze los BSUID
Braze almacena los BSUID como un alias de usuario con la etiqueta whats_app_bsuid en el perfil de usuario. Esto significa que los usuarios que solo tienen un BSUID tienen perfiles de usuario completos en Braze y pueden entrar en Canvas, recibir mensajes, generar eventos y actualizarse a través de la API.
Enviar mensajes
Cuando Braze envía un mensaje de WhatsApp, utiliza el número de teléfono si hay uno disponible. Si el usuario solo tiene un BSUID (por ejemplo, un usuario que te escribe por primera vez después de adoptar un nombre de usuario), Braze envía el mensaje utilizando el BSUID. No es necesario hacer ningún cambio en tus plantillas de mensajes, campañas ni pasos en Canvas.
Mensajes entrantes y desencadenantes de Canvas
Cuando un usuario con nombre de usuario te envía un mensaje entrante de WhatsApp, Braze:
- Busca al usuario por BSUID o número de teléfono (el que esté disponible en el webhook).
- Si no encuentra ningún usuario coincidente, crea un nuevo perfil de usuario anónimo con el BSUID almacenado como alias de usuario.
- Desencadena cualquier Canvas o campaña configurados para iniciarse con un mensaje entrante de WhatsApp.
Perfil de usuario
Puedes ver el BSUID de un usuario en su perfil de usuario de Braze, en la sección de WhatsApp.
Grupos de suscripción
La gestión de grupos de suscripción funciona igual para los usuarios con BSUID que para cualquier usuario identificado mediante un alias de usuario. Puedes actualizar el estado de suscripción de los usuarios con BSUID mediante:
- El endpoint users/track utilizando
user_alias - El paso en Canvas Actualización de usuario (funciona automáticamente)
- Carga de CSV
El endpoint subscription/status/set no admite user_alias. Utiliza el endpoint users/track para actualizar el estado de suscripción de los usuarios que solo tienen un BSUID.
Currents y datos de eventos
Todos los eventos de Currents de WhatsApp (envío, entrega, lectura, fallo, entrante recibido, cancelación, reintento) incluyen un campo BSUID. Para los usuarios que tienen tanto un número de teléfono como un BSUID, se incluyen ambos campos. Para los usuarios que solo tienen un BSUID, solo se incluye el campo BSUID (el campo del número de teléfono queda vacío).
Cómo prepararte para el cambio
Para la mayoría de los clientes, no es necesario hacer nada. Braze gestiona automáticamente el enrutamiento de BSUID, la creación de usuarios y el seguimiento de eventos. Sin embargo, te recomendamos habilitar el Contact Book de WhatsApp y vincular las carteras comerciales si utilizas varias cuentas de WhatsApp Business (WABA).
Habilita el Contact Book de WhatsApp
El Contact Book es una característica de Meta que registra los números de teléfono de los usuarios con los que ya has conversado. Cuando un usuario adopta un nombre de usuario, su número de teléfono sigue siendo visible para tu empresa si aparece en tu Contact Book. Esto significa que Braze puede seguir identificando a los usuarios por su número de teléfono incluso después de que habiliten un nombre de usuario.
Para habilitar el Contact Book:
- Ve a Meta Business Suite > Configuración del negocio > Información del negocio.
- Confirma que la característica Contact Book está habilitada.
La característica Contact Book está activada de forma predeterminada, pero te recomendamos confirmarlo en la configuración de tu negocio en Meta. Si el Contact Book está deshabilitado, los usuarios que adopten nombres de usuario aparecerán como nuevos usuarios solo con BSUID, aunque ya les hayas enviado mensajes anteriormente.
Vincula las carteras comerciales si utilizas varias WABA
Los BSUID están limitados a una única cartera comercial. Si tu organización gestiona WABA de varias carteras comerciales dentro del mismo espacio de trabajo de Braze, el mismo usuario tendrá un BSUID diferente para cada cartera. Esto puede generar perfiles de usuario duplicados en Braze.
Para evitarlo, ponte en contacto con tu persona de contacto en Meta para comprobar si tu empresa es elegible para vincular carteras. Consulta Vincular carteras comerciales y BSUID principales para obtener más detalles.
Si todas tus WABA están dentro de la misma cartera comercial, no es necesario hacer nada.
Vincular carteras comerciales y BSUID principales
Si tu organización opera varias cuentas de WhatsApp Business (WABA) en diferentes carteras comerciales, puedes pedir a tu punto de contacto de Meta que compruebe si tu empresa es elegible para vincular esas carteras. Meta determina la elegibilidad, y esta opción está disponible para empresas gestionadas.
Comportamiento de las carteras vinculadas
Cuando tus carteras comerciales están vinculadas, WhatsApp incluye un BSUID principal en todos los webhooks de mensajes junto con el BSUID normal. El BSUID principal se asigna a una nueva propiedad parent_user_id en la carga útil del webhook.
Los BSUID principales tienen las mismas propiedades que los BSUID normales, pero se comparten entre todos los números de teléfono comerciales de tu conjunto de carteras vinculadas. Esto significa que el mismo usuario tiene un único identificador coherente, independientemente de la WABA a la que envíe mensajes, lo que evita el riesgo de perfiles de usuario duplicados.
Un BSUID principal incluye ENT entre el código de país y el identificador alfanumérico. Por ejemplo:
US.ENT.11815799212886844830
Un BSUID normal no incluye ENT.
Cómo usa Braze los BSUID principales
Cuando un webhook contiene tanto un BSUID normal como un BSUID principal, Braze usa el BSUID principal como identificador primario. Esto permite que un usuario que envía mensajes a varias WABA de tus carteras vinculadas se asocie de forma coherente con el mismo perfil de usuario de Braze.
Si no hay un BSUID principal (por ejemplo, porque tus carteras no están vinculadas o el usuario envía mensajes a una WABA no vinculada), Braze usa el BSUID normal. Los BSUID normales siguen funcionando con normalidad en todos los casos.
Meta gestiona el proceso de vincular carteras comerciales. Para empezar, ponte en contacto con tu punto de contacto de Meta. Puedes seguir enviando mensajes a los usuarios con su BSUID normal aunque tus carteras estén vinculadas; los BSUID principales son complementarios, no un reemplazo.
| Escenario | Identificador que usa Braze |
|---|---|
| Una sola cartera comercial | BSUID normal |
| Varias carteras vinculadas | BSUID principal (preferido). Si no existe un BSUID principal, usa el BSUID normal |
| Varias carteras no vinculadas | BSUID normal (puede generar perfiles de usuario duplicados por cartera) |
Preguntas frecuentes
¿Dejarán de funcionar mis Campaigns y Canvas existentes?
No. Las Campaigns y los Canvas existentes siguen funcionando. Los usuarios que no adopten un nombre de usuario no se ven afectados en absoluto. Para los usuarios que sí adopten un nombre de usuario y tengan un historial de conversación previo con tu empresa, Braze sigue usando su número de teléfono como identificador principal.
¿Qué ocurre con un usuario que adopta un nombre de usuario pero ya ha enviado mensajes a mi empresa?
Si tienes habilitado el Contact Book de WhatsApp y mantuviste una conversación previa con el usuario (o le enviaste un mensaje) en los últimos 30 días, su número de teléfono sigue apareciendo en las cargas útiles del webhook junto con el BSUID. Braze lo asocia con su perfil de usuario existente. No se crea ningún perfil duplicado.
¿Qué pasa si un usuario adopta un nombre de usuario y no tiene ninguna conversación previa con mi empresa?
Braze recibe el BSUID del usuario en el webhook entrante y lo asocia con un perfil de usuario existente (si guardaste su BSUID anteriormente) o crea un nuevo perfil de usuario anónimo con el BSUID almacenado como alias de usuario. Ese usuario puede entonces entrar en Canvas, recibir mensajes salientes e identificarse o fusionarse con otros perfiles mediante las herramientas estándar de resolución de identidad de Braze.
¿Puedo dirigirme a usuarios con BSUID en Segments?
Los usuarios con BSUID son perfiles de usuario completos de Braze, así que puedes dirigirte a ellos mediante filtros de audiencia estándar (como “ha recibido un mensaje de WhatsApp” o la pertenencia a un grupo de suscripción). Sin embargo, no se admite la segmentación específica por valores de BSUID (como “el BSUID existe” o “el BSUID es igual a X”).
¿Cómo funcionan los precios de WhatsApp para los usuarios con BSUID?
Los precios de las conversaciones de WhatsApp se determinan según el país del usuario. Para los usuarios identificados por número de teléfono, Meta obtiene el país a partir del código de país del número de teléfono. Para los usuarios identificados por BSUID, el país está codificado directamente en el propio BSUID; por ejemplo, un BSUID que empieza por US representa a un usuario de Estados Unidos.
Esto significa que el comportamiento de los precios es coherente tanto si un usuario se identifica por número de teléfono como por BSUID. El país que se usa para calcular las tasas de conversación se determina a partir del identificador que proporciona Meta, y Braze lo transmite sin modificaciones. No tienes que hacer nada distinto, pero ten en cuenta que, al enviar mensajes a usuarios que solo tienen BSUID, los precios por país de Meta se basan en el país codificado en el BSUID del usuario y no en un número de teléfono.
¿Cómo hago referencia a un usuario con BSUID en las llamadas a la API?
Usa el parámetro user_alias con alias_label: "whats_app_bsuid" y alias_name configurado con el valor del BSUID del usuario. Por ejemplo:
{
"user_alias": {
"alias_label": "whats_app_bsuid",
"alias_name": "DDC91135R"
}
}
Esto funciona con users/track, users/identify, la carga de CSV y el paso en Canvas Actualización de usuario.
¿Dejarán de funcionar mis canalizaciones de datos de Currents?
Los eventos de Currents para WhatsApp incluyen un campo bsuid junto al campo de número de teléfono existente. Para los usuarios que solo tienen un BSUID, el campo de número de teléfono está vacío. Si tus canalizaciones posteriores tienen requisitos estrictos sobre el campo de número de teléfono, confirma que pueden gestionar un valor nulo o vacío.
Tengo varias WABA en distintas carteras comerciales. ¿El mismo usuario aparece como dos perfiles diferentes en Braze?
Sin carteras vinculadas, sí. El mismo usuario de WhatsApp tiene un BSUID diferente por cada cartera comercial, y Braze crea perfiles separados para cada una.
Para solucionarlo, ponte en contacto con tu persona de contacto en Meta para comprobar si cumples los requisitos para vincular carteras. Una vez vinculadas, Meta proporciona un BSUID principal compartido entre todas las carteras, y Braze lo usa para identificar al usuario de forma coherente en todas tus WABA. Consulta Vincular carteras comerciales y BSUID principales para obtener más información.
¿Puedo deshabilitar el Contact Book?
Te recomendamos encarecidamente mantener habilitado el Contact Book. Si deshabilitas el Contact Book, se pierden todos los registros históricos de números de teléfono de tus usuarios. Los usuarios que adopten nombres de usuario aparecerán entonces como nuevos usuarios con solo BSUID, aunque les hayas enviado mensajes anteriormente.
Recursos adicionales
Para conocer las últimas actualizaciones del canal de WhatsApp, consulta las notas de la versión.