Cómo verifica WA Lookup un número de WhatsApp

Complete una verificación

Esta sección trata las verificaciones en tiempo real: el panel SaaS y los endpoints REST síncronos comparten un mismo servicio de verificación y un mismo significado de respuesta. Para listas muy grandes existe una opción masiva asíncrona, que se explica al final de esta página.

1. 1

   Envíe un número

   Envíe el número que necesita verificar, con el formato que exige la documentación de la API.

2. 2

   Elija un producto

   ws para el registro; ws_avatar añade campos de avatar; ws_business añade campos de cuenta Business. Para los días de actividad, la verificación masiva asíncrona tiene un producto correspondiente.

3. 3

   Lea el resultado

   Lea registered en la misma respuesta. Realice una nueva verificación cuando necesite un estado actualizado.

Qué formato de número enviar

WA Lookup acepta un número por verificación, escrito en formato E.164: un signo más, el código de país y, a continuación, el número de abonado sin espacios ni signos de puntuación; por ejemplo, +17253100591. Es el mismo formato que la aplicación WhatsApp almacena internamente, por lo que un número en este formato corresponde exactamente a una cuenta. Un número sin código de país no puede verificarse de forma fiable: los mismos dígitos existen en muchos países.

• Incluya siempre el código de país; no confíe en el país de su propia cuenta.
• Elimine los espacios, guiones, paréntesis y ceros iniciales que se usan para la marcación nacional; conserve solo el + y los dígitos.
• Los números con un formato incorrecto se rechazan antes de cualquier cargo; un formato rechazado no es un resultado de «no registrado».

¿Qué significa registered?

registered es la respuesta de una verificación de WhatsApp. Solo aparece en una respuesta correcta y es un valor booleano: true significa que el número está registrado en WhatsApp en el momento de la solicitud y false significa que no lo está. Cualquier otra cosa (un tiempo de espera agotado, un resultado indeterminado, un número no válido) se devuelve en su lugar como código de error, y WA Lookup reembolsa esa verificación automáticamente. Por tanto, la ausencia del campo registered nunca significa «no registrado»; significa que la verificación no produjo un resultado. El valor refleja el momento en que preguntó: las cuentas se crean y se eliminan continuamente, así que actualice la verificación antes de actuar sobre un resultado antiguo en lugar de guardarlo en caché durante semanas.

• registered=true significa registrado.
• registered=false significa no registrado.
• Gestione los demás desenlaces según el código de respuesta de la API; no deduzca registered por su cuenta.

Elija un producto según sus necesidades

Elija el producto en tiempo real más reducido que responda a su pregunta; la documentación de la API contiene las definiciones completas de los campos.

• ws devuelve el estado de registro.
• ws_avatar también devuelve campos de avatar; avatar_url es una cadena vacía cuando no hay avatar disponible.
• ws_business también devuelve campos de cuenta Business.

Use el resultado dentro de su alcance

Una verificación refleja el estado en el momento de la solicitud. No es una verificación de identidad ni un permiso para contactar con alguien.

• No confirma quién es el titular del número, si está en línea en este momento ni ningún contenido de mensajes; el producto masivo de actividad devuelve los días desde la última actividad, no la presencia en directo.
• Un resultado registrado no establece el consentimiento para contactar con el número.
• Realice una nueva verificación cuando la decisión de negocio requiera un estado actual.

Listas muy grandes: la opción asíncrona

La verificación múltiple del panel y el endpoint múltiple de la API cubren la mayoría de las listas. Solo cuando una lista supera con creces esos límites tiene sentido enviar el archivo completo como una tarea masiva asíncrona: usted elige el país al que pertenece la lista, y esta debe ser esencialmente de ese único país.

• Suba un archivo .txt o .csv con un número E.164 por línea, desde la página de verificación masiva o a través de la API.
• Elija el país al que pertenecen los números al enviarlos; la lista debe ser esencialmente de ese único país. Demasiados números de otros lugares hacen que la tarea falle mientras se prepara el archivo: no se envía a verificar y se reembolsa íntegramente.
• Al enviar, se reserva saldo para las líneas válidas, solo se le cobran los números que devuelven un resultado y la diferencia se reembolsa.
• La tarea se ejecuta en segundo plano; descargue el archivo de resultados cuando termine. Una tarea fallida se reembolsa íntegramente.