Logo oficial CliengoIcono WhatsApp BusinessGuía WhatsApp Business 2026

    Errores comunes con el BSUID de WhatsApp

    Webhooks sin user_id, contactos duplicados, validaciones rotas y reportes inflados: qué los causa y cómo se arreglan.

    Preguntas relacionadas

    ¿Cómo detecto si mi base ya está duplicada?

    Busca contactos creados en los últimos 30 días sin número de teléfono o con nombre repetido y conversaciones cortas. Si el volumen de contactos nuevos creció sin que crezcan las conversaciones únicas, la duplicación por falta de BSUID es la causa más probable. El cruce se resuelve con el par teléfono ↔ BSUID que la Cloud API mantiene visible durante esa ventana.
    Diagnóstico

    Síntoma, causa y solución

    SíntomaCausa probableSolución
    El webhook no trae user_idVersión antigua de la Graph API o campo no suscritoActualizar versión y suscribir el campo de mensajes
    Contactos duplicadosMatcheo solo por teléfonoMatcheo dual: BSUID → teléfono → alta nueva
    Falla la validación al guardarCampo numérico o de longitud cortaCampo de texto de 131 caracteres
    El SMS de respaldo no saleBSUID escrito en el campo teléfonoSeparar en dos columnas distintas
    Reportes con clientes infladosAgregación por número de teléfonoAgrupar por BSUID
    No puedo iniciar conversaciónIntento de contacto en frío con BSUIDSolo se responde dentro de conversaciones existentes
    El BSUID cambióSe comparó entre dos empresas distintasEl BSUID es único por empresa, no es global
    PrioridadSi tienes que arreglar una sola cosa, arregla el matcheo. La duplicación de contactos es el único error que degrada la base de forma acumulativa y difícil de revertir.

    El modelado correcto del campo está en cómo guardar el BSUID en tu CRM, y la lectura del payload en cómo obtener el BSUID en el webhook. Para decidir qué identificador es la clave principal, revisa BSUID vs número de teléfono.

    Cómo lo resuelve un Meta Business Partner

    En Cliengo, el almacenamiento del BSUID, el matcheo dual y la deduplicación están resueltos en la plataforma: los Agentes IA reconocen al contacto aunque oculte su número y mantienen un único historial por persona.

    Los contactos duplicados también distorsionan tus costos y reportes: una misma persona aparece como dos clientes y sus mensajes se reparten entre registros separados. Mira cómo cambia el cobro con el cambio de precios de WhatsApp de octubre 2026 y qué implica conectar tu CRM con WhatsApp.

    Preguntas Frecuentes

    Suele deberse a una versión antigua de la Graph API o a que la suscripción del webhook no incluye el campo de mensajes. Actualiza la versión de la API y revisa los campos suscritos en tu app de Meta.

    Porque la integración sigue matcheando solo por teléfono. Cuando el usuario oculta su número, cada conversación crea un contacto nuevo. La solución es el matcheo dual: BSUID primero, teléfono después.

    Casi siempre porque el campo está tipado como numérico o con menos de 131 caracteres. El BSUID es alfanumérico con prefijo de país y necesita un campo de texto amplio.

    Sí, dentro de conversaciones ya existentes con esa persona. Lo que no puedes hacer es iniciar contacto en frío con un BSUID que nunca te escribió.

    Es estable para tu empresa aunque el usuario cambie de nombre de usuario. Lo que cambia es entre empresas: cada negocio recibe un BSUID distinto para la misma persona.
    Explorar más con IA

    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).

    ¿Te sirvió esta guía? Compártela

    Ayuda a otro equipo de LATAM a vender más por WhatsApp.

    CliengoesMeta Business Partner