Проверки номеров

Проверка номеров выясняет, у каких номеров телефонов есть аккаунт WhatsApp, ничего им не отправляя. Очистите список перед кампанией или проверьте номер нового клиента, прежде чем ему писать. Проверки, созданные через API, — те же самые списки, что на странице Проверка номеров в панели.

Для запуска проверки нужен тариф, включающий проверку номеров; иначе ответ — 403 plan_required. Чтение проверок работает на любом тарифе.

Запуск проверки#

Номера ставятся в очередь, и ответ — 201 с проверкой в статусе pending. Подключённый номер WhatsApp вашего рабочего пространства проверяет их в течение следующих минут. Опрашивайте проверку, пока status не станет completed, а затем прочитайте результаты.

curl -X POST https://wbiztool.com/api/v2/number-checks \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: october-leads" \
  -d '{
    "name": "October leads",
    "numbers": ["+919876543210", "+447700900123", "+14155550123"]
  }'

import os
import time
import requests

API = "https://wbiztool.com/api/v2"
headers = {"Authorization": f"Bearer {os.environ['WBIZTOOL_API_KEY']}"}

check = requests.post(f"{API}/number-checks", headers=headers, timeout=60, json={
    "name": "October leads",
    "numbers": ["+919876543210", "+447700900123", "+14155550123"],
}).json()
print("Skipped entries:", check["skipped"])

while check["status"] != "completed":
    time.sleep(30)
    check = requests.get(f"{API}/number-checks/{check['id']}", headers=headers, timeout=30).json()
    print(check["counts"])

params = {"limit": 100}
while True:
    page = requests.get(f"{API}/number-checks/{check['id']}/results",
                        headers=headers, params=params, timeout=30).json()
    for result in page["data"]:
        print(result["number"], result["status"])
    if not page["next_cursor"]:
        break
    params["cursor"] = page["next_cursor"]

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const API = "https://wbiztool.com/api/v2";
const headers = { Authorization: `Bearer ${process.env.WBIZTOOL_API_KEY}`, "Content-Type": "application/json" };
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

let check = await (await fetch(`${API}/number-checks`, {
  method: "POST",
  headers,
  body: JSON.stringify({ name: "October leads", numbers: ["+919876543210", "+447700900123", "+14155550123"] }),
})).json();

while (check.status !== "completed") {
  await sleep(30000);
  check = await (await fetch(`${API}/number-checks/${check.id}`, { headers })).json();
}

const params = new URLSearchParams({ limit: "100" });
while (true) {
  const page = await (await fetch(`${API}/number-checks/${check.id}/results?${params}`, { headers })).json();
  for (const result of page.data) console.log(result.number, result.status);
  if (!page.next_cursor) break;
  params.set("cursor", page.next_cursor);
}

<?php
$ch = curl_init('https://wbiztool.com/api/v2/number-checks');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('WBIZTOOL_API_KEY'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'name'    => 'October leads',
        'numbers' => ['+919876543210', '+447700900123', '+14155550123'],
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$check = json_decode(curl_exec($ch), true);
curl_close($ch);
// Save $check['id'], then poll GET /api/v2/number-checks/{id} until status is completed.
echo $check['id'] . ' ' . $check['status'] . ' skipped: ' . $check['skipped'];

Ответ (201):

{
  "id": 51207,
  "name": "October leads",
  "status": "pending",
  "counts": { "total": 3, "pending": 3, "on_whatsapp": 0, "not_on_whatsapp": 0, "cancelled": 0 },
  "created_at": "2026-10-18T10:40:02.511Z",
  "skipped": 0
}

skipped — сколько элементов не были номерами телефонов (текст, меньше 7 или больше 15 цифр): они не проверяются и не учитываются в вашем тарифе.

Лимиты тарифа#

Ваш тариф определяет, сколько номеров можно проверить (см. Лимиты тарифа):

• На одну проверку: в проверке не может быть больше номеров, чем позволяет тариф. При превышении проверка отклоняется с too_many_numbers, с count и limit.
• За расчётный период: все проверки вместе, из API и из панели, тоже не могут превысить лимит. Проверка, которая его превысила бы, отклоняется с number_check_quota_reached, с requested, used и limit.
• У тарифа без лимита нет ни того, ни другого. API принимает не больше 10 000 номеров за запрос на любом тарифе.
• Отклонённая проверка ничего не ставит в очередь. Разделите список, дождитесь следующего периода или перейдите на тариф выше.

Ошибки при запуске проверки#

Список проверок#

Проверки рабочего пространства, сначала самые новые, страницами (limit от 1 до 100, по умолчанию 25, и cursor), включая запущенные в панели. Каждая — это Number check.

curl https://wbiztool.com/api/v2/number-checks \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY"

Получение проверки#

Проверка и её ход. Опрашивайте её примерно каждые 30 секунд, пока status не станет completed.

curl https://wbiztool.com/api/v2/number-checks/51207 \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY"

{
  "id": 51207,
  "name": "October leads",
  "status": "processing",
  "counts": { "total": 3, "pending": 1, "on_whatsapp": 1, "not_on_whatsapp": 1, "cancelled": 0 },
  "created_at": "2026-10-18T10:40:02.511Z"
}

Проверка, которой не существует, возвращает 404 number_check_not_found.

Для проверки нужен номер WhatsApp рабочего пространства, подключённый по QR-коду или коду привязки, и она ждёт, пока ваши номера отправляют сообщения. Проверка может какое-то время оставаться в статусе pending или processing; см. Как идёт проверка.

Получение результатов#

Номера проверки и то, что о них выяснено, страницами (limit от 1 до 100, по умолчанию 25, и cursor). Их можно читать, пока проверка идёт: ещё не проверенные номера имеют статус pending.

curl "https://wbiztool.com/api/v2/number-checks/51207/results?limit=100" \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY"

{
  "data": [
    { "number": "14155550123", "on_whatsapp": null, "status": "pending", "checked_at": null },
    { "number": "447700900123", "on_whatsapp": false, "status": "not_on_whatsapp", "checked_at": "2026-10-18T10:42:57.204Z" },
    { "number": "919876543210", "on_whatsapp": true, "status": "on_whatsapp", "checked_at": "2026-10-18T10:42:51.880Z" }
  ],
  "next_cursor": null
}

Объект Number check#

Связанные материалы#

• Проверка номеров в панели
• Тарифы и оплата
• Ошибки