service_type ws_profile
Verifique se um número tem foto de perfil no WhatsApp, obtenha a URL da imagem e leia os atributos de retrato dessa foto.
POST /api/v1/checkAnálise de foto de perfil do WhatsAppNão é necessário entrar.
Contrato da API
Envie um número e selecione este produto com service_type. A autenticação usa sua chave de API.
Copie o comando curl abaixo e substitua apenas a chave de API de exemplo pela sua.
POST /api/v1/checkcurl -X POST "https://avatarlookup.com/api/v1/check" \
-H "X-API-Key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "service_type": "ws_profile", "identifier": "+17253100591" }'200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "ws_profile",
"identifier": "+17253100591",
"registered": true,
"avatar": true,
"avatar_url": "https://pps.whatsapp.net/v/example.jpg",
"category": "individual portrait",
"age": 39,
"gender": "male",
"skin_color": "white",
"hair_color": "brown"
}
}Como usar
Um número no formato E.164 (um sinal de mais, o código do país e depois o número) para o WhatsApp, ou um e-mail completo para o produto de e-mail.
registered indica se a conta existe (para um endereço de e-mail: se ele é alcançável), avatar indica se há foto de perfil definida e avatar_url traz a imagem. Os três voltam em toda consulta bem-sucedida.
avatar_url aponta para a CDN da própria plataforma e pode expirar no prazo definido por ela. Trate-a como uma referência: baixe ou armazene a imagem em cache se precisar guardá-la.
O que verifica
registered · boolean — Se o número está registrado no WhatsApp.avatar · boolean — Se há foto de perfil definida.avatar_url · string — URL da foto de perfil; string vazia quando nenhuma foto está definida.category · string — O que a imagem mostra: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar ou object. unknown quando não foi possível gerar um retrato.age · integer — Idade estimada como número inteiro, com precisão de cerca de 3 anos e limitada a 0-80. Omitida quando não foi possível estimá-la (por exemplo, quando nenhum gênero foi determinado).gender · string — male, female ou unknown.skin_color · string — Tom de pele descritivo, por exemplo white, east_asian ou hispanic. Trate-o como um conjunto aberto; unknown quando não determinado.hair_color · string — Cor do cabelo descritiva, por exemplo black, brown, blond ou gray white. Trate-a como um conjunto aberto; unknown quando não determinada.Ideal para
Adicione o estado da foto de perfil e a URL da imagem a listas de clientes, conversas de suporte ou agendas de contatos. Verifique se existe uma foto de perfil antes de carregá-la ou de exibir uma imagem padrão.
Grave a URL da foto de perfil retornada nos registros de contato existentes para que vendas, suporte e operações vejam o mesmo perfil de cliente, mais completo.
Inclua o estado de registro, o estado da foto de perfil e os atributos da imagem nas filas de revisão manual como sinal adicional de completude do registro.
Crie grupos a partir do registro, da presença de foto de perfil e dos resultados de perfil para organizar listas e planejar o trabalho posterior com os dados.
Resposta direta
Análise de foto de perfil do WhatsApp retorna se o número tem foto de perfil no WhatsApp e a URL da imagem quando houver. Use o service_type ws_profile (o parâmetro que seleciona um produto) com um número no formato E.164, por exemplo +17253100591, e leia os atributos do retrato no nível superior da mesma resposta da API.
Limites claros
Perguntas frequentes do produto
Ela verifica um identificador e retorna se o número tem foto de perfil no WhatsApp e a URL da imagem quando houver na mesma resposta síncrona.
O saldo é cobrado apenas por verificações concluídas. Verificações com falha ou indeterminadas não mantêm a cobrança.
Envie o identificador que o produto aceita: um número no formato E.164 para o WhatsApp, ou um e-mail completo para o produto de e-mail. O formato errado é rejeitado antes de qualquer cobrança.
Não. Ele apenas informa se há foto de perfil definida naquele momento. Não diz nada sobre se a conta está em uso ou online, e não é permissão para contatar ninguém. O consentimento e as regras aplicáveis continuam sendo sua responsabilidade.
Produtos relacionados
Análise de perfil por imagemEnvie qualquer imagem e receba seus atributos de retrato: idade estimada, gênero, tipo de imagem, cor do cabelo e tom de pele.
Análise de foto de perfil de e-mailVerifique se uma conta de e-mail tem foto de perfil e leia seus atributos de retrato. Cobre Gmail, Yandex e Mail.ru.Crie uma conta para usar todos os produtos pelo painel SaaS ou pela API: verificações em tempo real e verificações em massa assíncronas usam o mesmo saldo.