Verificações de nome de usuário no Telegram: existência da conta vs. disponibilidade do nome

Uma ferramenta de disponibilidade de nome de usuário pergunta se um identificador está livre para ser reivindicado, enquanto uma verificação de existência pergunta se uma lista de identificadores pertence a contas reais do Telegram.

Uma verificação de existência de nome de usuário no Telegram responde a uma pergunta diferente da verificação de nome de usuário comum. Ferramentas de disponibilidade informam se um identificador está livre para ser reivindicado; uma verificação de existência informa se um identificador em sua lista está vinculado a uma conta do Telegram hoje. Para trabalhos com listas, o TG Validator lida com a segunda pergunta com o serviço tg_username_batch, e o tg_username_profile_batch adiciona colunas de perfil extras para o mesmo tipo de arquivo. Ambos são executados como tarefas em lote assíncronas e retornam um arquivo result.csv para download.

Duas perguntas que compartilham uma mesma frase de busca

Os resultados de busca para "verificador de nome de usuário do Telegram" misturam duas tarefas que parecem semelhantes, mas não são.

A primeira tarefa é a disponibilidade. Alguém deseja um novo identificador para uma marca, canal ou bot e pergunta se ele pode ser registrado. O Telegram documenta isso como uma ação de usuário logado: o método oficial account.checkUsername valida um nome de usuário e informa se ele pode ser usado. Ferramentas de terceiros utilizam a mesma lógica, e algumas também analisam listagens de mercado para identificadores que estão reservados ou à venda.

A segunda tarefa é a existência. Uma equipe já possui uma lista de identificadores, coletados de formulários, notas de CRM, exportações de comunidades ou planilhas de parceiros, e deseja saber quais deles ainda apontam para uma conta real. A resposta orienta a limpeza da lista, não o registro de nomes.

As duas respostas podem até parecer invertidas. Um identificador que está "ocupado" em uma ferramenta de disponibilidade é o mesmo identificador que "existe" em uma verificação de existência. Um identificador que está "livre" é aquele que atualmente não resolve para uma conta. Se você executar o tipo errado de ferramenta, lerá o resultado ao contrário; portanto, decida qual pergunta você está fazendo antes de escolher uma ferramenta.

O que uma verificação de existência relata

Para arquivos de nomes de usuário, o TG Validator oferece dois serviços em lote assíncronos:

Nomes de usuário podem ser escritos com ou sem o @ inicial, portanto, uma planilha que mistura "@nome_exemplo" e "nome_exemplo" não precisa ser reescrita primeiro. Ao contrário das tarefas em lote de números de telefone, as tarefas de nomes de usuário não exigem que você escolha um país.

Duas notas de leitura mantêm a integridade do resultado. Primeiro, activedays, quando presente, é o número aproximado de dias desde a última atividade e pode ser uma estimativa quando o Telegram oculta informações exatas de "visto por último". Segundo, um resultado de existência descreve o estado do identificador no momento da verificação. Ele informa que o identificador resolve para uma conta; não descreve quem opera a conta ou como essa pessoa usa o Telegram.

Executando uma lista de nomes de usuário através de uma tarefa em lote

O fluxo de trabalho é o mesmo, independentemente de você usar o painel da Web ou a API REST.

1. Colete os identificadores em um arquivo TXT ou CSV com um nome de usuário por linha. Arquivos XLSX não são aceitos, portanto, exporte uma coluna simples da sua planilha.
2. Limpe o ruído óbvio. Remova linhas em branco, links t.me completos colados na célula e espaços extras. Mantenha duplicatas fora; um identificador verificado duas vezes são duas entradas para processar.
3. Escolha o serviço. Use tg_username_batch quando precisar apenas saber quais identificadores existem. Use tg_username_profile_batch quando sua regra de limpeza também precisar de uid, activedays ou da URL do avatar.
4. Envie a tarefa. Na API, isso é POST /api/v1/bulk-tasks. O saldo para a tarefa é reservado no envio e reconciliado na conclusão, com a parte não utilizada sendo liberada.
5. Verifique o status. GET /api/v1/bulk-tasks/{id} informa processing, success ou failed. Nenhum progresso por entrada é exposto, portanto, não verifique com frequência superior a uma vez a cada 30 segundos.
6. Baixe o result.csv quando a tarefa for concluída com sucesso. O arquivo usa uma coluna de identificador para sua entrada original e uma coluna activated para o resultado; colunas extras dependem do tipo de serviço e podem estar vazias.

