Consulta en tiempo real de la foto de perfil de WhatsApp de cualquier número

La verificación de avatar de WA Lookup recibe un número de teléfono y devuelve, en la misma respuesta, si está registrado en WhatsApp y la foto de perfil pública que utiliza, sin guardar el contacto ni abrir WhatsApp.

En la aplicación de WhatsApp, normalmente solo puede ver la foto de perfil de alguien después de guardar su número, y solo si su configuración de privacidad lo permite. En un flujo de trabajo empresarial —un nuevo lead, un ticket de soporte, un contacto de entrega— guardar cada número en un teléfono es lento y deja contactos que usted no necesita.

La verificación de avatar en tiempo real (ws_avatar) responde directamente a la pregunta: ¿este número usa WhatsApp y qué foto de perfil pública muestra en este momento? Esta guía explica cómo funciona, qué devuelve y las funciones que incluye.

Cómo funciona una consulta de foto en tiempo real

1. Envíe un número en formato internacional, por ejemplo +12345678900. El + es opcional; consulte la Recomendación UIT-T E.164.
2. WA Lookup verifica el registro y la foto de perfil en la misma solicitud.
3. Lea ambas respuestas en la misma respuesta: sin cola, sin sondeos y sin callbacks.

Ejecútela donde le resulte más cómodo, con la misma verificación y el mismo saldo:

• La demostración de la página de inicio: cambie a Verificación de avatar; no necesita cuenta, con un límite diario.
• El panel: abra Verificación en tiempo real y seleccione Verificación de avatar de WhatsApp. La foto aparece junto al resultado.
• La API REST:

curl -X POST "https://walookup.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws_avatar", "identifier": "+12345678900" }'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_avatar",
    "identifier": "+12345678900",
    "registered": true,
    "avatar": true,
    "avatar_url": "<image url>"
  }
}

Cómo interpretar el resultado

avatar_url puede ser una cadena vacía, así que léalo siempre junto con el indicador avatar. Una verificación que no puede resolverse devuelve un code distinto de cero en lugar de un resultado.

Por qué algunos números registrados no muestran foto

Los usuarios de WhatsApp eligen quién puede ver su foto de perfil. Cuando un usuario la limita a sus contactos, la oculta o no tiene ninguna foto, no hay una foto pública que devolver, y el resultado es avatar: false aunque la cuenta esté registrada. Por eso avatar: false nunca significa "no está en WhatsApp": el registro siempre se informa por separado en registered.

Funciones incluidas en cada consulta

Registro y foto en una sola solicitud

No necesita hacer primero una verificación de registro y después una consulta de foto. Una sola solicitud devuelve ambos datos, de modo que una única llamada basta para decidir qué hacer con el número.

Sin guardar contactos ni iniciar sesión en WhatsApp

Las verificaciones se ejecutan en la infraestructura propia de WA Lookup. Nunca tiene que guardar el número en un teléfono, iniciar sesión en WhatsApp, escanear un código QR ni instalar una extensión. Su propia cuenta de WhatsApp no interviene, por lo que consultar fotos no la pone en riesgo.

El titular del número no recibe ninguna notificación

Una consulta no envía mensajes, llamadas ni notificaciones al número, y el titular no puede ver que se consultó su foto.

La misma respuesta en el panel y en la API

El panel, la API y el endpoint múltiple síncrono (POST /api/v1/batch-check) ejecutan la misma verificación con un único saldo, así que lo que ve durante las pruebas es lo que recibe su integración.

100 verificaciones gratuitas al registrarse

Las cuentas nuevas reciben 100 verificaciones gratuitas de forma automática, sin necesidad de solicitarlas. Como la verificación de avatar cuesta más por número que la verificación de registro, el mismo saldo gratuito cubre menos verificaciones de avatar; los precios vigentes están en la página de precios. Una consulta que no puede resolverse no consume saldo.

Cuándo resulta útil una consulta de foto

• Confirmar un nuevo lead. Una foto que coincide con la empresa o la persona del formulario da más confianza al equipo de ventas antes del primer seguimiento.
• Soporte y recuperación de cuentas. Un agente puede comparar la foto de WhatsApp del cliente con su ficha antes de tratar asuntos de la cuenta.
• Enriquecimiento del CRM. Guardar si un contacto tiene foto pública —y la propia foto cuando su política lo permita— ayuda a los equipos a reconocer a los contactos en sus herramientas.

Trate la foto como contexto, no como prueba: la elige el titular de la cuenta y no verifica la identidad, la titularidad del número ni el consentimiento para ser contactado. Para listas completas, existe una opción asíncrona de avatar masivo disponible como complemento.

Mantenga la proporcionalidad

En muchas jurisdicciones, una foto de perfil es un dato personal. Conforme al artículo 5 del RGPD, recopile solo lo que su finalidad requiera: utilice la verificación de registro (ws) cuando el estado sea suficiente, almacene fotos solo cuando su política de conservación lo permita y nunca utilice las consultas de fotos para vigilar a particulares. Antes de cualquier contacto, obtenga el consentimiento expreso (opt-in), tal como exige la Política de mensajería de WhatsApp Business.

Preguntas frecuentes

¿Necesito guardar el número como contacto para ver la foto?

No. La verificación de avatar funciona solo con el número de teléfono.

¿Por qué falta la foto de un número que sí está en WhatsApp?

Es posible que el usuario no tenga foto o que la haya limitado a sus contactos. En ese caso, el resultado muestra registered: true con avatar: false.

¿El titular del número sabe que se consultó su foto?

No. La consulta no envía nada al número.

¿Puedo consultar las fotos de varios números a la vez?

Sí. Use Verificación múltiple en el panel o el endpoint múltiple síncrono para conjuntos pequeños, y la opción de avatar masivo para listas completas. Consulte la documentación de la API para conocer los límites vigentes.

Más información

Pruebe la verificación de avatar sin iniciar sesión o cree una cuenta para obtener 100 verificaciones gratuitas.

• Abrir la página de Verificación de avatar de WhatsApp →
• Crear una cuenta gratuita →