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 maneja esto automáticamente; para la mayoría de los clientes, nada en tus Campaigns o Canvas necesita cambiar.
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 maneja 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. Algunos clientes pueden necesitar prepararse para el cambio.
ID de usuario con alcance de negocio (BSUID)
Un BSUID es un identificador único y persistente que WhatsApp asigna para representar a un usuario dentro de tu portafolio de negocio específico. Piensa en él como un número de teléfono alternativo para los usuarios que eligen mantener privado su número de teléfono.
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 de negocio. |
| Con alcance de negocio | El mismo usuario tiene un BSUID diferente con cada negocio al que envía mensajes. Los BSUID no se pueden compartir ni comparar entre diferentes portafolios de negocio. |
| 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 usuario 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 (mostrado), BSUID (backend) | BSUID, número de teléfono para usuarios que ya tienen una conversación 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 tenías 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 BSUID cuentan con perfiles de usuario completos en Braze y pueden entrar en Canvas, recibir mensajes, generar eventos y ser actualizados 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 (como un usuario que te envía un mensaje por primera vez tras adoptar un nombre de usuario), Braze envía utilizando el BSUID en su lugar. No es necesario realizar cambios en tus plantillas de mensajes, Campaigns 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 se encuentra un usuario coincidente, crea un nuevo perfil de usuario anónimo con el BSUID almacenado como alias de usuario.
- Desencadena cualquier Canvas o Campaign configurado 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 de la misma manera 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 a través de:
- El endpoint users/track utilizando
user_alias - El paso en Canvas User Update (funciona automáticamente)
- Carga de CSV
El endpoint subscription/status/set no es compatible con user_alias. Usa el endpoint users/track para actualizar el estado de suscripción de los usuarios que solo tienen BSUID.
Currents y datos de eventos
Todos los eventos de Currents de WhatsApp (envío, entrega, lectura, fallo, recepción entrante, cancelación, reintento) incluyen un campo de 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 de BSUID (el campo del número de teléfono está vacío).
Cómo prepararte para el cambio
Para la mayoría de los clientes, no se requiere ninguna acción. Braze gestiona automáticamente el enrutamiento de BSUID, la creación de usuarios y el seguimiento de eventos. Sin embargo, recomendamos habilitar la libreta de contactos de WhatsApp y vincular los portafolios de negocios si usas varias cuentas de WhatsApp Business (WABA).
Habilitar la libreta de contactos de WhatsApp
La libreta de contactos 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 negocio si aparece en tu libreta de contactos. 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 la libreta de contactos:
- Ve a Meta Business Suite > Configuración del negocio > Información del negocio.
- Confirma que la característica de libreta de contactos esté habilitada.
La característica de libreta de contactos está activada de forma predeterminada, pero recomendamos confirmar esto en la configuración de tu negocio en Meta. Si la libreta de contactos está deshabilitada, los usuarios que adopten nombres de usuario aparecerán como nuevos usuarios solo con BSUID, incluso si ya les has enviado mensajes anteriormente.
Vincular portafolios de negocios si usas varias WABA
Los BSUID están delimitados a un solo portafolio de negocios. Si tu organización gestiona WABA de varios portafolios de negocios dentro del mismo espacio de trabajo de Braze, el mismo usuario tiene un BSUID diferente para cada portafolio. Esto puede generar perfiles de usuario duplicados en Braze.
Para evitar esto, contacta a tu punto de contacto en Meta para verificar si tu negocio es elegible para vincular portafolios. Consulta Vincular portafolios de negocios y BSUID principales para más detalles.
Si todas tus WABA están dentro del mismo portafolio de negocios, no se necesita ninguna acción.
Vincular portafolios de negocio y BSUID principales
Si tu organización opera múltiples cuentas de WhatsApp Business (WABA) en diferentes portafolios de negocio, puedes solicitar a tu punto de contacto de Meta que verifique si tu negocio es elegible para vincular esos portafolios. La elegibilidad es determinada por Meta y está disponible para negocios gestionados.
Comportamiento de portafolios vinculados
Cuando tus portafolios de negocio están vinculados, WhatsApp incluye un BSUID principal en todos los webhooks de mensajes junto con el BSUID regular. 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 regulares, pero se comparten entre todos los números de teléfono de negocio dentro de tu conjunto de portafolios vinculados. Esto significa que el mismo usuario tiene un único identificador consistente independientemente de la WABA a la que envíe mensajes, evitando 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 regular no incluye ENT.
Cómo Braze usa los BSUID principales
Cuando un webhook contiene tanto un BSUID regular como un BSUID principal, Braze usa el BSUID principal como el identificador primario. Esto permite que un usuario que envía mensajes a través de múltiples WABA en tus portafolios vinculados se asocie de forma consistente al mismo perfil de usuario en Braze.
Si no hay un BSUID principal presente (por ejemplo, porque tus portafolios no están vinculados o el usuario está enviando mensajes a una WABA no vinculada), Braze usa el BSUID regular. Los BSUID regulares continúan funcionando normalmente en todos los casos.
Meta gestiona el proceso de vinculación de portafolios de negocio. Para comenzar, contacta a tu punto de contacto de Meta. Puedes seguir enviando mensajes a los usuarios usando su BSUID regular incluso si tus portafolios están vinculados; los BSUID principales son aditivos, no un reemplazo.
| Escenario | Identificador usado por Braze |
|---|---|
| Portafolio de negocio único | BSUID regular |
| Múltiples portafolios vinculados | BSUID principal (preferido). Si no existe un BSUID principal, se usa el BSUID regular |
| Múltiples portafolios no vinculados | BSUID regular (puede resultar en perfiles de usuario duplicados por portafolio) |
Preguntas frecuentes
¿Mis Campaigns y Canvas existentes dejan de funcionar?
No. Las Campaigns y 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 existente con tu negocio, Braze continúa utilizando su número de teléfono como identificador principal.
¿Qué sucede con un usuario que adopta un nombre de usuario pero ya había enviado mensajes a mi negocio?
Si tu libreta de contactos de WhatsApp está habilitada y tuviste 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 de webhook junto con el BSUID. Braze los 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 una conversación previa con mi negocio?
Braze recibe el BSUID del usuario en el webhook entrante y lo asocia con un perfil de usuario existente (si previamente almacenaste su BSUID) 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 y ser identificado o fusionado con otros perfiles mediante las herramientas estándar de resolución de identidad de Braze.
¿Puedo segmentar usuarios con BSUID en Segments?
Los usuarios con BSUID son perfiles de usuario completos de Braze, por lo que puedes dirigirte a ellos mediante filtros de audiencia estándar (como “ha recibido un mensaje de WhatsApp” o pertenencia a un grupo de suscripción). Sin embargo, no se admite la segmentación específica por valores de BSUID (como “BSUID existe” o “BSUID es igual a X”).
¿Cómo funciona la tarificación de WhatsApp para los usuarios con BSUID?
La tarificación de conversaciones de WhatsApp se determina por el país del usuario. Para los usuarios identificados por número de teléfono, Meta determina 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 comienza con US representa a un usuario en Estados Unidos.
Esto significa que el comportamiento de la tarificación es consistente independientemente de si un usuario está identificado por número de teléfono o BSUID. El país utilizado para calcular las tasas de conversación lo determina el identificador que proporciona Meta, y Braze lo transmite sin modificaciones. No necesitas hacer nada de manera diferente, pero ten en cuenta que al enviar mensajes a usuarios que solo tienen BSUID, la tarificación basada en el país de Meta se basa en el país codificado en el BSUID del usuario en lugar de 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 establecido en 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, carga de CSV y el paso de actualización de usuario en Canvas.
¿Mis pipelines de datos de Currents dejan de funcionar?
Los eventos de Currents para WhatsApp incluyen un campo bsuid junto con el campo de número de teléfono existente. Para los usuarios que solo tienen BSUID, el campo de número de teléfono está vacío. Si tus pipelines posteriores tienen requisitos estrictos en el campo de número de teléfono, confirma que pueden manejar un valor nulo o vacío.
Tengo múltiples WABAs en diferentes portafolios de negocio. ¿El mismo usuario aparece como dos perfiles diferentes en Braze?
Sin portafolios vinculados, sí. El mismo usuario de WhatsApp tiene un BSUID diferente por portafolio de negocio, y Braze crea perfiles separados para cada uno.
Para resolver esto, contacta a tu punto de contacto en Meta para verificar la elegibilidad para la vinculación de portafolios. Cuando están vinculados, Meta proporciona un BSUID padre compartido entre todos los portafolios, y Braze lo usa para identificar de manera consistente al usuario en todos tus WABAs. Consulta Vincular portafolios de negocio y BSUIDs padre para más detalles.
¿Puedo desactivar la libreta de contactos?
Recomendamos encarecidamente mantener la libreta de contactos habilitada. Si se desactiva la libreta de contactos, todos los registros históricos de números de teléfono de tus usuarios se pierden. Los usuarios que adopten nombres de usuario aparecerán entonces como nuevos usuarios con solo BSUID, incluso si les habías enviado mensajes previamente.