Verificador de foto de perfil do WhatsApp para vários números: Escolhendo entre Multi ou em lote

Como analisar fotos de perfil públicas do WhatsApp para vários números de uma só vez, desde a preparação da lista até a leitura de resultados ordenados e saída CSV em lote.

Um verificador de foto de perfil do WhatsApp para vários números analisa a foto de perfil pública associada a cada número em uma lista e retorna os resultados em conjunto. No AvatarLookup, existem duas rotas. A verificação multi síncrona aceita de 1 a 100 números do WhatsApp por solicitação de API e retorna os resultados na mesma ordem, enquanto o painel aceita até 500 números e os processa um por um. Para listas maiores, o produto em lote do WhatsApp assíncrono aceita um arquivo TXT ou CSV e retorna um CSV por tarefa. Em ambas as rotas, um resultado produzido indica que a análise foi realizada, não que a conta existe.

O que um verificador de foto de perfil do WhatsApp para vários números deve fazer

Ao pesquisar sobre este tópico, a maioria das ferramentas acaba sendo verificadores de números: eles informam se um número aparece no WhatsApp e param por aí. Outras são extensões de navegador que controlam o WhatsApp Web através da sua própria conta, o que levanta questões sobre permissões e segurança da conta. Poucas explicam o que fazer com a imagem em si.

Uma verificação de foto de perfil no AvatarLookup é uma análise de foto de perfil. Para cada número, o serviço analisa o avatar público do WhatsApp e retorna campos de avatar público específicos da fonte, além de estimativas de aparência, como o tipo de imagem, para que uma equipe de dados de contato possa ver quais registros possuem um retrato, um logotipo, uma ilustração ou nenhuma imagem pública.

A visibilidade depende do proprietário da conta. As configurações de privacidade do WhatsApp permitem que cada usuário mostre a foto do perfil para todos, apenas para contatos, para contatos com exceções ou para ninguém. Uma verificação reflete apenas o que é público no momento em que é executada, portanto, uma imagem ausente é uma declaração sobre a visibilidade pública, não sobre a conta.

Escolhendo uma rota pelo tamanho da lista

A verificação multi é a escolha certa quando um fluxo de trabalho precisa de respostas dentro da mesma solicitação, como em uma tela de revisão ou um trabalho noturno que processa alguns milhares de números em fatias de 100. Cada solicitação deve conter um tipo de serviço, portanto, não misture números do WhatsApp com endereços de e-mail na mesma chamada.

Mude para o produto em lote quando a lista for grande o suficiente para que dividi-la em muitas chamadas síncronas se torne difícil de agendar e repetir. As tarefas em lote possuem seus próprios limites por produto, listados na documentação da API, portanto, verifique os valores atuais antes de planejar uma execução.

Números da China continental (+86), Hong Kong (+852) e Macau (+853) devem ser incluídos em verificações únicas em tempo real, em vez de arquivos em lote.

Preparando a lista de números

Uma entrada limpa é a melhoria mais barata para qualquer verificação de vários números. Antes de enviar qualquer coisa:

1. Normalize cada número para a forma internacional com seu código de país e remova espaços, colchetes, traços e notas de extensão.
2. Remova duplicatas após a normalização, já que o mesmo número geralmente aparece em vários formatos.
3. Mantenha sua própria chave de registro ao lado de cada número para que os resultados ordenados possam ser unidos sem suposições.
4. Divida por rota: até 100 números por solicitação multi da API ou um único arquivo para uma tarefa em lote.

Arquivos em lote possuem regras mais rígidas. Use TXT ou CSV com um número por linha, escrito como dígitos com código de país sem sinal de mais ou espaços. Selecione um país para a tarefa; a lista deve ser essencialmente daquele país. Em um envio de lote multipart, o campo de país deve vir antes do campo de arquivo. Formatos de planilha como XLSX não são aceitos, portanto, exporte para CSV primeiro.

Mantenha uma cópia do arquivo exato ou do corpo da solicitação que você enviou. Quando os resultados parecerem surpreendentes, a entrada é o primeiro lugar a se verificar.

