Saltar al contenido principal

Actualización del canal WhatsApp - Usernames, BSUID y nuevos IDs

  • Actualización

Índice:

  1. Introducción
  2. Cronograma
  3. Empresas - Cómo adoptar o reservar un username
  4. Contactos - Identificación de BSUID
    1. Visión general
    2. Dónde encontrar el BSUID - Metadata de los mensajes
    3. Propiedades disponibles
    4. Premisas
    5. Cómo extraer la información del metadata
  5. Identificación interna de contactos en Blip
    1. Visión general
    2. Evolución del campo contact.identity
    3. Acciones necesarias y posibles impactos
    4. Principales recomendaciones

Introducción

Conforme anunciado por Meta recientemente, el modelo de identificación de los contactos en WhatsApp Business está evolucionando. Con el objetivo de la privacidad de los usuarios, Meta está introduciendo Usernames en WhatsApp. Documentación técnica oficial de Meta.

La adopción de usernames es opcional tanto para el usuario final como para las empresas. En caso de que el usuario final adopte un username, sin embargo, su número de teléfono ya no será compartido, siendo exhibido apenas el username y otros IDs técnicos relacionados. Las empresas, sin embargo, aunque hayan adoptado el username, continuarán exhibiendo el número de teléfono registrado en su cuenta de WhatsApp.

Además de la introducción de usernames en WhatsApp, cada username está asociado a un BSUID (Business-Scoped User ID), un identificador único entre el usuario y una empresa específica que permite el envío de mensajes en WhatsApp incluso cuando el número de teléfono del usuario no está disponible. A diferencia del número de teléfono, que es siempre el mismo número independiente de la empresa con la cual aquel contacto interactúa, el BSUID de un mismo usuario será único y diferente para cada una de las empresas con las que el contacto interactúe (basado en el Business Manager/Business Portfolio de la empresa).

 

Cronograma

  • Junio/2026: la funcionalidad de Usernames será liberada por Meta para pruebas en algunos países

  • Julio/2026: rollout para una segunda muestra de países de prueba definidos por Meta

  • Agosto/2026: expectativa de lanzamiento global en GA por Meta

Todos los hitos descritos anteriormente pueden ser alterados previamente con base en las definiciones y directrices de la propia Meta.

 

Empresas - Cómo adoptar o reservar un username 

Al igual que el usuario, la empresa también podrá adoptar el uso de un username o incluso reservar un username para sus cuentas de WhatsApp. Esta adopción, sin embargo, aún no está disponible. Actualizaremos esta documentación tan pronto como sea posible para reflejar este proceso.

 

Contactos - Identificación de BSUID 

Visión general 

Todos los contactos, independientemente de si adoptan un username o no, pasarán a venir con el nuevo identificador creado por Meta para WhatsApp, el BSUID. 

El número de teléfono del contacto/usuario final solo será informado por Meta en las interacciones B2C si:

  • El contacto no ha adoptado un username

  • El número de teléfono del contacto está registrado en la Lista de Contactos del business (funcionalidad lanzada por Meta en abril/2026 y nativamente habilitada para registrar datos de los contactos que interactúan con el business)

Dónde encontrar el BSUID - Metadata de los mensajes 

El BSUID es puesto a disposición por Blip en el metadata de los mensajes (mensajes, notificaciones y ecos, en casos de activaciones de Coexistencia) y estará presente en el objeto metadata de cada envelope (mensajes, notificaciones o eco) siempre que estas informaciones sean enviadas a Blip por Meta/Whatsapp en los webhooks correspondientes. 

Para consultar la información del BSUID vía metadata:

  • Acceda al bot deseado en el Portal

  • Acceda al menú superior de Blip

  • Haga clic en el icono de tres puntos (...)

  • Seleccione la opción Log en el menú

  • Localice el objeto metadata dentro del envelope del mensaje

Propiedades disponibles 

Dentro del metadata, los identificadores estarán disponibles a través de las siguientes propiedades:

  • #wa.bsuid: Identificador único del usuario (BSUID)

  • #wa.parentId: Identificador del usuario compartido entre diferentes empresas (cuando sea aplicable)

Premisas 

  • La propiedad #wa.parentId será incluida solo en los casos en que Meta autorice esta feature para la empresa. Importante: el pedido de activación del Parent ID debe ser realizado por la empresa a Meta a través de un ticket. 

  • Todos estos campos dependen de la disponibilidad por parte de Meta/Facebook; por lo tanto, su presencia está condicionada a los datos recibidos por el canal en Blip. 

  • Estas informaciones permiten rastrear e interactuar con usuarios de forma consistente, incluso sin acceso directo al número de teléfono.

Cómo extraer la información del metadata 

Para extraer estas informaciones, usted debe definir dos acciones de salida en el bloque Inicio del Studio:

1. Definir variable de metadata 

Defina una variable con los siguientes parámetros:

  • Nombre de la variable: metadata

  • Valor: {{input.message@metadata}}

2. Ejecutar script 

Ejecute un script para obtener solo el valor del #wa.bsuid presente en este metadata. Configuración del script:

function run(metadata){
metadata= JSON.parse(metadata);
return metadata["#wa.bsuid"];
}

Se presentará el alcance del script, conforme a la imagen de abajo:

  • ¡CONSEJO! Utilice el registro de eventos para enriquecer la captura de datos y hacerlos más presentables a partir de informes personalizados.

Identificación interna de contactos en Blip

Visión general 

Con el fin de minimizar el impacto para nuestros clientes, Blip crea una abstracción que analiza los datos recibidos de Meta y realiza el relacionamiento con un contacto existente o crea un nuevo contacto cuando es necesario. 

Con la evolución del modelo de identificación de WhatsApp, Blip también está evolucionando la forma en que los contactos son identificados en la plataforma.

Evolución del campo contact.identity 

Actualmente, el campo contact.identity (disponible en la biblioteca de variables de Blip) se completa con el número de teléfono del usuario en este formato:

  • {phone_number}@wa.gw.msging.net

A partir de la evolución prevista para el día 1 de junio de 2026, considerando que el número de teléfono puede no estar ya disponible, se crearán nuevos contactos con un ID propio de Blip en el formato:

  • {guid}@wa.gw.msging.net

El campo contact.identity, por lo tanto, deja de representar obligatoriamente un número de teléfono y pasa a ser un ID interno de Blip. Los contactos ya existentes en Blip antes del día 1 de junio no se verán afectados.

Acciones necesarias y posibles impactos 

Es importante revisar su operación en Blip para garantizar que esta no dependa de un formato específico del campo contact.identity existente en Blip. Sugerimos el mapeo principalmente en:

  • APIs, webhooks, bases de datos y sistemas externos integrados a Blip (CRM, ERP, etc.)

  • Flujos conversacionales en el propio Blip

  • Reglas de negocio que utilizan el contact.identity (ejemplo: logs, auditorías o informes que asumen formato numérico)

Principales recomendaciones

  • Trate el contact.identity como un identificador genérico (string), sin asumir que es un número de teléfono

  • Elimine validaciones rígidas de formato (ej: regex de teléfono)

  • No lo utilice como clave primaria basada en número de teléfono

 

¿Necesita más ayuda? Explore nuestros contenidos en Blip Academy o Blip Community, vea tutoriales en nuestro canal de YouTube o aclare sus dudas en nuestro canal de atención 😃

Artículos relacionados