Validación de números de WhatsApp y consulta de perfiles APIs
API de validación de WhatsApp: comprueba si un número está en WhatsApp y obtén la foto de perfil, el estado About, la presencia y los datos de negocio. Verificación en tiempo real en dos pasos y consulta de perfiles públicos. API JSON para validación de leads, enriquecimiento de contactos, CRM y entregabilidad de mensajes. Solo datos públicos.
Comprobación de existencia (por número completo)
Comprobación de existencia ligera para un solo número: solo devuelve si el número está registrado en WhatsApp, sin obtener perfil/avatar/datos de negocio. Más económica que una consulta de perfil completa. Cuando isExist=true, la respuesta también incluye un userHash que debe pasarse a los endpoints de perfil (Get Avatar / Get About / Get Business Profile / Get Presence) para autorizar la consulta más pesada. El backend separa automáticamente el código de país del número completo y devuelve countryCode para que puedas verificar la separación.
Comprobación de existencia (código de país + número por separado)
Igual que la comprobación de existencia, pero el código de país y el número nacional se proporcionan como parámetros separados. Úsalo cuando ya conoces el código de país y quieres omitir la separación automática del backend. Cuando isExist=true, la respuesta también incluye un userHash para pasar a los endpoints de perfil.
Obtener avatar (foto de perfil)
Obtén la foto de perfil pública (DP) de un usuario de WhatsApp. Flujo de dos pasos: primero llama a un endpoint de comprobación de existencia para obtener un userHash del número objetivo y luego pásalo aquí. Las llamadas sin un userHash válido (o caducado/desconocido) se rechazan. El número se resuelve a partir del userHash en el servidor; no se acepta ningún parámetro de número. Si el usuario no tiene foto o la oculta por privacidad, hasAvatar=false. Usa type para elegir la imagen a tamaño completo o la miniatura de vista previa pequeña.
Obtener texto About / estado
Obtén el texto About (firma de estado) del usuario y la hora en que se estableció. Flujo de dos pasos: primero obtén un userHash mediante un endpoint de comprobación de existencia y luego pásalo aquí. Un userHash no válido/caducado se rechaza. Si no está configurado / por privacidad (solo contactos) / no registrado, devuelve about=null.
Obtener perfil de negocio
Obtén el perfil de WhatsApp Business: nombre del negocio, nivel de verificación, descripción, dirección, correo, sitio web e información de antigüedad. Flujo de dos pasos: primero obtén un userHash mediante un endpoint de comprobación de existencia y luego pásalo aquí. Un userHash no válido/caducado se rechaza. Los números personales (no de negocio) devuelven isBusiness=false.
Obtener presencia / última conexión
Obtén el estado en línea / última conexión. Fuertemente restringido por la privacidad del objetivo: si quien solicita no es un contacto y la privacidad de última conexión/en línea del objetivo no está configurada para todos, la presencia no se entrega y visible=false (un resultado real que no se puede eludir). Flujo de dos pasos: primero obtén un userHash mediante un endpoint de comprobación de existencia y luego pásalo aquí. Una sola llamada puede tardar hasta unos 17 s.
Comprobar estado activo
Comprueba en tiempo real si un número de teléfono está registrado y activo en WhatsApp. Devuelve un indicador activo directo para el número internacional completo: una comprobación independiente que no requiere un userHash. Ideal para una validación rápida de sí/no en flujos de registro y limpieza de listas.
Comprobación por lotes (hasta 10)
Comprueba si hasta 10 números de teléfono están registrados en WhatsApp en una sola solicitud. Devuelve el estado exist e isBusiness para cada número. Proporciona los números como una lista separada por comas. Eficiente para validar lotes pequeños en una sola llamada.