Como verificar se um número tem Telegram sem salvá-lo nos seus contatos

Explica por que salvar números nos contatos é uma forma ineficiente de verificar o registro no Telegram para registros comerciais e como uma verificação de registro com resposta imediata resolve essa questão.

Para verificar se um número tem Telegram sem adicionar um contato, envie o número no formato E.164 para uma verificação de registro no Telegram hospedada, em vez de salvá-lo no seu celular. A verificação retorna o status de registro do Telegram do número na mesma resposta, mantém sua agenda intacta e funciona da mesma forma para um único número ou para uma lista. As alternativas no aplicativo, como abrir um link de número de telefone, dependem das configurações de privacidade do titular da conta, portanto, um resultado ausente nesses casos é difícil de interpretar.

Por que o método de salvar e sincronizar é insuficiente

A maioria dos guias responde a essa pergunta dizendo aos leitores para salvar o número no celular, abrir o Telegram e esperar que o contato apareça. Isso funciona para um amigo, mas causa problemas para quem gerencia registros comerciais:

• Sua agenda fica cheia de estranhos. Cada lead ou cliente que você testa torna-se um contato em um celular pessoal ou compartilhado, e é fácil esquecer de excluí-los depois.
• A lista é carregada. A documentação do Telegram para contacts.importContacts afirma que o método salva a lista completa importada no servidor. Sincronizar contatos de trabalho a partir de um dispositivo pessoal mistura dados da empresa em uma conta pessoal.
• O titular da conta pode ver você. Uma vez que o número é salvo, o aplicativo da outra pessoa pode tratar você como um contato, dependendo das configurações de ambos os lados.
• Os resultados são ambíguos. O Telegram FAQ explica que os usuários escolhem quem pode encontrá-los pelo número de telefone. Quando um contato não aparece, isso pode significar que não há conta ou que existe uma configuração restritiva.
• Não é escalável. Salvar cinquenta números manualmente leva muito tempo, e salvar cinco mil não é prático.

Os guias mais bem posicionados mencionam alguns desses problemas para indivíduos, mas raramente abordam o caso comercial de verificar registros que você já possui.

Formas de verificar um número sem adicionar um contato

Existem quatro métodos principais. A tabela os compara quanto ao que é necessário e quão confiável é a resposta para um registro comercial.

O link de número de telefone é a opção manual mais rápida. O FAQ do Telegram observa que tal link só funciona se as configurações de privacidade do titular da conta permitirem que outros o encontrem pelo número de telefone, portanto, é uma verificação pontual razoável, mas não uma resposta confiável.

Scripts auto-hospedados parecem atraentes porque são gratuitos para baixar, mas precisam de credenciais do my.telegram.org, que a página de registro de API do Telegram vincula a um número de telefone já cadastrado por meio de um aplicativo oficial do Telegram; a mesma página avisa que contas que fazem login por meio de clientes não oficiais são colocadas sob observação. Muitos desses scripts funcionam importando números como contatos e lendo as correspondências, o que é o mesmo método de agenda em forma automatizada.

Passo a passo: verificar um número no painel

O painel do TG Validator responde à pergunta sem qualquer importação de contatos. O fluxo de trabalho para um número é:

1. Normalize o número para E.164. Comece com um sinal de mais, seguido pelo código do país e o número nacional, sem espaços, traços ou colchetes. Remova o zero inicial: um celular do Reino Unido escrito localmente como 07700 900123 torna-se +447700900123.
2. Abra a Verificação Única. Cole o número normalizado e execute a verificação.
3. Leia o status de registro. O resultado informa se o número possui uma conta no Telegram no momento da verificação.
4. Registre o resultado com uma data. O registro pode mudar, portanto, armazene quando a verificação foi realizada ao lado do resultado.

Para uma lista curta, a aba Verificação em Lote do painel aceita até 500 números colados de uma só vez e retorna os resultados na mesma sessão. Isso é adequado para uma equipe de vendas ou suporte que analisa uma exportação sem envolver desenvolvedores.

O painel também mantém o histórico de verificações e relatórios de uso, o que ajuda quando alguém pergunta posteriormente quando um registro foi verificado.

Passo a passo: verificar um número por meio da API

Quando a verificação faz parte de um CRM, fluxo de inscrição ou ferramenta interna, a API REST remove a etapa manual:

