Verificação de registro no Telegram em lote: como verificar uma lista grande de números

Um guia passo a passo para verificar o registro no Telegram de uma lista extensa de números de telefone com uma tarefa assíncrona tg_batch, desde a preparação do arquivo até o result.csv.

Uma verificação de registro no Telegram em lote é uma tarefa assíncrona: você envia um arquivo TXT ou CSV com um número de telefone por linha, escolhe o país e o serviço tg_batch, aguarda a conclusão da tarefa e, em seguida, baixa um único result.csv. Isso informa se cada número estava registrado no Telegram no momento da verificação, o que ajuda a equipe a decidir quais registros manter em uma lista de contatos do Telegram. O Telegram não oferece uma consulta em lote oficial, portanto, listas grandes exigem um serviço de verificação dedicado em vez de uma colagem manual.

Quando uma tarefa em lote é a ferramenta certa

As verificações em tempo real retornam um resultado na mesma sessão, o que é adequado para um único número ou um pequeno lote colado. Quando uma lista é muito maior do que uma única solicitação pode suportar, uma tarefa assíncrona é a melhor opção: você entrega o arquivo, o trabalho é executado em segundo plano e você coleta o resultado posteriormente.

Os limites por produto para cada rota estão listados na documentação da API atual; portanto, verifique-os antes de planejar uma execução grande.

Prepare o arquivo para uma verificação de registro no Telegram em lote

A maioria das tarefas com falha ou rejeitadas ocorre devido ao arquivo de entrada. Antes de enviar:

• Use um arquivo TXT ou CSV simples com um número de telefone por linha. Formatos de planilha, como XLSX, não são aceitos; portanto, exporte para CSV primeiro.
• Escreva cada número com seu código de país internacional.
• Escolha um país para a tarefa. As tarefas em lote de números de telefone são estruturadas em torno de um único país selecionado, e um arquivo que contenha majoritariamente números de outros códigos de país pode ser rejeitado. Divida listas mistas por país e envie uma tarefa por país.
• Remova duplicatas óbvias e linhas em branco para não pagar pela verificação do mesmo número duas vezes.
• Mantenha números da China continental, Hong Kong e Macau fora do arquivo: as tarefas em lote assíncronas não cobrem essas regiões.

Se a formatação for incerta, leia o guia sobre ITU-T Recommendation E.164 antes de normalizar a lista.

Envie a tarefa tg_batch e aguarde

O serviço de lote exclusivo para registro é chamado tg_batch. No painel, você escolhe a opção de Verificação em Lote, envia o arquivo e seleciona o país e o serviço. Por meio da API, a tarefa é criada com POST /api/v1/bulk-tasks e seu status é lido com GET /api/v1/bulk-tasks/{id}.

Três comportamentos devem ser considerados no planejamento:

1. O saldo é reservado no envio. A plataforma retém o saldo de todo o arquivo antecipadamente, cobra pelas entradas que retornaram resultados e libera a reserva não utilizada quando a tarefa é concluída. Se uma tarefa falhar, a reserva total é liberada.
2. Não há progresso por número. Uma tarefa informa processing, success ou failed; portanto, estruture o fluxo de trabalho em torno desses três estados em vez de uma barra de progresso.
3. Faça a sondagem com moderação. Verifique o status da tarefa com um intervalo não inferior a 30 segundos. Sondar com mais frequência aumenta a carga sem produzir resultados mais rapidamente.

O tempo de conclusão depende do arquivo, portanto, evite prometer aos interessados um prazo fixo.

Leia o result.csv e tome uma decisão

Uma tarefa concluída fornece um result.csv para download. Para o tg_batch, ele contém o número enviado e uma coluna mostrando se ele estava registrado. Trate essa coluna como um sinal de presença de conta no Telegram no momento da verificação.

Uma maneira prática de usá-lo:

• Registrado: mantenha no segmento do Telegram da lista de contatos.
• Não registrado: direcione para outro canal ou exclua de campanhas no Telegram.
• Linhas ausentes ou vazias: reenvie-as em uma tarefa posterior menor ou revise-as manualmente.

O registro não mostra que uma pessoa está ativa, que o número pertence ao contato que você espera ou que ela consentiu em receber mensagens. Se você também precisar de um sinal aproximado de recência, um serviço em lote diferente, tg_active_batch, retorna colunas adicionais; mantenha a saída de cada serviço separada em vez de presumir que todos os arquivos possuem as mesmas colunas.

Erros comuns em verificações de listas grandes

• Enviar um arquivo com países mistos e deixar que a rejeição ensine a regra.
• Enviar antes de remover duplicatas, o que infla o saldo reservado.
• Sondar a cada poucos segundos em um loop.
• Tratar o registro como consentimento ou prova de identidade.
• Executar novamente o arquivo inteiro para corrigir algumas linhas em vez de enviar apenas o que restou.

Para detalhes de faturamento, consulte a página de preços atual e a documentação da API, em vez de confiar em valores citados em artigos.

FAQ

Uma equipe pode verificar uma lista do Telegram sem ter sua própria conta no Telegram?

Sim. As equipes enviam o arquivo para um serviço de verificação por meio do painel ou da API REST e baixam o result.csv, portanto, nenhum login pessoal no Telegram é necessário para a verificação.

Como as equipes podem lidar com uma lista que contém vários países?

Divida o arquivo por país e envie uma tarefa tg_batch para cada um, pois as tarefas em lote de números de telefone estão vinculadas a um país selecionado.

Como funciona o saldo para uma tarefa em lote?

O saldo é reservado quando a tarefa é enviada, cobrado pelas entradas que retornaram resultados, e o restante não utilizado é liberado. Uma tarefa com falha libera sua reserva total.

Um resultado Registrado significa que o contato responderá?

Não.

Saiba mais

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

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