Verificador de ID de usuário do Telegram: Obtendo valores de uid para uma lista de telefones ou nomes de usuário

Três serviços em lote do TG Validator retornam uma coluna uid que as equipes podem armazenar como uma chave estável ao lado de números de telefone ou nomes de usuário.

Um ID de usuário do Telegram é a chave numérica que o Telegram usa internamente para uma conta, e a maioria das recomendações de "telegram id checker" aponta para bots de consulta que leem esse valor a partir de uma única mensagem encaminhada. Para uma lista completa, o TG Validator retorna uma coluna uid em três serviços de processamento em lote assíncronos: tg_active_batch e tg_profile_batch para arquivos de números de telefone, e tg_username_profile_batch para arquivos de nomes de usuário. O uid funciona como uma chave estável para deduplicar e reconciliar seus próprios registros.

O que é um ID de usuário do Telegram e de onde vêm as recomendações comuns

Toda conta do Telegram possui um ID de usuário numérico. Diferente de um nome de usuário, que o proprietário pode alterar ou remover, o número permanece vinculado à conta, razão pela qual desenvolvedores e administradores de CRM preferem armazená-lo.

As recomendações comuns de busca para "encontrar ID de usuário do Telegram" dividem-se em três grupos:

• Bots de consulta. Você encaminha uma mensagem ou abre um perfil dentro do Telegram e um bot responde com o número. Isso é adequado para uma pessoa com quem você já está conversando.
• Scripts auto-hospedados. Projetos de código aberto, por exemplo, o Telegram ID Finder Bot, executam um bot que você mesmo hospeda e informam IDs de usuários, grupos e canais.
• Scripts de números de telefone. Ferramentas no estilo do telegram-phone-number-checker da Bellingcat usam suas próprias credenciais da API do Telegram para consultar um número e podem retornar um nome de usuário e ID quando a conta permite.

Todos os três são estruturados em torno de uma pessoa em um teclado ou um desenvolvedor executando código sob uma conta pessoal do Telegram. Nenhum deles é um fluxo de trabalho para listas: você não pode fornecer a eles alguns milhares de linhas e receber um arquivo de volta com os resultados em ordem.

Quais serviços do TG Validator retornam um uid

Uma verificação orientada a listas ocorre nos serviços em lote. Três dos cinco tipos assíncronos incluem uma coluna uid:

O serviço tg em tempo real, usado pela verificação de API de número único e pelas abas de tempo real do painel, informa apenas o status de registro e não retorna um uid. Se você precisar da chave, mova a lista para uma tarefa em lote.

Linhas onde o serviço não tem nada a relatar mantêm seu lugar no arquivo, com colunas opcionais vazias. Planeje sua importação para que um uid vazio seja uma linha normal, não uma falha.

Obtendo uids para uma lista passo a passo

1. Escolha o serviço que corresponde à sua entrada. Números de telefone vão para tg_active_batch ou tg_profile_batch; nomes de usuário vão para tg_username_profile_batch. Escolha tg_profile_batch apenas se você também desejar as estimativas baseadas no avatar, pois o tg_active_batch, que é mais leve, já retorna o uid.
2. Prepare o arquivo. Use TXT ou CSV com uma entrada por linha. Para números de telefone, use números internacionais e mantenha o arquivo essencialmente em um país selecionado, uma vez que tarefas em lote de números de telefone exigem um país e arquivos com uma parcela substancial de outros códigos de país são rejeitados. Números da China continental, Hong Kong e Macau não são suportados em tarefas em lote. Nomes de usuário não precisam de país e podem incluir ou omitir o @.
3. Envie a tarefa através da área de Verificação em Lote do painel ou via POST /api/v1/bulk-tasks, autenticando-se com seu cabeçalho X-API-Key e nunca colando uma chave real em documentos compartilhados.
4. Verifique a conclusão com GET /api/v1/bulk-tasks/{id}, não mais do que a cada 30 segundos. O status é processing, success ou failed.
5. Baixe o result.csv e junte-o à sua lista de origem na coluna de identificador, que ecoa cada entrada original.

