API simples de verificador em massa de números WhatsApp

O WhatsApp é uma plataforma de mensagens dominante em nível global, e verificar o status das contas em escala pode fornecer informações valiosas para as empresas. Este artigo apresenta a API simples de verificador em massa de números WhatsApp, que permite verificar de forma eficiente o status de contas WhatsApp para vários números simultaneamente.

Características principais

A API simples de verificador em massa oferece capacidades essenciais de verificação:

Verificação de contas

Verificação rápida e confiável do status da conta WhatsApp de qualquer número de telefone no mundo.

Processamento em massa

Processe vários números simultaneamente por meio do envio de arquivos, eficiente para verificações em grande escala.

Atualizações de status em tempo real

Acompanhe o progresso das suas tarefas de verificação em massa com atualizações de status em tempo real.

Etapas de uso

Envio de arquivo

Envie um arquivo de texto com números em formato E.164:

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

Obter detalhes da tarefa

Para consultar o status, use POST https://api.checknumber.ai/v1/gettasks com o campo de formulário task_id (veja o curl abaixo). Caminhos antigos /wa/api/simple/... não são usados.

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

Parâmetros da requisição

file: Arquivo com os números a verificar.
task_type: Defina ws para verificação de registro WhatsApp. Veja a documentação oficial.

Parâmetros da resposta

task_id: ID da tarefa.
created_at: Hora de criação da tarefa.
updated_at: Hora da última atualização.
status: Status da tarefa.
total: Número total de números na tarefa.
success: Número de verificações com sucesso.
failure: Número de falhas.
result_url: URL para baixar o arquivo de resultados.

Corpo da requisição

Parâmetro	Tipo	Descrição
`file`	`file`	Arquivo com números a verificar, um número por linha
`task_type`	`string`	`ws` — verificação de registro WhatsApp

Corpo da resposta

Parâmetro	Tipo	Descrição
`task_id`	`string`	ID da tarefa criada
`created_at`	`string`	Hora de criação
`updated_at`	`string`	Hora da última atualização
`status`	`string`	Status: pending, processing, completed, exported
`total`	`integer`	Número total de números na tarefa
`success`	`integer`	Número de números processados com sucesso
`failure`	`integer`	Número de falhas
`result_url`	`string`	Endereço de download do arquivo de resultados

Campos do resultado

A API retorna informações básicas: número em E.164 e status da conta WhatsApp (yes/no).

Códigos de status

200: Requisição bem-sucedida (pago)
400: Parâmetros ou formato de arquivo inválidos (grátis)
500: Erro interno do servidor (grátis)

Perguntas frequentes

1. Qual é a capacidade de processamento da API?

A API pode processar grandes lotes de números com atualizações de status em tempo real.

2. Em que formato deve estar o arquivo de entrada?

Deve ser um arquivo de texto com um número por linha em formato E.164 (ex.: +41798284651).

3. Que informações a API retorna?

Retorna se o número tem ou não uma conta WhatsApp ativa.

4. Quais são os códigos de status da API?

200: Requisição bem-sucedida (pago)
400: Parâmetros ou formato de arquivo inválidos (grátis)
500: Erro interno do servidor (grátis)

5. Qual é o preço da API?

O preço é 0,8 USD por 10.000 números para a verificação básica do status da conta WhatsApp.

Para mais informações sobre preços e volumes maiores, fale conosco.