Consulta em tempo real da foto de perfil do WhatsApp de qualquer número

A verificação de foto de perfil do WA Lookup recebe um número de telefone e retorna, na mesma resposta, se ele está cadastrado no WhatsApp e qual foto de perfil pública ele usa — sem salvar o contato nem abrir o WhatsApp.

No aplicativo do WhatsApp, normalmente você só vê a foto de perfil de alguém depois de salvar o número, e apenas se as configurações de privacidade da pessoa permitirem. Em um fluxo de trabalho empresarial — um novo lead, um chamado de suporte, um contato de entrega — salvar cada número em um celular é lento e deixa contatos de que você não precisa.

A verificação de foto de perfil em tempo real (ws_avatar) responde diretamente à pergunta: este número está no WhatsApp e qual foto de perfil pública ele mostra agora? Este guia explica como ela funciona, o que retorna e os recursos que vêm junto.

Como funciona uma consulta de foto em tempo real

1. Envie um número em formato internacional, por exemplo +12345678900. O + é opcional; consulte a Recomendação ITU-T E.164.
2. O WA Lookup verifica o cadastro e a foto de perfil na mesma requisição.
3. Leia as duas respostas no mesmo retorno — sem fila, sem polling, sem callback.

Use onde for mais prático, com a mesma verificação e o mesmo saldo:

• A demonstração da página inicial — mude para Verificação de foto de perfil; não precisa de conta, com limite diário.
• O painel — abra Verificação em tempo real e selecione Verificação de foto de perfil do WhatsApp. A foto aparece ao lado do resultado.
• A API REST:

curl -X POST "https://walookup.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws_avatar", "identifier": "+12345678900" }'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_avatar",
    "identifier": "+12345678900",
    "registered": true,
    "avatar": true,
    "avatar_url": "<image url>"
  }
}

Como interpretar o resultado

avatar_url pode ser uma string vazia, então leia esse campo sempre junto com o indicador avatar. Uma verificação que não pode ser concluída retorna um code diferente de zero em vez de um resultado.

Por que alguns números cadastrados não mostram foto

Os usuários do WhatsApp escolhem quem pode ver a foto de perfil. Quando o usuário restringe a foto aos contatos, a oculta ou simplesmente não tem foto, não há uma foto pública para retornar, e o resultado é avatar: false mesmo que a conta esteja cadastrada. Por isso avatar: false nunca significa "não está no WhatsApp" — o cadastro é sempre informado separadamente em registered.

Recursos incluídos em toda consulta

Cadastro e foto em uma única requisição

Você não precisa fazer primeiro uma verificação de cadastro e depois uma consulta de foto. Uma única requisição retorna as duas informações, então uma só chamada basta para decidir o que fazer com o número.

Sem salvar contatos, sem login no WhatsApp

As verificações rodam na infraestrutura própria do WA Lookup. Você nunca salva o número em um celular, entra no WhatsApp, escaneia um QR code ou instala uma extensão. Sua própria conta do WhatsApp não é envolvida, então consultar fotos não a coloca em risco.

O dono do número não é notificado

A consulta não envia mensagem, ligação nem notificação para o número, e o dono não consegue ver que a foto dele foi consultada.

A mesma resposta no painel e na API

O painel, a API e o endpoint múltiplo síncrono (POST /api/v1/batch-check) executam a mesma verificação com um único saldo, então o que você vê nos testes é o que a sua integração recebe.

100 verificações grátis ao se cadastrar

Contas novas recebem 100 verificações grátis automaticamente, sem precisar resgatar nada. Como a verificação de foto de perfil custa mais por número do que a verificação de cadastro, o mesmo saldo grátis cobre menos verificações de foto; os preços atuais estão na página de preços. Uma consulta que não pode ser concluída não consome saldo.

Quando uma consulta de foto é útil

• Confirmar um novo lead. Uma foto que corresponde à empresa ou à pessoa do formulário dá mais segurança à equipe de vendas antes do primeiro contato de acompanhamento.
• Suporte e recuperação de conta. Um atendente pode comparar a foto do WhatsApp do cliente com o cadastro dele antes de tratar de assuntos da conta.
• Enriquecimento de CRM. Registrar se um contato tem foto pública — e a própria foto, quando sua política permitir — ajuda as equipes a reconhecer os contatos nas ferramentas que usam.

Trate a foto como contexto, não como prova: ela é escolhida pelo titular da conta e não comprova identidade, titularidade do número nem consentimento para contato. Para listas inteiras, há uma opção assíncrona de foto de perfil em massa disponível como complemento.

Use com proporcionalidade

Em muitas jurisdições, a foto de perfil é um dado pessoal. Segundo o artigo 5 do GDPR, colete apenas o que a sua finalidade exige: use a verificação de cadastro (ws) quando o status for suficiente, armazene fotos apenas quando a sua política de retenção permitir e nunca use consultas de foto para monitorar pessoas físicas. Antes de qualquer contato ativo, obtenha o consentimento prévio (opt-in), como exige a Política de Mensagens do WhatsApp Business.

Perguntas frequentes

Preciso salvar o número como contato para ver a foto?

Não. A verificação de foto de perfil funciona apenas com o número de telefone.

Por que a foto não aparece para um número que está no WhatsApp?

O usuário pode não ter foto ou pode tê-la restringido aos contatos. Nesse caso, o resultado mostra registered: true com avatar: false.

O dono do número fica sabendo que a foto dele foi consultada?

Não. A consulta não envia nada para o número.

Posso consultar fotos de vários números de uma vez?

Sim. Use Verificação múltipla no painel ou o endpoint múltiplo síncrono para conjuntos pequenos, e a opção de foto de perfil em massa para listas inteiras. Consulte a documentação da API para ver os limites atuais.

Saiba mais

Experimente a verificação de foto de perfil sem fazer login ou crie uma conta para ganhar 100 verificações grátis.

• Abrir a página de Verificação de foto de perfil do WhatsApp →
• Criar uma conta grátis →