1. Crie uma chave de API no painel. As chaves começam com sk_ e devem ser armazenadas em um gerenciador de segredos, nunca em código do lado do cliente.
2. Envie a solicitação. Chame POST /api/v1/check com o cabeçalho X-API-Key e um corpo que define service_type como tg e identifier como o número E.164.
3. Gerencie o envelope de resposta. A resposta usa code, msg e data. Um resultado concluído informa o status de registro para o número enviado.
4. Gerencie verificações indecisas. Se uma verificação não puder ser decidida, a resposta retorna um código comercial diferente de zero e nenhum resultado concluído. Armazene-os como "não decidido" e tente novamente mais tarde, em vez de marcá-los como não registrados.
5. Use o lote onde for útil. POST /api/v1/batch-check aceita até 100 números em uma única solicitação de resposta imediata.

A documentação da API descreve controles de simultaneidade e tempo limite por usuário, em vez de uma taxa por minuto, portanto, projete as tentativas de repetição em torno desses controles documentados. Assistentes de IA que suportam MCP podem executar as mesmas verificações únicas e de pequenos lotes por meio do endpoint oficial do MCP, que usa um cabeçalho Bearer com a mesma chave e saldo.

Lendo o resultado sem interpretá-lo excessivamente

Um resultado de registro responde bem a uma pergunta e nada além disso. Use-o da seguinte forma:

• Registrado suporta o roteamento do registro para o Telegram como um possível canal, ou a marcação para segmentação.
• Não registrado sugere o roteamento do registro para outro canal, como e-mail ou SMS, se você tiver permissão para usá-lo.
• Não decidido deve permanecer em uma fila de revisão ou nova tentativa.

O que o resultado não diz é tão importante quanto o que ele diz. Ele não mostra quão recentemente a conta foi usada, quem possui o número ou se a pessoa deseja ouvir você. Se a inatividade for importante para uma lista grande, o serviço de atividade em massa adiciona dias aproximados desde a última atividade; esses valores podem ser menos exatos quando o titular oculta o horário da última visualização.

Cada verificação decidida é cobrada, independentemente de o número estar registrado ou não, portanto, remover duplicatas da lista antes de verificar economiza saldo.

Considerações sobre privacidade e consentimento

Verificar um número sem salvá-lo remove o problema da agenda, mas não remove a necessidade de um propósito legítimo. Antes de verificar, as equipes devem ser capazes de responder a três perguntas:

1. De onde veio o número? Verifique números que sua organização coletou para um propósito declarado, como contas de clientes, inscrições ou tickets de suporte.
2. Por que o status do Telegram é necessário? Roteamento, segmentação e planejamento de canais são motivos comuns e documentados. Curiosidade sobre um estranho não é.
3. O que acontece a seguir? Um resultado registrado não é consentimento para enviar mensagens a alguém. Qualquer contato ainda precisa de uma base legal sob as regras que se aplicam a você e deve respeitar as exclusões (opt-outs).

Escrever essas respostas em um procedimento interno também ajuda os novos funcionários a entender por que o atalho de salvar e sincronizar não é usado em celulares de trabalho.

Quando a lista é muito grande para uma verificação de resposta imediata

Para exportações muito grandes, a opção de lote assíncrono é um complemento rápido ao fluxo de trabalho acima. Carregue um arquivo TXT ou CSV com um número por linha, selecione o país ao qual a lista pertence, aguarde a conclusão da tarefa e baixe um result.csv. Arquivos de lote de telefone devem ser essencialmente de um país, e as tarefas em lote não suportam números da China continental, Hong Kong ou Macau, que estão disponíveis apenas por meio da verificação de número único para volumes pequenos. O saldo é reservado no envio e a parte não gasta é liberada quando a tarefa é concluída. Limites por serviço se aplicam, portanto, confirme-os na documentação atual da API antes de carregar.

FAQ

A pessoa saberá que seu número foi verificado?

Uma verificação de registro hospedada não adiciona o número aos contatos de ninguém e não envia uma mensagem para a pessoa. Ela retorna um status de registro para a equipe que executou a verificação.

Por que um link de número de telefone às vezes não mostra nada para um número que tem Telegram?

O FAQ do Telegram explica que os links de número de telefone funcionam apenas se as configurações de privacidade do titular da conta permitirem que outros o encontrem pelo número. Um resultado em branco pode, portanto, refletir uma configuração em vez de uma conta ausente.

Como as equipes podem verificar números de vários países ao mesmo tempo?

Use as opções de resposta imediata, que aceitam cada número no formato E.164: a Verificação em Lote do painel para até 500 números colados ou o endpoint de lote da API para até 100. As tarefas de arquivo em lote são organizadas por um país selecionado, portanto, divida listas mistas por país primeiro.

Um resultado registrado significa que o número é seguro para enviar mensagens?

Significa que o número tinha uma conta no Telegram no momento da verificação. Ele não mostra consentimento, identidade ou atividade, portanto, as decisões de envio de mensagens devem basear-se nas permissões que sua organização possui.

Saiba mais

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

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