Validação de Número e Consulta de Perfil do WhatsApp APIs
API de validação do WhatsApp: verifique se um número está no WhatsApp e obtenha foto de perfil, status About, presença e detalhes comerciais. Verificação em tempo real em duas etapas e consulta de perfil público. API JSON para validação de leads, enriquecimento de contatos, CRM e entregabilidade de mensagens. Apenas dados públicos.
Verificar Existência (por Número Completo)
Verificação de existência leve para um único número — retorna apenas se o número de telefone está registrado no WhatsApp, sem buscar detalhes de perfil/avatar/comerciais. Mais barato do que uma consulta completa de perfil. Quando isExist=true, a resposta também contém um userHash que deve ser passado para os endpoints de perfil (Obter Avatar / Obter About / Obter Perfil Comercial / Obter Presença) para autorizar a consulta mais pesada. O backend divide automaticamente o código do país a partir do número completo e devolve countryCode para que você possa conferir a divisão.
Verificar Existência (Código do País + Número Separados)
Igual à Verificação de Existência, mas o código do país e o número nacional são fornecidos como parâmetros separados. Use isto quando você já conhece o código do país e deseja ignorar a divisão automática do backend. Quando isExist=true, a resposta também contém um userHash para passar aos endpoints de perfil.
Obter Avatar (Foto de Perfil)
Obtenha a foto de perfil pública (DP) de um usuário do WhatsApp. Fluxo em duas etapas: primeiro chame um endpoint de verificação de existência para obter um userHash do número alvo, depois passe esse userHash aqui. Chamadas sem um userHash válido (ou expirado/desconhecido) são rejeitadas. O número é resolvido a partir do userHash no servidor — nenhum parâmetro de número é aceito. Se o usuário não tiver foto ou a ocultar por privacidade, hasAvatar=false. Use type para escolher a imagem em tamanho original ou a miniatura de pré-visualização.
Obter Texto About / Status
Recupere o texto About (assinatura de status) do usuário e a hora em que foi definido. Fluxo em duas etapas: obtenha um userHash por meio de um endpoint de verificação de existência primeiro, depois passe-o aqui. userHash inválido/expirado é rejeitado. Não definido / privacidade (apenas contatos) / não registrado retorna about=null.
Obter Perfil Comercial
Recupere o perfil do WhatsApp Business: nome da empresa, nível de verificação, descrição, endereço, e-mail, site e informações de membro desde. Fluxo em duas etapas: obtenha um userHash por meio de um endpoint de verificação de existência primeiro, depois passe-o aqui. userHash inválido/expirado é rejeitado. Números pessoais (não comerciais) retornam isBusiness=false.
Obter Presença / Visto por Último
Recupere o estado online / visto por último. Fortemente restrito pela privacidade do alvo: se o solicitante não for um contato e a privacidade de visto por último/online do alvo não estiver definida como todos, a presença não é entregue e visible=false (um resultado real que não pode ser contornado). Fluxo em duas etapas: obtenha um userHash por meio de um endpoint de verificação de existência primeiro, depois passe-o aqui. Uma única chamada pode levar até cerca de 17s.
Verificar Status Ativo
Verifique em tempo real se um número de telefone está registrado e ativo no WhatsApp. Retorna um indicador de atividade direto para o número internacional completo — uma verificação independente que não requer um userHash. Ideal para validação rápida sim/não em fluxos de cadastro e higiene de listas.
Verificação em Lote (até 10 números)
Verifique se até 10 números de telefone estão registrados no WhatsApp em uma única requisição. Retorna o status exist e isBusiness para cada número. Forneça os números como uma lista separada por vírgulas. Eficiente para validar pequenos lotes em uma única chamada.