Lendo resultados ordenados sem interpretá-los excessivamente

A verificação multi da API retorna resultados na mesma ordem da entrada, o que torna a junção direta: a posição um na resposta pertence à posição um na sua solicitação. Junte pela posição e, em seguida, confirme em relação à sua lista armazenada, em vez de reanalisar os números da resposta.

Cada item carrega um indicador de se um resultado foi produzido. Quando é positivo, a análise foi concluída para aquele número e os campos de avatar estão presentes. Isso não confirma que uma conta existe. Quando é negativo, o número era inválido, a verificação foi Indeterminado ou a verificação falhou. Isso não é um veredito de que a conta está ausente ou que não possui imagem.

Mantenha três resultados separados em seu modelo de dados:

• Foto de perfil analisada: uma imagem pública foi encontrada e descrita.
• Sem foto de perfil pública: a verificação foi concluída e nenhuma imagem pública estava disponível. Este é um resultado concluído e é faturável.
• Sem resultado: entrada inválida, Indeterminado ou falha. Verifique novamente a entrada e decida se deseja tentar novamente mais tarde.

As tarefas em lote produzem um CSV específico do WhatsApp. Leia seu cabeçalho e mapeie cada coluna explicitamente em vez de reutilizar um mapeamento escrito para outro produto.

Executando a rota em lote passo a passo

O produto em lote do WhatsApp é assíncrono, portanto, o fluxo de trabalho tem quatro estágios:

1. Envie o arquivo preparado e o país para POST /api/v1/bulk-tasks. A resposta fornece uma tarefa que você pode consultar.
2. Consulte GET /api/v1/bulk-tasks/{id} com um intervalo de no mínimo 30 segundos. Um intervalo mais lento é aceitável para arquivos grandes; nenhum tempo de conclusão fixo é prometido.
3. Baixe o arquivo CSV único quando a tarefa for concluída com sucesso. Os links de download duram 12 horas; se um expirar, consulte a mesma tarefa novamente para obter um novo link.
4. Carregue e reconcilie o CSV com sua lista de origem, registrando a data da análise em cada linha.

Os usuários do painel seguem a mesma ideia sem código: carregue o arquivo, aguarde a conclusão da tarefa e baixe o CSV. Independentemente da rota que você usar, armazene as saídas de aparência como estimativas algorítmicas e trate os dados de avatar público como um sinal de qualidade de dados de contato, não como verificação de identidade.

FAQ

Como as equipes podem processar uma lista de 5.000 números com a verificação multi?

Divida a lista em solicitações de até 100 números, envie-as em sequência ou com paralelismo moderado e junte cada resposta ordenada pela posição. Armazene uma referência de solicitação e um carimbo de data/hora com cada fatia para que as fatias com falha possam ser reenviadas individualmente. Se o trabalho crescer ou se tornar uma exportação regular, mova-o para o produto em lote do WhatsApp, que lida com um único arquivo e retorna um CSV.

Com que frequência uma foto de perfil do WhatsApp deve ser verificada novamente?

As imagens mudam e as configurações de privacidade mudam, portanto, cada resultado é um instantâneo no momento da verificação. Verifique novamente quando um registro estiver prestes a ser usado para uma revisão, quando a imagem for importante para uma decisão ou em um cronograma que corresponda à rapidez com que seus dados de contato envelhecem. Mantenha os resultados anteriores com suas datas em vez de substituí-los, para que os revisores possam ver o que mudou e quando.

Endereços de e-mail podem ser incluídos na mesma solicitação multi?

Não. Cada solicitação multi da API carrega um tipo de serviço. Endereços Gmail, Yandex e Mail.ru suportados usam a rota de foto de perfil de e-mail, portanto, divida listas mistas por tipo de identificador primeiro e envie números do WhatsApp e endereços de e-mail em solicitações separadas. A mesma separação se aplica a arquivos em lote, onde cada tarefa pertence a um produto em lote específico.

Saiba mais

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

• Visite o site do produto →