· 3 min read

API simples de verificador em massa de números WhatsApp

Aprenda a usar a API simples de verificador em massa de números WhatsApp para verificar o estado de contas WhatsApp de vários números em simultâneo.

O WhatsApp é uma plataforma de mensagens dominante a nível global, e verificar o estado das contas à 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 estado de contas WhatsApp para vários números em simultâneo.

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 fiável do estado da conta WhatsApp de qualquer número de telefone no mundo.

Processamento em massa

Processe vários números em simultâneo através do carregamento de ficheiros, eficiente para verificações em grande escala.

Atualizações de estado em tempo real

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

Passos de utilização

Carregamento de ficheiro

Carregue um ficheiro 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 estado, 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 do pedido

  • file: Ficheiro com os números a verificar.
  • task_type: Defina ws para verificação de registo WhatsApp. Ver 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: Estado 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 descarregar o ficheiro de resultados.

Corpo do pedido

ParâmetroTipoDescrição
filefileFicheiro com números a verificar, um número por linha
task_typestringws — verificação de registo WhatsApp

Corpo da resposta

ParâmetroTipoDescrição
task_idstringID da tarefa criada
created_atstringHora de criação
updated_atstringHora da última atualização
statusstringEstado: pending, processing, completed, exported
totalintegerNúmero total de números na tarefa
successintegerNúmero de números processados com sucesso
failureintegerNúmero de falhas
result_urlstringEndereço de descarga do ficheiro de resultados

Campos do resultado

A API devolve informação básica: número em E.164 e estado da conta WhatsApp (yes/no).

Códigos de estado

  • 200: Pedido com sucesso (pago)
  • 400: Parâmetros ou formato de ficheiro 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 estado em tempo real.

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

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

3. Que informação devolve a API?

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

4. Quais são os códigos de estado da API?
  • 200: Pedido com sucesso (pago)
  • 400: Parâmetros ou formato de ficheiro inválidos (grátis)
  • 500: Erro interno do servidor (grátis)
5. Qual o preço da API?

O preço é 1 USD por 10.000 números para a verificação básica do estado da conta WhatsApp.

Para mais informações sobre preços e volumes maiores, contacte-nos.

Related Posts

View All Posts »