Detección de Números de WhatsApp — Verificación en Lote via Plataforma o API | CheckNumber.AI

API de detección de números WhatsApp — Guía de integración paso a paso

Verificar el registro en WhatsApp a escala es clave para limpieza de listas, antifraude, calificación de leads y validación en CRM. Esta guía muestra cómo integrar la API masiva de CheckNumber.AI con ejemplos en curl, Python y Node.js.

Cómo funciona

En producción las comprobaciones son tareas por lotes: subir archivo, consultar estado, descargar resultados — no una llamada síncrona por número. Permite procesar grandes volúmenes de forma eficiente.

Referencia oficial: WhatsApp Checker — bulk registration.

Crear tarea

POST https://api.checknumber.ai/v1/tasks

Ejemplo — curl:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="ws"'

Ejemplo — Python:

import requests

url = "https://api.checknumber.ai/v1/tasks"
headers = {"X-API-Key": "YOUR_API_KEY"}

with open("numbers.txt", "rb") as f:
    files = {"file": f, "task_type": (None, "ws")}
    response = requests.post(url, headers=headers, files=files)

print(response.json())

Ejemplo — Node.js:

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const form = new FormData();
form.append('file', fs.createReadStream('numbers.txt'));
form.append('task_type', 'ws');

axios.post('https://api.checknumber.ai/v1/tasks', form, {
  headers: {
    ...form.getHeaders(),
    'X-API-Key': 'YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.message));

Consultar estado

POST https://api.checknumber.ai/v1/gettasks

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'

Columnas del resultado

Errores frecuentes

FAQ

¿Cuánto tarda un lote grande?
Depende de la cola; suele ser segundos o pocos minutos para volúmenes elevados.

¿Tamaño mínimo/máximo del archivo?
Mínimo 1 número; máximo ~50MB por archivo.

¿Solo se cobran checks exitosos?
Sí — las filas procesadas con éxito consumen crédito según política de facturación.

Próximos pasos

• Registro con 1.000 comprobaciones gratis →
• Precios →
• Documentación API →

Notas

1. Una línea por número; E.164 con prefijo país.
2. Hacer polling hasta exported, usar result_url.
3. Ver documentación oficial.
4. Precios: pricing.