Resolvendo LIDs do WhatsApp para números de telefone: um guia para a integridade dos dados do CRM

Saiba como usar a API do WA Lookup para resolver LIDs do WhatsApp para números de telefone. Verifique de forma síncrona os sinais de registro, disponibilidade do avatar e conta comercial para apoiar a integridade dos dados do CRM.

Para verificar o registro no WhatsApp e apoiar fluxos de resolução de LID do WhatsApp para número de telefone, use a API REST do WA Lookup. Ao enviar um número de telefone no formato E.164 ao endpoint POST /api/v1/check com um service_type especificado (ws, ws_avatar ou ws_business), você recebe uma resposta JSON síncrona que confirma o sinal de presença de conta. Esse processo ajuda as equipes a manter dados de contato limpos e orienta a segmentação do CRM em tempo real.

Por que a verificação do WhatsApp é importante para os dados do CRM

Manter dados precisos no CRM exige verificar quais números de telefone estão associados a plataformas específicas. Quando as equipes integram fluxos de resolução de LID do WhatsApp para número de telefone, elas dependem de sinais precisos de presença de conta para segmentar públicos e encaminhar registros de forma adequada. Validar os números antes de iniciar o contato ajuda os administradores de CRM a avaliar a qualidade dos dados e priorizar as listas de contatos. Um resultado registrado confirma que o número enviado tem presença de conta no WhatsApp no momento da verificação. Esse sinal apoia decisões internas e pode ser uma entrada, ao lado de outras verificações, para manter a higiene dos dados. Ele fornece um dado básico que orienta operações mais amplas de dados do CRM.

Entendendo os produtos de verificação do WA Lookup

O WA Lookup oferece três produtos de verificação distintos por meio de um único endpoint síncrono. O parâmetro service_type da sua requisição controla quais campos são retornados e qual custo de saldo se aplica.

WhatsApp Checker (ws)

Essa verificação confirma se um número de telefone enviado está registrado no WhatsApp. Ela retorna apenas o campo registered, fornecendo um sinal direto de presença de conta para a validação básica de dados.

WhatsApp Avatar Checker (ws_avatar)

Além do sinal de registro, essa verificação apoia o enriquecimento de perfis ao retornar um booleano avatar e uma string avatar_url. O campo de URL fica vazio quando não há URL disponível e, quando preenchido, pode ser usado para enriquecer os registros de contato do CRM.

WhatsApp Business Checker (ws_business): conta comercial

Essa verificação confirma o registro e identifica se a conta usa o WhatsApp Business, retornando um booleano business. Isso ajuda as equipes a separar contatos B2B de contas de consumidores comuns durante a fase de ingestão de dados.

Integrando a API do WA Lookup

Integrar a API do WA Lookup ao seu CRM ou pipeline de dados exige uma requisição HTTP simples. A plataforma usa uma arquitetura de API síncrona, ou seja, o resultado é devolvido na mesma resposta HTTP da requisição inicial, em vez de ser entregue de forma assíncrona. Para fazer uma verificação, envie uma requisição ao endpoint POST /api/v1/check. A requisição deve incluir o cabeçalho X-API-Key para autenticação e um cabeçalho Content-Type: application/json. O corpo JSON exige dois campos:

• service_type: defina como ws, ws_avatar ou ws_business.
• identifier: o número de telefone enviado, que deve estar formatado de acordo com o plano internacional de numeração E.164.

O formato E.164 padroniza os números de telefone para discagem global, normalmente incluindo um sinal de mais (+) seguido do código do país, do código de área e do número local do assinante. Enviar os números estritamente no formato E.164 é obrigatório para que a API do WA Lookup processe a requisição com precisão. Para uma verificação do 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.

Encaminhando registros com base em sinais de presença de conta

Depois que a API síncrona devolve o sinal de presença de conta, as equipes de operações de dados podem usar a resposta JSON para orientar o roteamento posterior. Por exemplo, se um CRM importa uma nova lista de leads, o sistema pode consultar automaticamente o endpoint POST /api/v1/check. Os números que retornam status registered positivo podem ser marcados para campanhas de contato específicas, enquanto os números não registrados podem ser encaminhados para canais de comunicação alternativos. Ao usar o tipo de serviço ws_business, o fluxo pode se ramificar ainda mais. Identificar uma conta do WhatsApp Business ajuda as equipes a separar contatos B2B de contas de consumidores comuns, favorecendo estratégias de comunicação mais personalizadas. Da mesma forma, a verificação ws_avatar pode enriquecer o contexto visual de um perfil do CRM ao anexar a avatar_url ao registro do contato. Ao integrar essas verificações diretamente à fase de ingestão de dados, as organizações reduzem o tempo de revisão manual e mantêm um padrão mais alto de higiene de dados em suas plataformas.

Gerenciando custos e relatórios do painel

Verificações com falha, com timeout e indeterminadas não mantêm a cobrança. Consulte a página de preços para ver os detalhes de cobrança atuais. Contas novas 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 ampliar seus fluxos. O painel do WA Lookup oferece ferramentas completas para gerenciar sua integração. Os administradores podem usar o painel para gerenciar chaves de API e monitorar o saldo disponível. A interface também oferece histórico detalhado de verificações, relatórios por produto e visualização das verificações recentes. Para ajudar as equipes a acompanhar o uso ao longo do tempo, o painel exibe o consumo de saldo e a atividade da conta. Os relatórios por produto permitem que as equipes de operações separem o uso das verificações ws, ws_avatar e ws_business, dando visibilidade sobre o consumo da API e as atividades de enriquecimento de dados do CRM.

Perguntas frequentes

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

Os três usam o mesmo endpoint síncrono, mas retornam campos diferentes de acordo com o service_type. A verificação ws retorna o status de registro. A verificação ws_avatar acrescenta a disponibilidade do avatar e um campo de URL do avatar, que fica vazio quando não há URL disponível. A verificação ws_business acrescenta um booleano que indica se a conta usa o WhatsApp Business.

O WA Lookup verifica se um usuário está online no momento?

Não. Um resultado registrado informa os campos de status do WhatsApp disponíveis no momento da verificação. Ele funciona como um sinal de presença de conta e não informa presença ao vivo, histórico de mensagens, consentimento do contato nem se o número pode ser contatado.

Como as requisições à API com falha são tratadas em termos de cobrança?

Verificações com falha, com timeout e indeterminadas não mantêm a cobrança. Consulte a página de preços para ver os detalhes de cobrança atuais.