Análise de foto de perfil do Telegram para listas de números de telefone
Saiba como funciona a análise de foto de perfil do Telegram por número de telefone como uma tarefa assíncrona em lote: preparação, consulta e leitura do CSV.
Um guia passo a passo sobre o produto de processamento em lote de números de telefone do Telegram, explicando por que não há verificação em tempo real e como preparar, executar e ler uma tarefa.
Para analisar uma foto de perfil do Telegram por número de telefone, envie uma lista preparada para o produto de processamento em lote de números de telefone do Telegram da AvatarLookup. A análise de foto de perfil do Telegram está disponível apenas como uma tarefa assíncrona em lote, portanto, não existe verificação única em tempo real. Você envia um arquivo TXT ou CSV com um número com código de país por linha, acompanha a tarefa até que ela seja concluída e baixa um arquivo CSV. Os resultados descrevem apenas fotos de perfil públicas e não mostram quem é o proprietário de uma conta.
Por que a análise de foto de perfil do Telegram é apenas em lote
Buscas por uma foto de perfil do Telegram por número de telefone geralmente pressupõem que uma consulta funciona como uma busca de contatos: digite um número, veja um rosto. O Telegram não funciona dessa maneira. Ele trata o número de telefone e a foto do perfil como configurações de privacidade separadas. Em Privacidade e Segurança, cada pessoa escolhe quem pode ver seu número e quem pode ver sua foto, com opções como todos, apenas contatos ou ninguém, e o FAQ oficial do Telegram descreve esses controles. Portanto, uma foto só é visível quando seu proprietário permitiu.
No catálogo da AvatarLookup, a análise de números de telefone do Telegram existe como um único produto: a tarefa assíncrona em lote. Não há verificação do Telegram em tempo real, seja única ou múltipla, portanto, as equipes não devem planejar uma integração que espere uma resposta instantânea para um único número. Verificações em tempo real e síncronas múltiplas são documentadas apenas para WhatsApp e para endereços de e-mail suportados do Gmail, Yandex e Mail.ru.
Este design atende ao caso de uso típico do Telegram, que é revisar uma lista em vez de consultar um indivíduo. Uma equipe de operações de marketing pode ter dezenas de milhares de números de um banco de dados regional, e a questão é quantos deles apresentam uma foto pública e que tipo de foto é essa. Uma tarefa que é executada em segundo plano e retorna um CSV atende bem a essa necessidade.
Preparando um arquivo de telefone com código de país
A preparação do arquivo decide se uma tarefa terá sucesso, portanto, dedique tempo a isso. O produto de números de telefone do Telegram espera um arquivo TXT ou CSV com um identificador por linha. XLSX e outros formatos de planilha não são aceitos, portanto, exporte sua planilha como CSV ou cole os números em um arquivo de texto simples.
Use esta lista de verificação:
- Escreva cada número como dígitos, incluindo o código do país, sem sinal de mais, espaços, traços ou colchetes.
- Escolha um país para a tarefa. A lista deve pertencer essencialmente a esse país, portanto, divida uma lista multinacional em um arquivo por país.
- Remova duplicatas, linhas em branco e linhas de cabeçalho.
- Confirme se o tamanho da lista está dentro do mínimo e máximo publicados do produto, que estão listados na documentação da API e na página de preços.
- Mantenha uma cópia da lista original para que você possa associar os resultados aos seus registros.
Ao enviar através da API, envie a tarefa para POST /api/v1/bulk-tasks. Em um envio multipart, o campo do país deve vir antes do campo do arquivo, o que é fácil de errar quando uma biblioteca cliente reordena as partes do formulário. Uma tarefa para números de telefone não aceita números +86, +852 ou +853, porque essas regiões estão disponíveis apenas através de verificações de número único em tempo real, e essas verificações não cobrem o Telegram.
Executando a tarefa e baixando o CSV
Uma tarefa em lote é assíncrona. O envio do arquivo retorna uma tarefa que você pode acompanhar, e você verifica seu progresso com GET /api/v1/bulk-tasks/{id}. O serviço não documenta um tempo de conclusão fixo, portanto, planeje com base no status, não em um relógio.
Siga estas regras operacionais:
- Não consulte com frequência superior a 30 segundos. Consultas mais rápidas aumentam a carga e não trazem benefícios.
- Quando o status mostrar sucesso, baixe o arquivo CSV único produzido para a tarefa.
- Os links de download duram 12 horas. Se um link expirar, consulte a mesma tarefa novamente para atualizá-lo.
- Armazene o CSV em seu próprio sistema prontamente, com a data e o arquivo que você enviou.
Antes de iniciar uma execução grande, teste com um arquivo pequeno próximo ao mínimo do produto para que você possa confirmar se sua formatação, escolha de país e importação posterior funcionam. Corrigir um problema de cabeçalho em um arquivo pequeno é mais barato do que descobri-lo após uma lista completa ter sido processada. Fique de olho no saldo da conta através de GET /api/v1/balance para que uma execução longa não pare por falta de crédito.
Lendo o CSV do Telegram sem sobreinterpretação
O CSV de números de telefone do Telegram tem suas próprias colunas, e não se deve presumir que correspondam a outro produto. Arquivos em lote do Viber, MAX, LINE, Zalo e e-mail retornam seus próprios campos, portanto, escreva um mapeamento de importação separado por produto em vez de um esquema compartilhado. Leia a lista de colunas na documentação da API antes de criar o mapeamento.
As regras de interpretação importam mais do que as colunas:
- Uma linha com uma foto pública significa que um avatar público foi analisado. Atributos de aparência, quando presentes, são estimativas algorítmicas, não fatos demográficos.
- Uma linha sem foto significa que nenhum avatar público estava disponível. Isso pode refletir a configuração de privacidade de foto do proprietário e não é evidência de que o número não possui uma conta no Telegram.
- Uma linha Indeterminado significa que a verificação não chegou a uma conclusão. Nenhum dos resultados mostra que uma conta não existe.
- Linhas concluídas são faturáveis mesmo quando a resposta é negativa.
Use o resultado como uma entrada para a revisão de contatos, por exemplo, para separar registros que mostram um retrato daqueles com um logotipo, ou para priorizar a verificação manual. Não é uma verificação de identidade e não prova quem controla uma conta. Um produto em lote de nome de usuário do Telegram separado também existe para listas de nomes de usuário, que podem ser fornecidos como um nome de usuário simples, @nome de usuário ou formato de link do Telegram. Use-o quando sua fonte contiver nomes de usuário em vez de números, e mantenha seus resultados em sua própria tabela.
FAQ
Existe uma verificação de foto de perfil do Telegram em tempo real para um único número?
Não. A análise de foto de perfil do Telegram é documentada apenas como produtos assíncronos em lote, um para números de telefone e outro para nomes de usuário. Verificações únicas em tempo real e múltiplas síncronas cobrem apenas WhatsApp e e-mails suportados do Gmail, Yandex e Mail.ru, portanto, os fluxos de trabalho do Telegram devem ser projetados em torno de um arquivo e uma tarefa.
Qual formato de arquivo o produto de números de telefone do Telegram aceita?
TXT ou CSV com um identificador por linha. Os números são escritos como dígitos com código de país sem sinal de mais, e um país é escolhido para a tarefa. Uploads de XLSX não são suportados, portanto, as planilhas devem ser exportadas para CSV primeiro.
Uma foto ausente significa que o número não tem uma conta no Telegram?
Não. Uma foto ausente pode refletir a configuração de privacidade do proprietário ou a falta de uma foto. Como as equipes podem tratar essas linhas? Mantenha-as como resultados Sem foto de perfil ou Indeterminado e evite tirar conclusões sobre a existência de uma conta.
Números do Telegram de Hong Kong ou Macau podem ser incluídos?
Tarefas em lote não suportam números +852, +853 ou +86, que são limitados a verificações de número único em tempo real, e essas verificações não cobrem o Telegram. O suporte para Taiwan (+886) não está confirmado, portanto, as equipes devem verificar a documentação atual antes de incluir tais números.
Saiba mais
Escolha as informações do produto que se ajustam ao próximo passo em seu fluxo de trabalho.