Como o TG Validator verifica um número do Telegram

Conclua uma verificação

Esta seção aborda as verificações em tempo real: o painel SaaS e os endpoints REST síncronos compartilham um único serviço de verificação e o mesmo significado de resposta. Listas muito grandes contam com uma opção em massa assíncrona, abordada no final desta página.

1. 1

   Envie um número

   Envie um número E.164 com o código do país, conforme descrito na documentação da API.

2. 2

   Use service_type=tg

   O produto tg verifica se o número estava registrado no Telegram no momento da verificação.

3. 3

   Leia o resultado

   Leia registered na mesma resposta. Faça uma nova verificação quando precisar de um status atualizado.

Qual formato de número enviar

O TG Validator aceita um número por verificação, escrito no formato E.164: um sinal de mais, o código do país e depois o número do assinante, sem espaços nem pontuação — por exemplo +17253100591. É o mesmo formato que o aplicativo do Telegram armazena internamente, portanto um número nesse formato corresponde a exatamente uma conta. Um número sem código do país não pode ser verificado com confiabilidade: os mesmos dígitos existem em muitos países.

• Sempre inclua o código do país; não dependa do país da sua própria conta.
• Remova espaços, hifens, parênteses e zeros iniciais usados na discagem nacional — mantenha apenas o + e os dígitos.
• Números no formato incorreto são rejeitados antes de qualquer cobrança; um formato rejeitado não é um resultado "não registrado".

O que significa registered?

registered é a resposta de uma verificação do Telegram. Ele só aparece em uma resposta bem-sucedida e é um booleano: true significa que o número está registrado no Telegram no momento da solicitação, false significa que não está. Qualquer outra coisa — um tempo limite excedido, um resultado indeterminado, um número inválido — volta como código de erro, e o TG Validator reembolsa essa verificação automaticamente. Portanto, a ausência do campo registered nunca significa "não registrado"; significa que a verificação não produziu resultado. O valor reflete o momento da consulta: contas são criadas e excluídas o tempo todo, então atualize a verificação antes de agir com base em um resultado antigo, em vez de armazená-lo em cache por semanas.

• registered=true significa registrado.
• registered=false significa não registrado.
• Trate os demais desfechos de acordo com o código de resposta da API; não deduza registered por conta própria.

Use o resultado dentro do seu escopo

Uma verificação reflete o status no momento da solicitação. Não é verificação de identidade nem permissão para contatar alguém.

• Não confirma quem é o dono do número, se a pessoa está online neste momento nem qualquer conteúdo de mensagens; os produtos de atividade retornam dias de atividade (dias desde o visto por último), não presença ao vivo.
• Um resultado registrado não estabelece consentimento para contatar o número.
• Faça uma nova verificação quando a decisão de negócio exigir um status atual.

Listas muito grandes: a opção assíncrona

A verificação múltipla do painel e o endpoint múltiplo da API atendem à maioria das listas. Somente quando uma lista excede em muito esses limites faz sentido enviar o arquivo inteiro como uma única tarefa em massa assíncrona — você escolhe o país ao qual a lista pertence, e ela deve ser essencialmente desse único país.

• Envie um .txt ou .csv com um número E.164 por linha, pela página de verificação em massa ou pela API.
• Escolha o país ao qual os números pertencem ao enviar; a lista deve ser essencialmente desse único país. Números demais de outros lugares fazem a tarefa falhar durante a preparação do arquivo — ela não é enviada para verificação e é reembolsada integralmente.
• O saldo é reservado para as linhas válidas no envio, você é cobrado apenas pelos números que retornam resultado e a diferença é reembolsada.
• A tarefa é executada em segundo plano; baixe o arquivo de resultado quando terminar. Uma tarefa com falha é reembolsada integralmente.