WhatsApp Days API de Dias de Atividade: Detectar atividade da conta

Detecte os dias de atividade do WhatsApp, se é conta Business e a assinatura para os números globais informados

Exemplo para enviar o arquivo de detecção:

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

Exemplo para consultar o status da tarefa:

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

Resposta para upload bem-sucedido:

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Resposta para status de processamento:

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Resposta quando a tarefa for concluída (inclui a URL de download):

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256..."
}

URL da requisição para upload de arquivo

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

Parâmetros da requisição para upload de arquivo

Parâmetro	Descrição
file	file, Envie um arquivo; cada linha deve conter um número no formato E.164
task_type	string, Tipo de tarefa, defina como “ws_active”

URL da requisição para consultar status

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

Parâmetros da requisição para consultar status

Parâmetro	Descrição
task_id	string, ID da tarefa retornado na criação

Campos do resultado

Campo	Descrição	Exemplo
Number	Número de telefone no formato E.164	+12025551234
whatsapp_days	Dias de atividade da conta do WhatsApp	1, 7, 30, N/A
whatsapp_business	Indica se o número tem uma conta ativa do WhatsApp Business	yes, no
signature	Informações de assinatura da conta do WhatsApp	Hello World, N/A

Formato da resposta

Campo	Descrição
created_at	Data e hora em que a tarefa foi criada
updated_at	Data e hora da última atualização do status da tarefa
task_id	Identificador único da tarefa
user_id	ID do usuário
status	Status da tarefa: pending: na fila e aguardando processing: em processamento exported: resultados disponíveis para download
total	Total de números de telefone processados
success	Números identificados com sucesso
failure	Números que falharam no processamento
result_url	Opcional. URL para baixar os resultados quando o status é exported

Códigos de status

Status	Descrição
200	charge; solicitação bem-sucedida, tarefa criada ou status consultado
400	free; solicitação inválida, parâmetros ou formato de arquivo inválidos
500	free; erro interno do servidor; tente novamente mais tarde