Limites de tamanho por tarefa se aplicam a cada serviço, portanto, confirme os números atuais na documentação da API antes de planejar um arquivo muito grande, em vez de confiar em um número copiado de um artigo.

Transformando o resultado em decisões de lista

Trate o result.csv como um filtro, não como um veredito. Um padrão prático é manter três grupos de trabalho.

• Existe: identificadores que resolvem para uma conta. Eles permanecem na lista ativa e podem seguir para a próxima etapa de revisão.
• Não existe: identificadores que não retornaram nenhuma conta. Estes são candidatos para remoção ou para uma verificação com quem forneceu a entrada, pois erros de digitação e identificadores abandonados parecem iguais aqui.
• Precisa de uma segunda análise: linhas com colunas opcionais vazias. Valores vazios nas colunas de perfil são um resultado normal, portanto, não trate uma URL de avatar ou activedays em branco como um erro na sua importação.

Ao usar tg_username_profile_batch, a coluna uid é útil como uma chave estável. Identificadores podem ser renomeados por seus proprietários, enquanto um uid permanece vinculado à conta; portanto, armazená-lo ao lado do nome de usuário permite reconciliar registros posteriormente. O uid é uma chave de banco de dados para seus próprios registros e não diz nada sobre a pessoa por trás da conta.

Qualquer limite de activedays é sua própria regra de negócio. Uma equipe pode separar linhas acima de um número escolhido de dias para uma lista de contato mais leve, mas o produto não define o que conta como ativo, e o número permanece aproximado.

Erros comuns ao verificar nomes de usuário

• Usar uma ferramenta de disponibilidade em uma lista de limpeza. Ela informará quais identificadores estão livres para serem reivindicados, o que é o oposto do que uma limpeza precisa.
• Misturar números de telefone e nomes de usuário no mesmo arquivo. Tarefas de número de telefone precisam de um país e códigos internacionais; tarefas de nome de usuário não precisam de país. Mantenha-os em arquivos separados e envie tarefas separadas.
• Esperar presença ao vivo. Nenhum serviço de nome de usuário informa quem está online agora, e nenhum expõe chats privados, grupos ou contatos.
• Tratar um identificador ausente como uma pessoa excluída. Uma pessoa pode ter alterado o identificador, e o antigo agora falha. Pergunte ao proprietário dos dados antes de excluir o registro de contato.
• Verificar o status excessivamente. Enviar uma tarefa e solicitar o status a cada poucos segundos desperdiça chamadas. Aguarde pelo menos 30 segundos entre as verificações.

Se sua lista contiver números de telefone em vez de identificadores, o serviço tg em tempo real e os serviços em lote de número de telefone são a melhor opção, e as duas abordagens podem ser combinadas verificando cada tipo de entrada em sua própria tarefa.

Perguntas frequentes

Qual é a diferença entre uma verificação de existência de nome de usuário no Telegram e uma verificação de disponibilidade?

Uma verificação de disponibilidade pergunta se um identificador pode ser reivindicado, geralmente através de uma ação de usuário logado no Telegram. Uma verificação de existência pergunta se um identificador em sua lista pertence atualmente a uma conta do Telegram, que é a pergunta que importa para a limpeza de listas.

Quais serviços do TG Validator verificam nomes de usuário?

tg_username_batch relata a existência da conta para nomes de usuário, e tg_username_profile_batch adiciona uid, activedays e uma URL de avatar. Ambos são serviços em lote assíncronos que produzem um único result.csv.

Como as equipes podem formatar nomes de usuário antes de enviar um arquivo?

Use um arquivo TXT ou CSV com um nome de usuário por linha. Nomes de usuário podem ser escritos com ou sem o @ inicial, e nenhum país precisa ser escolhido para arquivos de nomes de usuário.

Como as equipes devem ler o activedays nos resultados de perfil de nome de usuário?

Leia como dias aproximados desde a última atividade. Pode ser uma estimativa quando o Telegram oculta informações exatas de "visto por último", e cada equipe define seu próprio limite para o que fazer com linhas mais antigas.

Nomes de usuário e números de telefone podem ser verificados na mesma tarefa?

Não. Tarefas de número de telefone e tarefas de nome de usuário têm regras de entrada diferentes, portanto, as equipes as enviam como arquivos e tarefas separados.

Saiba mais

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

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