· 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: Definawspara 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âmetro | Tipo | Descrição |
|---|---|---|
file | file | Ficheiro com números a verificar, um número por linha |
task_type | string | ws — verificação de registo 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 | Estado: 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 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.