Guía de producto
Cómo verificar números de teléfono de un CSV en tiempo real
Verifique números de un CSV en tiempo real con WA Lookup: formato E.164, hasta 100 números por solicitud síncrona y presencia de cuenta en la misma respuesta.
Aprenda a preparar un CSV de números de teléfono en formato E.164 y a procesarlos con los endpoints en tiempo real individual y múltiple de WA Lookup para obtener señales inmediatas de presencia de cuenta.
WA Lookup verifica la presencia de cuentas de WhatsApp en tiempo real: envíe un número E.164 a POST /api/v1/check, o hasta 100 números al endpoint múltiple síncrono POST /api/v1/batch-check, y el resultado completado se devuelve en la misma respuesta HTTP. Un CSV es simplemente una fuente para esas solicitudes: estandarice la columna, elija un tipo de servicio y envíe los identificadores a través del endpoint múltiple, hasta 100 cada vez. Un archivo completo que supere con creces una solicitud en tiempo real también puede subirse como tarea masiva asíncrona.
Cómo preparar sus datos para la verificación
Antes de iniciar cualquier solicitud a la API, su archivo CSV debe tener el formato adecuado. WA Lookup exige que todos los números de teléfono enviados utilicen el formato E.164. Este plan internacional de numeración telefónica establece que cada número sea único e inequívoco; normalmente empieza con un signo más seguido del código de país y del número de abonado. Estandarizar la columna de su CSV con este formato reduce los errores durante la llamada a la API y contribuye a un procesamiento preciso de los datos de entrada del flujo de trabajo.
Cómo elegir el tipo de verificación de WhatsApp adecuado
WA Lookup ofrece tres tipos de servicio, tanto para las verificaciones individuales síncronas como para las verificaciones múltiples síncronas. Seleccione el tipo que corresponda a la señal de presencia de cuenta que requiere su flujo de trabajo.
| Tipo de servicio | Alcance y señales devueltas |
|---|---|
| ws | Devuelve el estado estándar de registro en la plataforma (booleano registered). |
| ws_avatar | Comprueba el registro y añade enriquecimiento de perfil (booleano avatar y cadena avatar_url, vacía cuando no hay ninguna URL disponible). |
| ws_business | Comprueba el registro e identifica las cuentas de WhatsApp Business (booleano business). |
El parámetro service_type controla qué campos se devuelven y qué coste de saldo se aplica.
Cómo ejecutar su flujo de verificación
Para un CSV, utilice el endpoint múltiple síncrono POST /api/v1/batch-check para hasta 100 identificadores formateados cada vez; utilice POST /api/v1/check para un solo identificador. Ambos devuelven los resultados en la respuesta HTTP de la solicitud, sin envío de tareas, sondeo ni paso de descarga.
En una verificación de WhatsApp completada, el objeto data devuelto contiene service_type, identifier y registered; ws_avatar incluye además avatar y avatar_url, mientras que ws_business incluye business. Los campos internos de registro, transacción, estado y facturación no se devuelven.
Gestión de costes y resultados
Los equipos pueden utilizar el panel de WA Lookup para gestionar las claves API, revisar el historial de verificaciones y supervisar el saldo y el uso por producto. La solicitud múltiple en sí se ejecuta de forma síncrona a través de la API, mientras que el panel ofrece visibilidad de la cuenta y del uso. Las cuentas nuevas también pueden contactar con soporte para obtener 100 verificaciones gratuitas con las que probar las verificaciones de registro, avatar y cuenta Business antes de procesar archivos CSV más grandes.
Preguntas frecuentes
¿Cuál es la diferencia entre ws, ws_avatar y ws_business?
El tipo de servicio ws devuelve el estado estándar de registro en la plataforma. El tipo ws_avatar añade la disponibilidad de avatar y un campo de URL de avatar, que queda vacío cuando no hay ninguna URL disponible. El tipo ws_business comprueba el registro e identifica si el número está asociado a una cuenta de WhatsApp Business.
¿Puedo verificar varios números en una sola solicitud?
Sí. El endpoint múltiple síncrono POST /api/v1/batch-check admite hasta 100 identificadores y devuelve los resultados completados en la misma respuesta HTTP, sin envío de tareas, sondeo ni paso de descarga. Para una lista completa que supere con creces esa cifra, también está disponible una tarea masiva asíncrona (al enviarla, usted elige el país al que pertenecen los números, y la lista debe corresponder esencialmente a ese único país), pero los endpoints síncronos siguen siendo la forma principal de verificar.
¿Se cargan a mi saldo las verificaciones fallidas?
Las verificaciones fallidas, agotadas por tiempo o indeterminadas no conservan el cargo. Consulte la página de precios para conocer los detalles de facturación vigentes.