Como o WA Lookup verifica um número do WhatsApp

Conclua uma verificação

Esta seção aborda as verificações em tempo real: o painel SaaS e os endpoints REST síncronos compartilham um único serviço de verificação e o mesmo significado de resposta. Listas muito grandes contam com uma opção em massa assíncrona, abordada no final desta página.

1. 1

   Envie um número

   Envie o número que precisa verificar, usando o formato exigido pela documentação da API.

2. 2

   Escolha um produto

   ws para registro, ws_avatar adiciona campos de foto de perfil, ws_business adiciona campos de conta Business. Para dias de atividade, a verificação em massa assíncrona tem um produto correspondente.

3. 3

   Leia o resultado

   Leia registered na mesma resposta. Faça uma nova verificação quando precisar de um status atualizado.

Qual formato de número enviar

O WA Lookup aceita um número por verificação, escrito no formato E.164: um sinal de mais, o código do país e, em seguida, o número do assinante, sem espaços ou pontuação — por exemplo +17253100591. É o mesmo formato que o aplicativo WhatsApp armazena internamente, portanto um número nesse formato corresponde a exatamente uma conta. Um número sem código do país não pode ser verificado com confiabilidade: os mesmos dígitos existem em muitos países.

• Sempre inclua o código do país; não dependa do país da sua própria conta.
• Remova espaços, hifens, parênteses e zeros iniciais usados na discagem nacional — mantenha apenas o + e os dígitos.
• Números no formato incorreto são rejeitados antes de qualquer cobrança; um formato rejeitado não é um resultado "não registrado".

O que significa registered?

registered é a resposta de uma verificação de WhatsApp. Ele só aparece em uma resposta bem-sucedida e é um booleano: true significa que o número está registrado no WhatsApp no momento da solicitação, false significa que não está. Qualquer outra coisa — tempo esgotado, resultado indeterminado, número inválido — volta como código de erro, e o WA Lookup reembolsa essa verificação automaticamente. Portanto, a ausência do campo registered nunca significa "não registrado"; significa que a verificação não produziu resultado. O valor reflete o momento da consulta: contas são criadas e excluídas o tempo todo, então atualize a verificação antes de agir com base em um resultado antigo, em vez de armazená-lo em cache por semanas.

• registered=true significa registrado.
• registered=false significa não registrado.
• Trate os demais desfechos de acordo com o código de resposta da API; não deduza registered por conta própria.

Escolha um produto conforme a necessidade

Escolha o menor produto em tempo real que responda à sua pergunta; a documentação da API traz as definições completas dos campos.

• ws retorna o status de registro.
• ws_avatar também retorna campos de foto de perfil; avatar_url é uma string vazia quando nenhuma foto está disponível.
• ws_business também retorna campos de conta Business.

Use o resultado dentro do seu escopo

Uma verificação reflete o status no momento da solicitação. Não é verificação de identidade nem permissão para contatar alguém.

• Não confirma quem é o titular do número, se ele está online neste momento nem qualquer conteúdo de mensagens; o produto de atividade em massa retorna os dias desde a última atividade, não a presença em tempo real.
• Um resultado registrado não estabelece consentimento para contatar o número.
• Faça uma nova verificação quando a decisão de negócio exigir um status atual.

Listas muito grandes: a opção assíncrona

A verificação múltipla do painel e o endpoint múltiplo da API atendem à maioria das listas. Somente quando uma lista excede em muito esses limites faz sentido enviar o arquivo inteiro como uma única tarefa em massa assíncrona — você escolhe o país ao qual a lista pertence, e ela deve ser essencialmente desse único país.

• Envie um .txt ou .csv com um número E.164 por linha, pela página de verificação em massa ou pela API.
• Escolha o país ao qual os números pertencem ao enviar; a lista deve ser essencialmente desse único país. Números demais de outros lugares fazem a tarefa falhar durante a preparação do arquivo — ela não é enviada para verificação e é reembolsada integralmente.
• O saldo é reservado para as linhas válidas no envio, você é cobrado apenas pelos números que retornam resultado e a diferença é reembolsada.
• A tarefa é executada em segundo plano; baixe o arquivo de resultado quando terminar. Uma tarefa com falha é reembolsada integralmente.