CheckNumber.AI· 3 min read
API simple de verificador masivo de números WhatsApp
Aprenda a usar la API simple de verificador masivo de números WhatsApp para verificar el estado de cuentas WhatsApp de varios números a la vez.
WhatsApp es una plataforma de mensajería dominante a nivel global, y verificar el estado de las cuentas a escala puede aportar información valiosa para las empresas. Este artículo presenta la API simple de verificador masivo de números WhatsApp, que permite verificar de forma eficiente el estado de cuentas WhatsApp para varios números a la vez.
Características principales
La API simple de verificador masivo ofrece capacidades esenciales de verificación:
Verificación de cuentas
Verificación rápida y fiable del estado de la cuenta WhatsApp de cualquier número de teléfono en el mundo.
Procesamiento en masa
Procese varios números a la vez mediante la subida de archivos, ideal para verificaciones a gran escala.
Actualizaciones de estado en tiempo real
Siga el progreso de sus tareas de verificación masiva con actualizaciones de estado en tiempo real.
Pasos de uso
Subida de archivo
Suba un archivo de texto con números en formato E.164:
curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"/path/to/file.txt"' \
--form 'task_type="ws"'
Obtener detalles de la tarea
Para consultar el estado, use POST https://api.checknumber.ai/v1/gettasks con el campo de formulario task_id (véase el curl más abajo). No se usan rutas antiguas /wa/api/simple/....
curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'
Parámetros de la petición
file: Archivo con los números a verificar.task_type: Use el valorwspara comprobar el registro en WhatsApp. Ver documentación oficial.
Parámetros de la respuesta
task_id: ID de la tarea.created_at: Hora de creación de la tarea.updated_at: Hora de la última actualización.status: Estado de la tarea.total: Número total de números en la tarea.success: Número de verificaciones correctas.failure: Número de fallos.result_url: URL para descargar el archivo de resultados.
Cuerpo de la petición
| Parámetro | Tipo | Descripción |
|---|---|---|
file | file | Archivo con números a verificar, un número por línea |
task_type | string | ws — comprobación de registro en WhatsApp |
Cuerpo de la respuesta
| Parámetro | Tipo | Descripción |
|---|---|---|
task_id | string | ID de la tarea creada |
created_at | string | Hora de creación |
updated_at | string | Hora de última actualización |
status | string | Estado: pending, processing, completed, exported |
total | integer | Número total de números en la tarea |
success | integer | Número de números procesados correctamente |
failure | integer | Número de fallos |
result_url | string | Dirección de descarga del archivo de resultados |
Campos del resultado
La API devuelve información básica: número en E.164 y estado de la cuenta WhatsApp (yes/no).
Códigos de estado
200: Petición correcta (de pago)400: Parámetros o formato de archivo inválidos (gratis)500: Error interno del servidor (gratis)
Preguntas frecuentes
1. ¿Qué capacidad de procesamiento tiene la API?
La API puede procesar grandes lotes de números con actualizaciones de estado en tiempo real.
2. ¿En qué formato debe estar el archivo de entrada?
Debe ser un archivo de texto con un número por línea en formato E.164 (p. ej. +41798284651).
3. ¿Qué información devuelve la API?
Devuelve si el número tiene o no una cuenta WhatsApp activa.
4. ¿Cuáles son los códigos de estado de la API?
200: Petición correcta (de pago)400: Parámetros o formato de archivo inválidos (gratis)500: Error interno del servidor (gratis)
5. ¿Cuál es el precio de la API?
El precio es 1 USD por 10.000 números para la verificación básica del estado de la cuenta WhatsApp.
Para más información sobre precios y volúmenes mayores, contáctenos.