Status der WhatsApp-Nummernverifizierung (API)

Prüfen Sie den Fortschritt einer Aufgabe zur Nummernverifizierung und erhalten Sie das Ergebnis für jede enthaltene Nummer. Fragen Sie diesen Endpoint nach dem Erstellen einer Verifizierungsaufgabe regelmäßig ab, bis die Aufgabe abgeschlossen ist.

Kurzes Beispiel#

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

Request-Parameter#

Antwort#

Ein erfolgreicher Request gibt HTTP 200 zurück:

{
  "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"
}

Alle Zeitstempel sind im Format ISO 8601 in UTC mit Mikrosekunden und der Abweichung +00:00 angegeben, zum Beispiel 2026-09-16T10:16:12.204551+00:00.

Werte für den Nummernstatus#

Werte für den Gesamtstatus#

Eine Aufgabe mit completed kann einen completed_percentage unter 100 anzeigen, wenn einige Prüfungen abgebrochen wurden, da abgebrochene Nummern zwar in total, aber nicht in den Prozentsatz einfließen.

Fehler#

Fehler liefern einen JSON-Body mit status gleich "error" und einen HTTP-Fehlercode:

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

Tipps#

• Fragen Sie maßvoll ab. Im Hintergrund werden pro Durchlauf bis zu 10 Nummern geprüft. Eine Abfrage alle 30 bis 60 Sekunden reicht daher völlig aus, und eine große Aufgabe kann lange dauern.
• Beenden Sie die Abfragen, sobald overall_status den Wert completed hat.
• Hängt bei pending? Die Verifizierung benötigt eine WhatsApp-Nummer, die in den WhatsApp-Einstellungen im selben Arbeitsbereich verbunden ist. Ohne eine solche Nummer werden die Nummern nie geprüft. Die Prüfungen warten außerdem, solange Ihre verbundene Nummer Nachrichten sendet.
• Große Aufgaben: Dieser Endpoint gibt jede Nummer in einer einzigen Antwort zurück. Um Ergebnisse seitenweise oder nur die verified-Nummern abzurufen, verwenden Sie Verifizierungsergebnisse.