Cómo guardar el BSUID de WhatsApp en tu CRM

Modelado del campo, matcheo dual con el teléfono y backfill de la base histórica, paso a paso.

Preguntas relacionadas

¿Cómo hago el backfill de los contactos que ya tengo?

Recorre las conversaciones de los últimos 30 días de la Cloud API: Meta mantiene visible el par teléfono ↔ BSUID durante esa ventana. Con ese cruce puedes poblar el campo en la mayoría de los contactos activos sin pedirle nada al usuario. Para el resto, el enriquecimiento ocurre solo cuando la persona vuelve a escribir.

¿Qué reportes hay que revisar después de migrar?

Todos los tableros que agrupan por teléfono: contactos únicos, conversaciones por cliente, tasa de recompra y atribución de campañas. Si siguen agrupando por número, van a duplicar a cada persona que oculte su teléfono. Cambia la clave de agregación a BSUID y valida los totales contra el mes anterior.

Modelado

Cómo definir el campo en los CRM más usados

CRM	Tipo de campo	Detalle
HubSpot	Propiedad de contacto, texto de una línea	Marcarla como única para evitar duplicados en importaciones
Salesforce	Custom field Text(131), External ID	Permite upsert por BSUID desde la integración
Zoho CRM	Single Line (255)	Activar 'no permitir duplicados' en el campo
Pipedrive	Campo personalizado de texto	Agregarlo a la vista de detalle para soporte
Base propia (SQL)	VARCHAR(131) con índice único compuesto	Índice único por (waba_id, bsuid)

Error más comúnReutilizar el campo teléfono o un campo numérico. El BSUID es alfanumérico con prefijo de país (CC.…) y cualquier validación numérica lo rechaza o lo trunca.

Lógica

Matcheo dual: el orden importa

Buscar por BSUID. Es el único identificador presente en el 100% de los webhooks.
Si no hay resultado, buscar por teléfono (cuando el usuario no lo oculta).
Al encontrar el contacto, escribir el BSUID para que la próxima interacción matchee directo.
Si no existe, crear el contacto con BSUID como clave y el teléfono como atributo opcional.

De dónde sale cada valor lo explica cómo obtener el BSUID en el webhook, y por qué el orden importa está en BSUID vs número de teléfono.

Cómo lo resuelve un Meta Business Partner

Con Cliengo, el matcheo dual y el almacenamiento del BSUID vienen resueltos: los Agentes IA identifican al contacto por BSUID, mantienen el historial completo aunque la persona oculte su número y sincronizan ese identificador hacia tu CRM sin desarrollo adicional.

Si todavía estás eligiendo cómo conectar los canales, empieza por la guía de integración de WhatsApp con tu CRM y por los requisitos de WhatsApp Business API, el único entorno donde el campo user_id está disponible.

Preguntas Frecuentes

En una propiedad propia de tipo texto (por ejemplo whatsapp_bsuid), de una sola línea, con hasta 131 caracteres y marcada como única. Nunca en el campo de teléfono ni en un campo numérico.

Sí, dentro de WhatsApp y para tu empresa. Conviene usarlo como clave secundaria de matcheo junto al email o al ID de cliente, porque un mismo contacto puede llegar por otros canales sin BSUID.

Se resuelve con matcheo dual: al llegar un mensaje buscas por BSUID, si no existe buscas por teléfono y, al encontrarlo, escribes el BSUID en ese contacto. En pocas semanas la base queda enriquecida sin migración masiva.

Puedes moverlo entre tus propios sistemas, pero no sirve fuera de tu empresa: es business-scoped, así que otra empresa recibirá un BSUID distinto para la misma persona.

Sí. El campo user_id llega en los webhooks de la Cloud API. En la WhatsApp Business APP no tienes acceso programático a ese identificador.

Páginas relacionadas

🆔

Qué es el BSUID

Definición, formato y por qué existe.

Ver detalles de Qué es el BSUID →🧩

Cómo obtener el BSUID

Dónde leerlo en el webhook de la Cloud API.

Ver detalles de Cómo obtener el BSUID →⚖️

BSUID vs número de teléfono

Qué identificador usar como clave principal.

Ver detalles de BSUID vs número de teléfono →🔗

CRM y WhatsApp

Cómo integrar WhatsApp con tu CRM sin perder datos.

Ver detalles de CRM y WhatsApp →

Profundiza este tema con tu asistente favorito

Abre una conversación pre-cargada con el contexto de esta página. La IA analiza el contenido y responde tus dudas específicas.

ChatGPT abre con el prompt pre-cargado. Gemini no soporta pre-carga por URL: copiamos el prompt al portapapeles y solo tienes que pegarlo (Ctrl/Cmd + V).