API de consulta de números vs. Verificação de WhatsApp: O que cada uma retorna

Uma comparação entre APIs genéricas de consulta de números de telefone e verificações de registro no WhatsApp, com orientações sobre quando um fluxo de trabalho de limpeza de listas precisa de uma, da outra ou de ambas.

Uma API de consulta de números e uma verificação de WhatsApp respondem a perguntas diferentes sobre o mesmo número de telefone. Uma API de consulta de números descreve o número na rede telefônica, tipicamente seu formato, país, operadora e tipo de linha, como móvel, fixa ou VoIP. Uma verificação de registro no WhatsApp descreve uma única plataforma: se uma conta do WhatsApp estava presente naquele número no momento da consulta. Equipes que enviam SMS ou fazem chamadas precisam da consulta; equipes que decidem se devem usar o WhatsApp precisam da verificação de registro; fluxos de trabalho de limpeza de listas que roteiam através de vários canais geralmente executam ambos, nessa ordem.

API de consulta de números vs. Verificação de WhatsApp em resumo

Os resultados de pesquisa para este tópico tendem a mostrar páginas de fornecedores de consultas de operadora ou páginas de fornecedores de verificadores de WhatsApp, cada uma descrevendo apenas sua própria saída. A tabela abaixo coloca as duas lado a lado.

Nenhum dos resultados prova quem é o titular do número ou se a pessoa concordou em ser contatada. Ambos são entradas para uma decisão de roteamento, e ambos descrevem um momento no tempo.

O que uma API de consulta de números retorna

"Consulta de número" abrange várias camadas, e os fornecedores as agrupam de maneiras diferentes:

1. Validação de formato e plano de numeração. Um analisador como o libphonenumber verifica se um número tem um comprimento e prefixo válidos para sua região e o converte para E.164. Isso é executado offline e não precisa de consulta de rede.
2. Operadora e tipo de linha. Uma consulta de rede retorna a operadora atual e o tipo de linha. A Line Type Intelligence da Twilio, por exemplo, retorna um nome de operadora, códigos de país e rede móvel, e um tipo como móvel, fixo, VoIP fixo, VoIP não fixo ou gratuito.
3. Dados adicionais de risco ou portabilidade. Alguns fornecedores adicionam histórico de portabilidade, troca de SIM ou dados de números reatribuídos como produtos separados.

Esses resultados respondem a perguntas de telefonia. Um tipo de linha móvel sugere que o número geralmente pode receber SMS; um tipo de linha fixa geralmente não pode. Uma consulta de operadora não informa se o número possui uma conta no WhatsApp ou em qualquer outro aplicativo, porque isso não é um dado de operadora.

O que uma verificação de registro no WhatsApp retorna

Uma verificação de WhatsApp faz a pergunta específica da plataforma diretamente. No WA Lookup, a verificação em tempo real recebe um número no formato E.164 e retorna o resultado na mesma resposta; o valor service_type seleciona qual sinal você obtém.

ws: registro

Se uma conta do WhatsApp estava registrada no número no momento da consulta. Este é o sinal principal de alcançabilidade para a seleção de canal.

ws_avatar: registro mais disponibilidade de foto de perfil

Adiciona se uma foto de perfil está disponível e um link para ela quando presente. Uma foto de perfil ausente não significa que o número não está registrado.

ws_business: registro mais tipo de conta comercial

Adiciona se a conta é uma conta WhatsApp Business. Ela descreve o tipo de conta, não uma empresa legal verificada.

A verificação está disponível como uma solicitação de API de número único, como uma solicitação múltipla síncrona de até 100 números, no painel de controle e através de um servidor MCP para clientes de IA. Uma verificação que não pode ser decidida retorna um código de negócio diferente de zero e deve ser tentada novamente, não armazenada como Não registrado.

Quando usar uma API de consulta de números, uma verificação de WhatsApp ou ambas

Combine a ferramenta com a decisão que seu fluxo de trabalho está tomando:

