service_type ws_profile
Compruebe si un número tiene avatar de WhatsApp, obtenga la URL de la imagen y lea los atributos de retrato de ese avatar.
POST /api/v1/checkAnálisis de avatares de WhatsAppNo es necesario iniciar sesión.
Contrato de la API
Envíe un número y seleccione este producto con service_type. La autenticación usa su clave API.
Copie el siguiente comando curl y sustituya únicamente la clave API de ejemplo por la suya.
POST /api/v1/checkcurl -X POST "https://avatarlookup.com/api/v1/check" \
-H "X-API-Key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "service_type": "ws_profile", "identifier": "+17253100591" }'200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "ws_profile",
"identifier": "+17253100591",
"registered": true,
"avatar": true,
"avatar_url": "https://pps.whatsapp.net/v/example.jpg",
"category": "individual portrait",
"age": 39,
"gender": "male",
"skin_color": "white",
"hair_color": "brown"
}
}Cómo usarlo
Un número en formato E.164 (un signo más, el código de país y después el número) para WhatsApp, o un email completo para el producto de email.
registered indica si la cuenta existe (para una dirección de email: si es accesible), avatar indica si hay un avatar configurado y avatar_url contiene la imagen. Los tres se devuelven en cada consulta correcta.
avatar_url apunta a la propia CDN de la plataforma y puede caducar según sus plazos. Trátela como una referencia: descargue o almacene en caché la imagen si necesita conservarla.
Qué verifica
registered · boolean — Si el número está registrado en WhatsApp.avatar · boolean — Si hay un avatar configurado.avatar_url · string — URL del avatar; cadena vacía cuando no hay ninguna foto configurada.category · string — Qué es la imagen: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar o object. unknown cuando no se ha podido obtener un retrato.age · integer — Edad estimada como número entero, con una precisión de unos 3 años y limitada al rango 0-80. Se omite cuando no se ha podido estimar (por ejemplo, cuando no se determinó el género).gender · string — male, female o unknown.skin_color · string — Tono de piel descriptivo, por ejemplo white, east_asian o hispanic. Trátelo como un conjunto abierto; unknown cuando no se ha determinado.hair_color · string — Color de cabello descriptivo, por ejemplo black, brown, blond o gray white. Trátelo como un conjunto abierto; unknown cuando no se ha determinado.Ideal para
Añada el estado del avatar y una URL de imagen a listas de clientes, conversaciones de soporte o agendas. Compruebe si existe un avatar antes de cargarlo o de mostrar una imagen predeterminada.
Escriba la URL del avatar devuelta en los registros de contacto existentes para que ventas, soporte y operaciones vean el mismo perfil de cliente, más completo.
Incorpore el estado de registro, el estado del avatar y los atributos de la imagen a las colas de revisión manual como señal adicional de la completitud del registro.
Cree grupos a partir del registro, la presencia de avatar y los resultados de perfil para organizar listas y planificar el trabajo posterior con los datos.
Respuesta directa
Análisis de avatares de WhatsApp devuelve si el número tiene avatar de WhatsApp y la URL de la imagen cuando lo tiene. Use el service_type ws_profile (el parámetro que selecciona un producto) con un número en formato E.164, por ejemplo +17253100591, y lea los atributos de retrato en el nivel superior de la misma respuesta de la API.
Límites claros
Preguntas frecuentes del producto
Verifica un identificador y devuelve si el número tiene avatar de WhatsApp y la URL de la imagen cuando lo tiene en la misma respuesta síncrona.
El saldo solo se cobra por las verificaciones completadas. En las verificaciones fallidas o indeterminadas no se mantiene el cargo.
Envíe el identificador que acepta el producto: un número en formato E.164 para WhatsApp o un email completo para el producto de email. Un formato incorrecto se rechaza antes de cualquier cargo.
No. Solo informa de si hay un avatar configurado en ese momento. No dice nada sobre si la cuenta está en uso o en línea, y no constituye un permiso para contactar con nadie. El consentimiento y las normas aplicables siguen siendo su responsabilidad.
Productos relacionados
Cree una cuenta para usar todos los productos desde el panel SaaS o la API: las verificaciones en tiempo real y las verificaciones masivas asíncronas consumen el mismo saldo.
