Status da verificação de números de WhatsApp (API)

Acompanhe o progresso de uma tarefa de verificação de números e obtenha o resultado de cada número dela. Consulte este endpoint periodicamente depois de criar uma tarefa de verificação até que a tarefa seja concluída.

Exemplo 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 da requisição#

Resposta#

Uma requisição bem-sucedida retorna 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"
}

Todos os timestamps estão em ISO 8601, em UTC, com microssegundos e deslocamento +00:00, por exemplo 2026-09-16T10:16:12.204551+00:00.

Valores de status do número#

Valores de status geral#

Uma tarefa completed pode mostrar um completed_percentage abaixo de 100 se algumas verificações foram canceladas, porque os números cancelados contam em total, mas não na porcentagem.

Erros#

Os erros retornam um corpo JSON com status igual a "error" e um código de erro HTTP:

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

Dicas#

• Consulte com moderação. Até 10 números são verificados por execução em segundo plano, então verificar a cada 30 a 60 segundos é suficiente, e uma tarefa grande pode levar bastante tempo.
• Pare de consultar quando overall_status for completed.
• Parado em pending? A verificação precisa de um número de WhatsApp conectado nas configurações do WhatsApp no mesmo espaço de trabalho. Sem ele, os números nunca são verificados. As verificações também aguardam enquanto seu número conectado está ocupado enviando mensagens.
• Tarefas grandes: este endpoint retorna todos os números em uma única resposta. Para ler os resultados página por página, ou somente os números verified, use Resultados da verificação.