Статус проверки номеров WhatsApp (API)

Следите за ходом задачи проверки номеров и получайте результат по каждому номеру в ней. Опрашивайте этот endpoint после создания задачи проверки, пока задача не завершится.

Быстрый пример#

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

Параметры запроса#

Ответ#

Успешный запрос возвращает 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"
}

Все метки времени указываются в формате ISO 8601 в UTC с микросекундами и смещением +00:00, например 2026-09-16T10:16:12.204551+00:00.

Значения статуса номера#

Значения общего статуса#

У задачи со статусом completed значение completed_percentage может быть меньше 100, если часть проверок была отменена: отменённые номера учитываются в total, но не в проценте.

Ошибки#

Ошибки возвращают JSON-тело со status, равным "error", и кодом ошибки HTTP:

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

Советы#

• Не опрашивайте слишком часто. За один запуск в фоне проверяется до 10 номеров, поэтому опроса раз в 30–60 секунд вполне достаточно, а большая задача может выполняться долго.
• Прекращайте опрос, когда overall_status равен completed.
• Задача застряла в pending? Для проверки нужен номер WhatsApp, подключённый на странице настроек WhatsApp в том же рабочем пространстве. Без него номера никогда не будут проверены. Проверки также ждут, пока ваш подключённый номер занят отправкой сообщений.
• Большие задачи: этот endpoint возвращает все номера в одном ответе. Чтобы читать результаты постранично или только номера со статусом verified, используйте API результатов проверки.