Detecção de Números de WhatsApp — Verificação em Lote via Plataforma ou API | CheckNumber.AI

API de detecção de números WhatsApp — Integração passo a passo

Verificar registro no WhatsApp em escala é essencial para limpeza de listas, antifraude, qualificação de leads e validação em CRM. Este guia cobre a API em massa da CheckNumber.AI com exemplos em curl, Python e Node.js.

Como funciona

Em produção as verificações são tarefas em lote: enviar arquivo, consultar status, baixar resultado — não uma chamada síncrona por número. Suporta o processamento de grandes volumes de forma eficiente.

Referência: WhatsApp Checker — bulk registration.

Criar tarefa

POST https://api.checknumber.ai/v1/tasks

Exemplo — curl:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="ws"'

Python:

import requests

url = "https://api.checknumber.ai/v1/tasks"
headers = {"X-API-Key": "YOUR_API_KEY"}

with open("numbers.txt", "rb") as f:
    files = {"file": f, "task_type": (None, "ws")}
    response = requests.post(url, headers=headers, files=files)

print(response.json())

Node.js:

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const form = new FormData();
form.append('file', fs.createReadStream('numbers.txt'));
form.append('task_type', 'ws');

axios.post('https://api.checknumber.ai/v1/tasks', form, {
  headers: {
    ...form.getHeaders(),
    'X-API-Key': 'YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.message));

Consultar status

POST https://api.checknumber.ai/v1/gettasks

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'

Colunas

Erros comuns

FAQ

Tempo de um lote grande? Depende da fila — normalmente segundos a poucos minutos.
Tamanho do arquivo? Mínimo 1 número; máximo ~50MB.
Cobrança só em sucesso? Sim, conforme política de uso.

Próximos passos

• 1.000 verificações grátis →
• Preços →
• Documentação →

Notas

1. Uma linha por número; E.164.
2. Poll até exported; usar result_url.
3. Docs oficiais.
4. pricing.