Stato della verifica di numeri WhatsApp (API)

Controlla l'avanzamento di un'attività di verifica dei numeri e ottieni il risultato per ogni numero che contiene. Interroga periodicamente questo endpoint dopo aver creato un'attività di verifica, finché l'attività non è completata.

Esempio rapido#

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');
}

Parametri della richiesta#

Risposta#

Una richiesta riuscita restituisce 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"
}

Tutti i timestamp sono in formato ISO 8601 in UTC, con i microsecondi e l'offset +00:00, ad esempio 2026-09-16T10:16:12.204551+00:00.

Valori di stato dei numeri#

Valori dello stato complessivo#

Un'attività completed può mostrare un completed_percentage inferiore a 100 se alcune verifiche sono state annullate, perché i numeri annullati contano in total ma non nella percentuale.

Errori#

Gli errori restituiscono un corpo JSON con status impostato su "error" e un codice di errore HTTP:

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

Suggerimenti#

• Interroga con moderazione. In background vengono verificati fino a 10 numeri per esecuzione, quindi un controllo ogni 30-60 secondi è più che sufficiente, e un'attività grande può richiedere molto tempo.
• Smetti di interrogare quando overall_status è completed.
• Bloccato su pending? La verifica richiede un numero WhatsApp collegato nelle Impostazioni WhatsApp dello stesso spazio di lavoro. Senza, i numeri non vengono mai verificati. Le verifiche restano inoltre in attesa mentre il tuo numero collegato è occupato a inviare messaggi.
• Attività grandi: questo endpoint restituisce tutti i numeri in una sola risposta. Per leggere i risultati pagina per pagina, o solo i numeri verified, usa Risultati della verifica.