Estado de la verificación de números de WhatsApp (API)

Consulta el progreso de una tarea de verificación de números y obtén el resultado de cada número que contiene. Consulta periódicamente este endpoint después de crear una tarea de verificación hasta que la tarea termine.

Ejemplo rápido#

curl "https://wbiztool.com/api/v1/verification/status/?campaign_id=4521" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://wbiztool.com/api/v1/verification/status/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"campaign_id": 4521},
    timeout=60,
)
result = response.json()  # read the body even when the HTTP code is 4xx or 5xx

if result["status"] == "success":
    progress = result["progress"]
    print(result["overall_status"], f"{progress['completed_percentage']}% done")
    for item in result["results"]:
        print(item["number"], item["status"])
else:
    print(f"Failed ({response.status_code}):", result["message"])

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const url = new URL("https://wbiztool.com/api/v1/verification/status/");
url.searchParams.set("campaign_id", "4521");

const response = await fetch(url, {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const result = await response.json(); // read the body even when the HTTP code is 4xx or 5xx

if (result.status === "success") {
  console.log(result.overall_status, `${result.progress.completed_percentage}% done`);
  for (const item of result.results) {
    console.log(item.number, item.status);
  }
} else {
  console.error(`Failed (${response.status}):`, result.message);
}

<?php
$ch = curl_init('https://wbiztool.com/api/v1/verification/status/?campaign_id=4521');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if (($result['status'] ?? '') === 'success') {
    echo $result['overall_status'] . ' - ' . $result['progress']['completed_percentage'] . "% done\n";
    foreach ($result['results'] as $item) {
        echo $item['number'] . ': ' . $item['status'] . "\n";
    }
} else {
    echo 'Failed: ' . ($result['message'] ?? 'no response');
}

Parámetros de la solicitud#

Respuesta#

Una solicitud correcta devuelve HTTP 200:

{
  "status": "success",
  "campaign_id": 4521,
  "campaign_name": "Website leads - September",
  "overall_status": "processing",
  "progress": {
    "total": 3,
    "pending": 1,
    "verified": 1,
    "invalid": 1,
    "completed_percentage": 66.67
  },
  "results": [
    {
      "number": "14155550123",
      "status": "pending",
      "checked_at": null,
      "created_at": "2026-09-16T10:15:00.483101+00:00"
    },
    {
      "number": "919876543210",
      "status": "verified",
      "checked_at": "2026-09-16T10:16:12.204551+00:00",
      "created_at": "2026-09-16T10:15:00.482913+00:00"
    },
    {
      "number": "919876543211",
      "status": "invalid",
      "checked_at": "2026-09-16T10:16:19.915372+00:00",
      "created_at": "2026-09-16T10:15:00.483020+00:00"
    }
  ],
  "created_at": "2026-09-16T10:15:00.471820+00:00",
  "last_updated": "2026-09-16T10:15:00.471820+00:00"
}

Todas las marcas de tiempo están en ISO 8601 en UTC, con microsegundos y un desfase +00:00, por ejemplo 2026-09-16T10:16:12.204551+00:00.

Valores de estado del número#

Valores del estado general#

Una tarea completed puede mostrar un completed_percentage inferior a 100 si se cancelaron algunas comprobaciones, porque los números cancelados cuentan para total pero no para el porcentaje.

Errores#

Los errores devuelven un cuerpo JSON con status con valor "error" y un código de error HTTP:

{ "status": "error", "message": "Campaign not found" }

Consejos#

• No consultes con demasiada frecuencia. Se comprueban hasta 10 números por ejecución en segundo plano, así que basta con consultar cada 30 a 60 segundos, y una tarea grande puede tardar bastante.
• Deja de consultar cuando overall_status sea completed.
• ¿Se queda en pending? La verificación necesita un número de WhatsApp conectado en la configuración de WhatsApp del mismo espacio de trabajo. Sin él, los números nunca se comprueban. Las comprobaciones también esperan mientras tu número conectado está ocupado enviando mensajes.
• Tareas grandes: este endpoint devuelve todos los números en una sola respuesta. Para leer los resultados página a página, o solo los números verified, usa Resultados de la verificación.