O saldo para a tarefa é reservado no envio, cobrado pelas entradas que retornaram resultados, e a reserva não utilizada é liberada na conclusão. Uma tarefa com falha libera sua reserva total. Verifique a página de preços atual e a documentação da API para as taxas e limites por tarefa que se aplicam ao serviço escolhido.

Usando o uid como uma chave estável

Uma vez que a coluna esteja em seu CRM ou banco de dados, o uid ajuda na higiene dos dados, e não em qualquer informação sobre a pessoa.

Deduplicação entre fontes. A mesma conta pode chegar como um número de telefone de um formulário, um nome de usuário de uma exportação de comunidade e um nome de usuário novamente após uma renomeação. Se ambas as linhas retornarem o mesmo uid, elas apontam para uma única conta, e você pode mesclá-las em um registro.

Sobrevivência a mudanças de nome de usuário. Armazene o uid ao lado do nome de usuário que você coletou. Quando um identificador mudar posteriormente, você ainda corresponderá ao registro pelo uid em vez de criar uma duplicata.

Criação de uma coluna de junção para exportações. Muitas ferramentas internas lidam melhor com chaves numéricas do que com identificadores de texto livre. Uma coluna uid torna mais fácil criar junções entre uma tabela de contatos e uma tabela de campanhas.

Mantenha-o separado de campos de identidade. Não armazene o uid em um campo rotulado como "usuário verificado" ou use-o para afirmar que você sabe quem é um contato. É uma chave técnica, e o sinal de registro por trás dela descreve a presença da conta no momento da verificação.

Uma nota breve sobre governança: decida com antecedência quem pode ver a coluna, por quanto tempo você a manterá e se o seu aviso de privacidade a abrange. Essas escolhas pertencem à sua equipe e à sua jurisdição, não ao verificador.

O que o uid não fornece

A coluna tem uma função restrita, e os limites ajudam você a evitar erros na forma como a utiliza.

• Ele não revela um número de telefone a partir de um nome de usuário, ou o inverso, a menos que o mesmo serviço de arquivo já o relate.
• Ele não expõe chats privados, participação em grupos ou listas de contatos.
• Ele não mostra quem está online. O valor activedays, onde presente em um resultado em lote, é o número aproximado de dias desde a última atividade e não é uma presença em tempo real.
• Valores de idade, gênero e cor de pele baseados em avatar no tg_profile_batch são estimativas produzidas a partir da imagem, não fatos verificados sobre uma pessoa.

Se você precisar consultar um único ID dentro do Telegram enquanto conversa com alguém, um bot de consulta é mais simples. Se você precisar de uma chave consistente em milhares de linhas, os serviços em lote fornecem um arquivo e um processo para documentar.

Perguntas frequentes

Quais serviços do TG Validator retornam um uid?

tg_active_batch e tg_profile_batch retornam o uid para arquivos de números de telefone, e tg_username_profile_batch retorna o uid para arquivos de nomes de usuário. O serviço tg em tempo real, tg_batch e tg_username_batch não incluem um uid.

Como as equipes podem usar um uid em um CRM?

As equipes o armazenam ao lado do número de telefone ou nome de usuário como uma chave estável. Isso ajuda a mesclar registros duplicados e manter a correspondência após uma mudança de nome de usuário.

Um uid pode ser encontrado para uma lista de nomes de usuário sem um número de telefone?

Sim. O tg_username_profile_batch aceita nomes de usuário, com ou sem @, não precisa de país e retorna o uid juntamente com activedays e uma URL de avatar.

Como as equipes devem lidar com células de uid vazias?

Trate uma célula vazia como um resultado normal para colunas opcionais. Mantenha a linha, marque-a para sua própria regra de revisão e evite tratá-la como uma importação com falha.

A verificação em tempo real retorna um uid?

Não. O serviço tg em tempo real retorna o status de registro para um número no formato ITU-T Recommendation E.164. Mova a lista para um serviço em lote quando o uid for necessário.

Saiba mais

Escolha as informações do produto que se ajustam ao próximo passo em seu fluxo de trabalho.

• Ver a documentação do produto →
• Falar com a equipe →