API de detalhes do verificador em massa de números WhatsApp

Verifique se um número global é uma conta WhatsApp registrada e obtenha informações detalhadas do perfil.

URL da API

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

Características principais

A API de detalhes do verificador em massa de números WhatsApp oferece recursos completos de verificação:

Informações da conta

Informações detalhadas da conta WhatsApp, incluindo:

• Verificação do status da conta
• Assinaturas do usuário
• Data/hora das atualizações de status

Processamento em massa

Processe vários números simultaneamente por meio do envio de arquivo, o que torna a verificação em grande escala eficiente.

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 de telefone no formato E.164:

Exemplo de requisição

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

Parâmetros da requisição

Verificação de status

Acompanhe o status de processamento da sua tarefa:

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

Exemplos de resposta

Resposta de criação da tarefa

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

Resposta de status em processamento

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

Resposta de tarefa concluída

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

Campos do resultado

Formato de resposta da API

Códigos de status

Notas de integração

1. Cada linha do arquivo de entrada deve conter um número de telefone no formato E.164.

2. Acompanhe o status da tarefa usando o task_id fornecido.

3. Baixe os resultados pelo result_url quando o status for “exported”.

4. Trate adequadamente os diferentes códigos de status no seu aplicativo.

Perguntas frequentes

1. Qual é a capacidade de processamento da API?

A API processa grandes lotes de números com eficiência, com atualizações em tempo real sobre o andamento do processamento.

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

O arquivo de entrada deve ser um arquivo de texto com um número de telefone por linha no formato E.164 (ex.: +41798284651).

3. Que informações a API retorna?

A API retorna informações detalhadas da conta, incluindo:

• Status da conta WhatsApp
• Assinatura do usuário (ex.: “Hey there! I am using WhatsApp”)
• Data/hora da última atualização de status

4. Qual é o preço da API?

O preço é de $1.5 USD por 10.000 números para informações detalhadas de contas WhatsApp, incluindo atualizações de status e assinaturas.

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