O que cada métrica significa, como ler o painel e como tomar melhores decisões a partir dos dados do seu Telegram. Escrito para iniciantes — com números concretos e benchmarks do mundo real.
O que é o TG Analytics, por que a abordagem local importa e o que você aprenderá neste guia.
Tudo o que você acompanha é armazenado em um banco de dados SQLite local no seu computador. Sem contas, sem servidores, sem telemetria. Código-fonte completo no GitHub sob a Licença MIT.
O TG Analytics é um aplicativo desktop gratuito que transforma seus canais do Telegram em dados claros e acionáveis. Ele funciona com seus próprios canais (onde você é administrador) e qualquer canal público — perfeito tanto para gerenciar seu canal quanto para estudar concorrentes.
Porque plataformas de análise como TGStat e Telemetr exigem que você entregue seus dados aos servidores delas — e geralmente cobram por recursos avançados. O TG Analytics mantém tudo na sua máquina e oferece o kit de ferramentas completo gratuitamente.
Você não precisa saber como a API do Telegram funciona. Basta obter suas credenciais em my.telegram.org uma vez — e todo o resto é tratado pelo aplicativo.
Binários pré-compilados para todas as principais plataformas. Sem instalação, sem dependências.
Todas as compilações oficiais estão hospedadas no GitHub:
Abrir Última Releasechmod +x TGAnalytics-Linux)Salve-o em qualquer lugar conveniente — Área de Trabalho, Documentos, uma pasta "Ferramentas" dedicada. Dê um duplo clique para iniciar. A primeira inicialização pode levar de 5 a 10 segundos enquanto o binário é descompactado.
Como o executável não é assinado com um certificado de assinatura de código pago, o Windows pode mostrar um aviso. Clique em Mais informações → Executar assim mesmo. Você também pode compilar o aplicativo a partir do código-fonte, se preferir.
Abra o Terminal e execute xattr -cr "/Applications/TG Analytics.app" depois de mover o aplicativo para Aplicativos. Isso remove o sinalizador de quarentena para aplicativos não assinados.
Todo cliente do Telegram precisa de api_id e api_hash do portal oficial de desenvolvedores. Gratuito, leva 3 minutos.
Eles funcionam como um "login de desenvolvedor" para o Telegram. Todo cliente de terceiros tem seu próprio par. Você criará o seu — é gratuito, seguro e anexado apenas à sua conta.
Abra https://my.telegram.org no seu navegador.
Digite o número no formato internacional com + — por exemplo +5511999999999. O Telegram envia um código de confirmação para o seu aplicativo.
Após o login, clique em API development tools no painel.
Preencha o formulário — os dados são armazenados pelo Telegram para os registros deles e não importam para a funcionalidade. Plataforma: Desktop. Clique em Create application.
Você verá dois valores — copie ambos:
1234567abcdef1234567890abcdef1234567890Qualquer pessoa com seu API ID, API Hash e número de telefone pode potencialmente acessar sua conta do Telegram. Nunca os compartilhe em chats, capturas de tela ou fóruns públicos.
Dois métodos de login — escolha o que for mais confortável para você.
Abra a tela de Login e insira:
+O Telegram envia um código para o seu aplicativo (ou SMS). Um diálogo aparece — insira o código. Se a autenticação de dois fatores estiver ativada, um prompt de senha aparece em seguida.
O número de telefone não é necessário para o login por QR.
Uma janela de QR abre. No seu celular:
A janela fecha automaticamente em caso de sucesso.
Seu nome aparece na barra lateral. A sessão é armazenada localmente — na próxima vez que o aplicativo abrir, você já estará logado.
Em ~/.tg_analytics/sessions/. No Windows, isso é C:\Users\SeuNome\.tg_analytics\sessions\. Para fazer logout completo, use o botão "Sign out" no aplicativo.
Dois tipos de canais: os seus próprios (direitos de admin) e qualquer canal público por @username.
Abra a seção Canais. Seus canais de admin aparecem automaticamente no lado direito — o aplicativo os puxa dos seus diálogos do Telegram.
O aplicativo busca todos os canais onde você é administrador ou proprietário. Isso pode levar de 10 a 30 segundos na primeira execução.
O canal se move para a coluna esquerda ("Acompanhados") e o aplicativo começa imediatamente a importar os últimos 100 posts e a contagem atual de assinantes.
O recurso matador — acompanhe qualquer canal aberto por @username, link t.me/... ou ID numérico.
Abre um modal com um campo de entrada.
Exemplos do que funciona:
durov@durovt.me/durovhttps://t.me/durovO aplicativo resolve o canal e mostra uma prévia — título, @username e contagem de assinantes. Em seguida, começa a acompanhar automaticamente.
Apenas canais públicos estão disponíveis para acompanhamento externo. Se você vir "canal é privado" — você precisa ser administrador, ou o canal é somente por convite.
O TG Analytics foca em canais de transmissão onde a postagem é unidirecional. Supergrupos e chats não são acompanhados — eles têm dinâmicas e métricas diferentes.
O que cada número significa, como é calculado e como é um valor "bom".
O número atual de pessoas inscritas no canal — o mesmo que o Telegram mostra publicamente. O TG Analytics tira um snapshot desse número a cada ciclo de coleta, para que você possa ver como ele muda ao longo do tempo.
Quanto a contagem de assinantes mudou no período selecionado. Positivo = crescimento, negativo = queda. Mostra o efeito líquido de novas inscrições menos cancelamentos.
O número médio de visualizações em todos os posts publicados durante o período selecionado. Esta é a sua linha de base — todo novo post será julgado em relação a ela.
A métrica mais importante para comparar canais de tamanhos diferentes. É a porcentagem de assinantes que viram o seu post médio. Um canal com 100k assinantes e 15% de ER é engajado; 500k assinantes com 2% de ER é uma casca vazia.
Número total de reações com emoji em um post. Um forte sinal de engajamento verdadeiro — as reações exigem um toque ativo, não apenas leitura passiva.
Quantas vezes um post foi encaminhado para outro chat ou canal. O indicador mais claro de um post "viralizando" — alguém gostou o suficiente para compartilhar com o próprio público.
ER detalhado por tipo de post: texto, foto, vídeo, documento, enquete. Isso mostra exatamente qual formato tem melhor desempenho para o seu público específico.
Não persiga números absolutos. Um canal de 3k com 25% de ER e assinantes crescendo é mais saudável do que um canal de 100k com 2% de ER. O TG Analytics foi criado para mostrar as tendências, não as métricas de vaidade.
Como ler o gráfico de crescimento, por que ele pode mostrar apenas dados recentes e o que procurar.
Toda vez que o TG Analytics coleta dados, ele salva um "snapshot" da contagem atual de assinantes. O gráfico é uma linha do tempo desses snapshots. A granularidade se adapta automaticamente:
Porque o Telegram não expõe o histórico de assinantes através da API. O TG Analytics só pode registrá-lo a partir do momento em que você começa a acompanhar o canal. Ao longo de dias e semanas, o gráfico se preenche naturalmente. Posts, visualizações e reações são extraídos do próprio histórico do Telegram — esses estão disponíveis imediatamente.
Alterne entre as abas 7D / 30D / 90D / Todo o período para ver o mesmo canal em diferentes níveis de zoom:
Em vez do total, acompanhe a mudança em 7 dias. É o que seu conteúdo e alcance recentes realmente produziram — o total é principalmente histórico.
Uma grade 7×24 mostrando visualizações médias por dia da semana e hora, com base no seu próprio canal.
Cada célula representa uma combinação dia da semana × hora do dia. A intensidade da cor é a média de visualizações dos posts publicados naquela janela. Azul escuro = alto número de visualizações, azul claro = baixo número de visualizações, branco = nenhum post publicado naquele horário ainda.
O aplicativo destaca automaticamente o melhor horário com uma borda contornada e mostra o rótulo "Melhor: Ter, 17:00" no cabeçalho do cartão. Esta é a sua janela de pico de engajamento calculada.
Com menos de 10 posts, o mapa de calor ficará quase vazio — não há sinal suficiente. Ele se torna genuinamente útil após 30 a 50 posts distribuídos em diferentes horários do dia.
Aprenda com seus vencedores — quais posts ressoaram mais e qual formato funciona melhor.
Os 10 principais posts do período selecionado, classificados por visualizações. Cada linha mostra:
Um gráfico de rosca mostrando quantos posts de cada tipo você publicou, com estatísticas por tipo:
Cores: azul para texto, roxo para foto, rosa para vídeo, laranja para documento, verde para enquete.
Até 6 canais lado a lado — para o seu portfólio ou contra concorrentes.
Selecione de 2 a 6 canais na linha de alternância. Os dois primeiros são pré-selecionados automaticamente.
Mesmas abas 7D / 30D / 90D / Todo o período do painel.
Linhas: assinantes, Δ no período, visualizações médias, ER, contagem de posts. Colunas: uma por canal. Cada coluna tem uma faixa colorida correspondente ao gráfico multi-linha abaixo.
Uma linha por canal em uma linha do tempo compartilhada — identifique instantaneamente qual está crescendo mais rápido, ou qual está estável.
Dois gráficos de barras abaixo: um para visualizações médias, um para ER. O ER é a comparação mais justa quando os canais têm tamanhos muito diferentes.
Um canal de 1k e um canal de 1M não podem ser comparados por números absolutos. Mas se o canal de 1k tem 40% de ER e o de 1M tem 8% de ER, o menor é muito mais engajado por assinante. Este é o tipo de insight pelo qual o TGStat cobra.
Três formatos — para clientes, análises adicionais ou backup.
Um relatório A4 refinado, projetado para ser enviado a clientes, gerentes ou partes interessadas. Inclui:
Os gráficos são renderizados nativamente dentro do PDF (via matplotlib) — não como imagens — então o texto e os números permanecem nítidos em qualquer zoom.
Devido a limitações de fonte no PDF, emojis dos textos dos posts são removidos no relatório em PDF. O texto original completo é preservado nas exportações JSON e CSV.
Uma exportação estruturada completa incluindo o painel agregado mais os dados brutos:
growth_series — cada snapshot de assinantessnapshots — pares brutos de timestamp + assinantesposts — cada post com texto completo, visualizações, reações, encaminhamentos, media_typeheatmap — a matriz 7×24top_posts, content_mixPerfeito para análises adicionais em Python, Excel ou qualquer ferramenta de BI.
Tabela plana de posts para análise em planilhas:
channel, date, msg_id, views, reactions, forwards, media_type, text; (compatível com Excel na maioria dos locais)Abra o painel, clique em Exportar na barra de ferramentas. Escolha um formato, escolha um local para salvar — pronto. A pasta padrão é ~/.tg_analytics/exports/, mas você pode alterá-la nas Configurações.
Com que frequência os dados são buscados e como configurá-los para suas necessidades.
Uma thread em segundo plano é acionada de acordo com o cronograma e atualiza cada canal acompanhado — um de cada vez, com uma pausa de 3 segundos entre canais para evitar disparar a proteção contra flood do Telegram.
Barra lateral → Configurações → seção Coleta.
Escolha no menu suspenso. A alteração é aplicada imediatamente — sem reinicialização.
Logo abaixo do menu suspenso, "Status da coleta automática" mostra: hora da última execução, ETA da próxima e intervalo atual.
Clique em Coletar agora nas Configurações para uma atualização imediata de todos os canais. A barra superior mostra um indicador de progresso durante a execução. Útil antes de gerar um relatório.
Intervalos muito curtos (abaixo de 15 minutos) em muitos canais podem acionar FloodWait. Se você vir erros frequentes de flood nos logs, aumente o intervalo.
Idioma, aparência, retenção, pasta de exportação, logs — tudo configurável.
5 idiomas suportados na interface: inglês, russo, espanhol, português (BR), alemão. Altere em Configurações → Idioma — a interface atualiza instantaneamente sem reiniciar.
Três modos:
Você também pode alternar rapidamente entre os temas clicando no botão de alternância de tema no canto superior direito do aplicativo.
Por quanto tempo manter snapshots e posts antigos no banco de dados local:
Uma limpeza diária é executada em segundo plano e exclui registros mais antigos que a janela de retenção.
Onde os arquivos PDF / JSON / CSV são salvos. O padrão é ~/.tg_analytics/exports/. Altere para qualquer pasta via Configurações → Escolher pasta.
Os logs do aplicativo são armazenados em ~/.tg_analytics/logs/:
app.log — log geral de atividade com rotação (5 MB × 5 arquivos)crash.log — apenas exceções não tratadas com traceback completoClique em "Abrir pasta" nas Configurações para abrir o diretório de logs no seu gerenciador de arquivos. Útil para relatar problemas.
O botão "Excluir tudo" remove permanentemente todos os canais acompanhados e seu histórico. Use se quiser começar do zero. Não afeta seus dados do Telegram — apenas o banco de dados de análise local.
Respostas rápidas para problemas comuns.
Clique em Mais informações no diálogo e depois em Executar assim mesmo. Isso acontece porque o executável não é assinado. Se você não confiar, compile a partir do código-fonte: clone o repositório e execute python build.py.
Abra o Terminal e execute: xattr -cr "/Applications/TG Analytics.app". Isso remove o atributo de quarentena que o macOS adiciona a aplicativos não assinados. Depois disso, clique com o botão direito → Abrir na primeira execução.
Não. O Telegram não fornece histórico de assinantes através da API. O aplicativo registra snapshots a partir do momento em que você começa a acompanhar — então o gráfico começa com um ponto e cresce conforme novas coletas acontecem. Com intervalos de 30 minutos, você terá uma curva completa de 24h em um dia.
O Telegram está limitando a taxa da sua conta. Aumente o intervalo de coleta automática (Configurações → a cada 30 min ou mais) e reduza o número de canais acompanhados. O aplicativo lida com FloodWait automaticamente pausando — mas se você vir isso com frequência, altere o intervalo.
Apenas canais públicos podem ser acompanhados externamente. Canais privados (somente por convite) não são acessíveis sem associação. Se você for membro, o canal aparece automaticamente na sua lista de admin — verifique a aba Canais.
O Telegram pode revogar uma sessão se você fizer login de muitos dispositivos ou redefinir sessões manualmente no Telegram. Basta clicar em Sign out e fazer login novamente com QR ou telefone. Seus canais acompanhados e dados de análise são preservados — eles ficam no banco de dados local, não na sessão.
Provavelmente um problema de fonte ausente. Verifique ~/.tg_analytics/logs/app.log para o erro exato e abra uma issue no GitHub com o trecho do log. Como alternativa, use a exportação JSON / CSV, que não exigem fontes.
Abra uma issue no GitHub Issues ou envie uma mensagem diretamente no Telegram: @igor_shelloff. Inclua: o que você fez, o que aconteceu e (se possível) um trecho do log.
O TG Analytics é e sempre será gratuito. Se ele economiza seu tempo, aqui está como você pode ajudar.
Estrelas ajudam outros a descobrir o projeto.
Abrir repositórioEncontrou um bug ou tem uma ideia de recurso?
Abrir uma issueApoie o desenvolvimento contínuo da ferramenta.
DoarDúvidas ou feedback? Envie uma mensagem diretamente.
@igor_shelloffSe o TG Analytics mostra o que funciona, mas você também precisa publicar e alcançar em escala — experimente o Telegram AutoPoster Pro, do mesmo desenvolvedor. Postagem agendada, campanhas de DMs, multi-contas, stories, proteção de parada automática, relatórios no Telegram.
Explorar Telegram AutoPoster Pro