Cómo obtener el BSUID de WhatsApp

"contacts": [
  {
    "profile": { "name": "María" },
    "wa_id": "AR.7f3a9b2c1d4e5f6a8b9c0d1e2f3a4b5c",
    "user_id": "AR.7f3a9b2c1d4e5f6a8b9c0d1e2f3a4b5c"
  }
]

Cuando el usuario mantiene su número visible, wa_id trae el teléfono y user_id el BSUID. Cuando lo oculta, ambos traen el BSUID. Ver el detalle de escenarios en qué es el BSUID.

1. Suscribe tu app al webhook de mensajes. En la configuración de la app de Meta, suscríbete al campo messages de la WhatsApp Business Account. Sin esa suscripción no recibes el payload que contiene el user_id.
2. Lee el campo user_id del contacto. En el payload, dentro de entry[].changes[].value.contacts[], cada contacto trae wa_id (teléfono o BSUID) y user_id con el BSUID.
3. Detecta el formato del campo from. Si el valor del mensaje empieza con dígitos es un número E.164; si tiene el patrón dos letras + punto + alfanumérico es un BSUID.
4. Guarda el BSUID en tu CRM. Persiste el BSUID en su propia columna, junto al teléfono cuando exista, y usa matcheo dual para no duplicar contactos.
5. Responde usando el BSUID. Para contestar dentro de la ventana de 24 horas o enviar una plantilla, usa el BSUID como destinatario en el campo to del endpoint de mensajes.

const esBsuid = (valor) => /^[A-Z]{2}\.[A-Za-z0-9]{1,128}$/.test(valor);

Una vez que lo detectas, el paso siguiente es persistirlo bien: cómo guardar el BSUID en tu CRM. Si tu integración ya está en producción, contrasta tu implementación con los errores comunes con el BSUID.

Con un Meta Business Partner como Cliengo, la captura y el matcheo dual del BSUID ya vienen implementados: los Agentes IA reconocen al contacto y conservan su historial aunque oculte el número o cambie de nombre de usuario.

Para esto necesitas estar sobre WhatsApp Business API. Antes de conectarla, revisa el precio de WhatsApp Business API en 2026 y los cambios de facturación de octubre 2026.