Como verificar números de telefone de um CSV em tempo real

Saiba como preparar um CSV de números de telefone no formato E.164 e processá-los pelos endpoints individual e múltiplo em tempo real do WA Lookup para obter sinais imediatos de presença da conta.

O WA Lookup verifica a presença de contas no WhatsApp em tempo real: envie um número E.164 para POST /api/v1/check, ou até 100 números para o endpoint múltiplo síncrono POST /api/v1/batch-check, e o resultado concluído é retornado na mesma resposta HTTP. Um CSV é apenas uma fonte para essas requisições — padronize a coluna, escolha um tipo de serviço e envie os identificadores pelo endpoint múltiplo, até 100 de cada vez. Um arquivo inteiro, muito maior do que uma requisição em tempo real, também pode ser enviado como tarefa em massa assíncrona.

Preparando seus dados para a verificação

Antes de iniciar qualquer requisição à API, seu arquivo CSV precisa estar formatado corretamente. O WA Lookup exige que todos os números de telefone enviados usem o formato E.164. Esse plano internacional de numeração telefônica determina que cada número seja único e inequívoco, normalmente começando com um sinal de mais seguido do código do país e do número do assinante. Padronizar a coluna do CSV nesse formato reduz os erros durante a chamada à API e contribui para o processamento preciso da entrada do fluxo de trabalho.

Escolhendo o tipo de verificação de WhatsApp adequado

O WA Lookup oferece três tipos de serviço, válidos tanto para verificações individuais síncronas quanto para verificações múltiplas síncronas. Selecione o tipo que corresponde ao sinal de presença da conta de que seu fluxo de trabalho precisa.

O parâmetro service_type controla quais campos são retornados e qual custo é debitado do saldo.

Executando seu fluxo de verificação

Para um CSV, use o endpoint múltiplo síncrono POST /api/v1/batch-check para até 100 identificadores formatados de cada vez; use POST /api/v1/check para um único identificador. Ambos retornam os resultados na resposta HTTP da própria requisição, sem etapa de envio de tarefa, polling ou download. Em uma verificação de WhatsApp concluída, o data retornado contém service_type, identifier e registered; ws_avatar também inclui avatar e avatar_url, enquanto ws_business inclui business. Campos internos de registro, transação, status e cobrança não são retornados.

Gerenciando custos e resultados

As equipes podem usar o painel do WA Lookup para gerenciar chaves de API, revisar o histórico de verificações e acompanhar o saldo e o uso por produto. A requisição múltipla em si é executada de forma síncrona pela API, enquanto o painel oferece visibilidade sobre a conta e o uso. Contas novas também podem entrar em contato com o suporte para obter 100 verificações gratuitas e testar as verificações de registro, avatar e conta Business antes de processar arquivos CSV maiores.

Perguntas frequentes

Qual é a diferença entre ws, ws_avatar e ws_business?

O tipo de serviço ws retorna o status padrão de registro na plataforma. O tipo ws_avatar acrescenta a disponibilidade de avatar e um campo de URL do avatar, que fica vazio quando não há URL disponível. O tipo ws_business verifica o registro e identifica se o número está associado a uma conta do WhatsApp Business.

Posso verificar vários números em uma única requisição?

Sim. O endpoint múltiplo síncrono POST /api/v1/batch-check aceita até 100 identificadores e retorna os resultados concluídos na mesma resposta HTTP, sem etapa de envio de tarefa, polling ou download. Para uma lista inteira muito maior do que isso, também há uma tarefa em massa assíncrona (você escolhe o país ao qual os números pertencem no momento do envio, e a lista deve ser essencialmente desse único país), mas os endpoints síncronos continuam sendo a principal forma de verificação.

As verificações com falha são cobradas do meu saldo?

Verificações com falha, que excederam o tempo limite ou sem resultado determinado não mantêm a cobrança. Consulte a página de preços para ver os detalhes de cobrança atuais.