Dois padrões causam a maior parte do desperdício de gastos. O primeiro é executar consultas de operadora em contatos que só serão contatados pelo WhatsApp, onde o tipo de linha não altera a decisão. O segundo é usar um tipo de linha como um proxy para o WhatsApp: um número móvel pode ou não ter uma conta, e um número listado como VoIP ou fixo ainda pode estar registrado no WhatsApp, portanto, a verificação de registro é a única resposta direta.

Um fluxo de trabalho de limpeza de listas que combina ambos

Para uma lista mista que será roteada através de canais, esta ordem mantém cada etapa barata e significativa:

1. Normalize e valide o formato offline. Converta cada número para E.164 com uma biblioteca de plano de numeração e remova duplicatas. Números que falham na análise vão para revisão; eles não valem uma consulta paga.
2. Execute a verificação de registro no WhatsApp nos números restantes. Use verificações em tempo real para pequenos conjuntos, até 100 números por solicitação de API síncrona para importações, ou a Verificação em Lote em Tempo Real colada no painel. Para arquivos muito grandes, tarefas em lote assíncronas aceitam um upload de TXT ou CSV e retornam um arquivo de resultado para download, com limites por produto listados na documentação.
3. Execute uma consulta de operadora e tipo de linha apenas onde o SMS ou voz for o canal planejado, por exemplo, contatos que não estão registrados no WhatsApp, mas receberão um fallback de SMS.
4. Armazene cada resultado em seu próprio campo com sua fonte e data de verificação: tipo de linha e operadora da consulta, registro e sinais opcionais de foto de perfil ou conta comercial da verificação de WhatsApp.
5. Mantenha resultados indeterminados separados e tente-os novamente, em vez de mesclá-los em qualquer um dos grupos.

Manter os campos separados permite que os analistas vejam por que um contato foi para um determinado canal e permite que cada sinal seja atualizado em seu próprio cronograma.

Avaliando fornecedores para cada etapa

Ao comparar fornecedores, faça perguntas específicas para cada categoria em vez de uma lista de verificação genérica.

Para uma API de consulta de números: quais pacotes de dados são produtos separados, como os tipos de linha são definidos, quais países têm cobertura de operadora e se existem solicitações em lote ou se cada número é uma solicitação.

Para uma verificação de WhatsApp: se os resultados retornam na mesma resposta ou através de um fluxo de trabalho de tarefas, como as verificações indeterminadas são relatadas, se as respostas de registrado e não registrado são cobradas, quais regiões são suportadas para quais caminhos e se o serviço depende da sua própria sessão de WhatsApp. O WA Lookup, por exemplo, suporta números da China continental, Hong Kong e Macau em verificações únicas em tempo real de pequeno volume, enquanto suas tarefas de arquivo em lote não aceitam essas regiões.

Em ambas as categorias, leia a documentação atual para controles de uso e tratamento de dados em vez de confiar em páginas de marketing, e mantenha os registros de opt-in independentes de qualquer resultado de consulta.

Perguntas frequentes

Como as equipes podem saber se um número tem WhatsApp a partir de uma consulta de operadora?

Elas não podem diretamente. Dados de operadora e tipo de linha descrevem a rede telefônica, não contas de aplicativos. Uma verificação de registro no WhatsApp é a maneira direta de obter esse sinal.

Quando uma equipe precisa de uma API de consulta de números e de uma verificação de WhatsApp?

Quando os contatos são roteados através de canais, por exemplo, WhatsApp primeiro com um fallback de SMS. A verificação de WhatsApp informa o primeiro canal e a consulta de tipo de linha informa o fallback.

Como os dois resultados devem ser armazenados em um CRM?

Em campos separados, cada um com sua fonte e data de verificação, para que qualquer sinal possa ser atualizado independentemente e os analistas possam rastrear as decisões de roteamento.

Qual etapa deve ser executada primeiro em um fluxo de trabalho de limpeza de listas?

Normalização de formato offline e desduplicação primeiro, depois a verificação de registro, e então consultas de operadora e tipo de linha apenas para contatos planejados para SMS ou voz.

Saiba mais

Escolha as informações do produto que se encaixam na próxima etapa do seu fluxo de trabalho.

• Ver a documentação do produto →
• Falar com a equipe →