La implementación de la función Usernames de Meta — los nuevos @ — introdujo una nueva forma de identificar a los usuarios dentro del ecosistema de WhatsApp Business. Como parte de esta evolución, Meta ahora proporciona el Business Scoped User ID (BSUID), un identificador único asociado al usuario dentro del ámbito de la cuenta comercial (Business Account).
Para obtener más información sobre qué son los Usernames y qué cambia en tu operación, consulta nuestra documentación.
Este cambio también afecta los recorridos dentro de Zenvia Customer Cloud. Consulta los detalles a continuación.
Recorrido afectado — Contactos
1. Campo BSUID de solo lectura
Para acceder a este campo, ve a Contactos > Base de contactos > Editar contacto.
Al editar un contacto, el sistema ahora muestra una nueva sección llamada Identificadores de WhatsApp, que contiene el campo BSUID (Business Scoped User ID).
Visualización del campo
El campo BSUID se muestra en modo de solo lectura, permitiendo únicamente consultar el identificador asignado por Meta.
Como el BSUID es un identificador generado y administrado exclusivamente por Meta, no se permite su edición manual.
El valor del BSUID se obtiene exclusivamente de Meta a través del Conector de WhatsApp.
Este identificador no puede ser creado, importado ni modificado por el usuario mediante la interfaz de Zenvia Customer Cloud ni mediante operaciones manuales de actualización de contactos.
Siempre que el sistema reciba un evento de Meta que contenga el BSUID, el Gestor de Contactos se actualizará automáticamente para registrar este identificador en el contacto correspondiente.
2. Personalización de columnas y filtros
Para acceder a esta función, ve a Contactos > Base de contactos > Personalizar filtros y columnas.
Como parte de la implementación de Usernames de Meta, la lista de la Base de Contactos ahora ofrece dos nuevas columnas que pueden agregarse a la tabla:
- BSUID (Business Scoped User ID)
- Username
Estas columnas pueden añadirse a la vista de la tabla y utilizarse como criterios de filtrado, permitiendo localizar contactos mediante los identificadores del ecosistema de WhatsApp de Meta.
Flujo 1 — Agregar columnas
Al hacer clic en Personalizar filtros y columnas, el sistema abre la ventana de configuración de la tabla y muestra la lista de columnas disponibles.
Ejemplo:
- ☑ Contacto (Nombre, Teléfono, Correo electrónico) (preseleccionado)
- ☑ Origen (preseleccionado)
- ☐ BSUID
- ☐ Username
- ☐ Fecha de la última compra
- ☐ Clasificación RFV
- ☐ Sentimiento de contactos
- ☐ Empresa
El usuario puede seleccionar BSUID y Username, y al hacer clic en Aplicar, la tabla de la Base de Contactos mostrará estas nuevas columnas.
Flujo 2 — Visualizar columnas
Después de aplicar la configuración, la lista de contactos mostrará los nuevos campos en la tabla.
Reglas de visualización
- Cuando el contacto tenga un BSUID sincronizado, el identificador se mostrará normalmente.
- Cuando el contacto aún no tenga un BSUID recibido de Meta, la columna mostrará un estado de ausencia de información (por ejemplo: - o Esperando sincronización).
- El mismo comportamiento se aplica al campo Username.
Flujo 3 — Filtrar por BSUID
Al hacer clic en el encabezado de la columna BSUID, el sistema ofrece la opción Filtrar.
El usuario puede ingresar un valor específico de BSUID para filtrar los resultados de la tabla.
La tabla mostrará únicamente los contactos que tengan el BSUID informado.
Ejemplo:BSUID: BR.5551999988076.