Redes Sociales - BSUID (v10.3)

Redes Sociales - BSUID (v10.3)

Los cambios descritos en este documento estarán disponibles en la versión 10.3 del servicio, cuyo lanzamiento está previsto para septiembre de 2026.

Hasta entonces, la plataforma no mostrará cambios. Le notificaremos cuando la actualización esté disponible para su instancia.

¿De qué trata esta actualización?

WhatsApp introdujo un identificador llamado Business-Scoped User ID (BSUID): un código único asignado por Meta a cada usuario dentro de cada cuenta de negocio de WhatsApp.

Este identificador es más estable y preciso que el número de teléfono para reconocer a un mismo contacto.

¿Por qué importa?

Hasta ahora, la plataforma identificaba a los contactos de WhatsApp principalmente por su número de teléfono.
Con esta actualización, si el contacto tiene un BSUID asignado por Meta, la plataforma lo usará como identificador principal.
Esto reduce errores de matching y mejora la trazabilidad del contacto a lo largo del tiempo.

 ¿Qué NO cambia?

La gran mayoría del funcionamiento de la plataforma permanece exactamente igual.
Los puntos más importantes:

Los contactos existentes y su historial de conversaciones no se modifican ni se eliminan.
Todo sigue visible tal como estaba.

Las conversaciones en curso no se interrumpen.
Los operadores pueden continuar atendiendo sin ningún cambio en su flujo de trabajo habitual.

Todos los reportes e integraciones que ya funcionaban seguirán funcionando.
La actualización es compatible hacia atrás (no rompe lo existente).

Los menús, pantallas y opciones de la plataforma no cambian de lugar.
La experiencia visual es prácticamente la misma.

 ¿Qué cambia visualmente en la plataforma?

Los cambios visuales son menores y solo aparecen cuando un contacto de WhatsApp tiene datos BSUID asociados (contactos nuevos o enriquecidos luego de la actualización).

En el listado de conversaciones

Para los contactos con BSUID, junto al nombre del contacto puede aparecer información adicional de identificación (username de WhatsApp y/o un código BSUID parcial).
Los contactos anteriores a la actualización no muestran este dato adicional.

En el encabezado del ticket / conversación

El nombre completo del contacto puede incluir ahora su handle de WhatsApp y un identificador BSUID abreviado, por ejemplo:

Antes:

Juan Pérez (+5491155550000)

Ahora (con BSUID):

Juan Pérez (@juan_wa · BSUID AR12345...)

Contactos legacy:

Juan Pérez (+5491155550000)  — sin cambio

En el historial de mensajes

La etiqueta del remitente en las burbujas de mensajes entrantes puede incluir el username y/o el BSUID abreviado del contacto, cuando ese dato esté disponible.
Para contactos anteriores a la actualización, la etiqueta no cambia.

En el encabezado de la conversación

El panel de información del contacto puede mostrar tres campos nuevos cuando están disponibles:

BSUID

Identificador único asignado por Meta (código alfanumérico)

Username

Handle de WhatsApp del contacto, ej. @juan_wa

Teléfono

Número de teléfono en formato explícito

Estos campos aparecerán vacíos o ausentes para contactos creados antes de la actualización, hasta que interactúen nuevamente con la plataforma a través de WhatsApp.

 

¿Qué deben hacer los operadores / usuarios de la plataforma?

En la mayoría de los casos: NADA.

La actualización no cambia el flujo de atención. Este apartado es solo para orientar ante cualquier duda puntual.

Si ven información adicional junto al nombre del contacto

Es normal. La plataforma está mostrando el username o el BSUID de ese contacto. No es un error. Pueden ignorar ese dato adicional si no lo necesitan, o usarlo para identificar al contacto con más precisión.

Si un contacto nuevo parece "duplicado"

Con la actualización, si un mismo usuario de WhatsApp contacta desde una cuenta con BSUID diferente, la plataforma puede crear un nuevo registro de contacto en lugar de unirlo al anterior. Esto es por diseño (Meta asigna BSUIDs distintos por scope de cuenta de negocio).

¿Qué hacer? → Contactar al equipo de soporte si se detecta un caso concreto. No intenten fusionar registros manualmente.

Si una respuesta automática parece incompleta

Si un administrador configuró plantillas de respuesta usando los nuevos tokens $CONTACTUSERNAME o $CONTACTBSUID, y el contacto es anterior a la actualización (no tiene esos datos), esos tokens se mostrarán como texto vacío en el mensaje. Es esperable y no es un error del sistema.

Acciones sobre plantillas de respuesta automática

Si desea aprovechar los nuevos datos del contacto en los mensajes automáticos, puede usar los siguientes tokens en sus plantillas:

$CONTACTUSERNAME → El username de WhatsApp del contacto (ej. @juan_wa). Vacío si el contacto no tiene username.

$CONTACTBSUID ->El BSUID completo del contacto asignado por Meta. Vacío si el contacto es legacy.

Antes de activar estos tokens en plantillas de producción, verificar con el equipo de operaciones que los mensajes con campos vacíos (contactos legacy) tengan un resultado aceptable para el cliente final.

Preguntas frecuentes

¿Qué es el BSUID exactamente?

Es el Business-Scoped User ID: un identificador único asignado por Meta (empresa propietaria de WhatsApp) a cada usuario dentro del scope de cada cuenta de negocio (WABA). A diferencia del teléfono, no cambia aunque el usuario cambie su número, y es único por combinación usuario + cuenta de negocio.

¿Mis contactos anteriores pierden su historial?

No. Los contactos existentes y su historial completo permanecen intactos. Los campos nuevos (Bsuid, Username, Phone) simplemente aparecerán vacíos para esos contactos hasta que vuelvan a interactuar.

¿Tengo que migrar o exportar mis datos manualmente?

No. La migración es automática y transparente. No requiere ninguna acción de exportación, importación ni carga manual de datos por parte del cliente.

¿Por qué puede aparecer un contacto "duplicado"?

Meta puede asignar un BSUID diferente si el mismo usuario interactúa desde una cuenta de negocio distinta. En ese caso, la plataforma crea un nuevo registro de contacto por diseño. Si identifica un caso concreto que considera incorrecto, contacte a soporte.

¿Mis reportes de terceros (BI, CRM externo) se ven afectados?

Potencialmente sí, si consumen directamente tablas o SPs de la base de datos de la plataforma. Solicitar información sobre cambios a su Focal Técnico.

¿A quién contacto si tengo dudas o detecto un problema?

Contacte al equipo de soporte de la plataforma a través del canal habitual. Para reportar un comportamiento inesperado, incluya: nombre del cliente, número o nombre del contacto afectado, nombre del SP o reporte involucrado (si aplica), y una descripción del comportamiento observado vs. el esperado.