Qué significa cada métrica, cómo leer el panel de control y cómo tomar mejores decisiones a partir de tus datos de Telegram. Escrito para principiantes — con números concretos y puntos de referencia del mundo real.
Qué es TG Analytics, por qué importa el enfoque local-first y qué aprenderás en esta guía.
Todo lo que rastreas se almacena en una base de datos SQLite local en tu ordenador. Sin cuentas, sin servidores, sin telemetría. Código fuente completo en GitHub bajo la Licencia MIT.
TG Analytics es una aplicación de escritorio gratuita que convierte tus canales de Telegram en datos claros y procesables. Funciona con tus propios canales (donde eres administrador) y con cualquier canal público — perfecto tanto para gestionar tu canal como para estudiar a la competencia.
Porque las plataformas de analítica como TGStat y Telemetr requieren que entregues tus datos a sus servidores — y normalmente pagan por funciones avanzadas. TG Analytics mantiene todo en tu máquina y te da el conjunto completo de herramientas gratis.
No necesitas saber cómo funciona la API de Telegram. Solo obtén tus credenciales de my.telegram.org una vez — y la aplicación se encarga de todo lo demás.
Binarios precompilados para todas las plataformas principales. Sin instalación, sin dependencias.
Todas las compilaciones oficiales están alojadas en GitHub:
Abrir Último Lanzamientochmod +x TGAnalytics-Linux)Guárdalo en cualquier lugar conveniente — Escritorio, Documentos, una carpeta dedicada a "Herramientas". Haz doble clic para iniciar. El primer inicio puede tardar de 5 a 10 segundos mientras el binario se descomprime.
Debido a que el ejecutable no está firmado con un certificado de firma de código de pago, Windows puede mostrar una advertencia. Haz clic en Más información → Ejecutar de todos modos. También puedes compilar la aplicación desde el código fuente si lo prefieres.
Abre Terminal y ejecuta xattr -cr "/Applications/TG Analytics.app" después de mover la aplicación a Aplicaciones. Esto elimina la bandera de cuarentena para aplicaciones no firmadas.
Cada cliente de Telegram necesita api_id y api_hash del portal oficial de desarrolladores. Gratis, tarda 3 minutos.
Funcionan como un "inicio de sesión de desarrollador" para Telegram. Cada cliente de terceros tiene su propio par. Crearás el tuyo — es gratis, seguro y está adjunto solo a tu cuenta.
Abre https://my.telegram.org en tu navegador.
Introduce tu número en formato internacional con + — por ejemplo +79123456789. Telegram envía un código de confirmación a tu aplicación.
Después de iniciar sesión, haz clic en API development tools en el panel de control.
Rellena el formulario — los datos son almacenados por Telegram para sus registros y no importan para la funcionalidad. Plataforma: Desktop. Haz clic en Create application.
Verás dos valores — copia ambos:
1234567abcdef1234567890abcdef1234567890Cualquiera con tu ID de API, Hash de API y número de teléfono puede potencialmente acceder a tu cuenta de Telegram. Nunca los compartas en chats, capturas de pantalla o foros públicos.
Dos métodos de inicio de sesión — elige el que sea más cómodo para ti.
Abre la pantalla de Inicio de sesión e introduce:
+Telegram envía un código a tu aplicación (o SMS). Aparece un diálogo — introduce el código. Si la autenticación de dos factores está habilitada, sigue un aviso de contraseña.
El número de teléfono no es necesario para el inicio de sesión por QR.
Se abre una ventana con el código QR. En tu teléfono:
La ventana se cierra automáticamente al tener éxito.
Tu nombre aparece en la barra lateral. La sesión se almacena localmente — la próxima vez que abras la aplicación, ya habrás iniciado sesión.
En ~/.tg_analytics/sessions/. En Windows esto es C:\Users\TuNombre\.tg_analytics\sessions\. Para cerrar sesión completamente, usa el botón "Cerrar sesión" en la aplicación.
Dos tipos de canales: los tuyos (derechos de administrador) y cualquier canal público por @nombredeusuario.
Abre la sección Canales. Tus canales de administrador aparecen automáticamente en el lado derecho — la aplicación los extrae de tus diálogos de Telegram.
La aplicación obtiene todos los canales donde eres administrador o propietario. Esto puede tardar de 10 a 30 segundos en la primera ejecución.
El canal se mueve a la columna izquierda ("Rastreados") y la aplicación comienza inmediatamente a importar las últimas 100 publicaciones y el recuento actual de suscriptores.
La función estrella — rastrea cualquier canal abierto por @nombredeusuario, enlace de t.me/... o ID numérico.
Abre un modal con un campo de entrada.
Ejemplos de lo que funciona:
durov@durovt.me/durovhttps://t.me/durovLa aplicación resuelve el canal y muestra una vista previa — título, @nombredeusuario y recuento de suscriptores. Luego comienza a rastrearlo automáticamente.
Solo los canales públicos están disponibles para el rastreo externo. Si ves "el canal es privado" — necesitas ser administrador, o el canal es solo por invitación.
TG Analytics se centra en canales de difusión donde la publicación es unidireccional. Los supergrupos y chats no se rastrean — tienen dinámicas y métricas diferentes.
Qué significa cada número, cómo se calcula y cómo se ve un valor "bueno".
El número actual de personas suscritas al canal — igual que lo que muestra Telegram públicamente. TG Analytics toma una instantánea de este número en cada ciclo de recopilación, para que puedas ver cómo cambia con el tiempo.
Cuánto cambió el recuento de suscriptores durante el período seleccionado. Positivo = crecimiento, negativo = disminución. Muestra el efecto neto de nuevas suscripciones menos bajas.
El número medio de vistas en todas las publicaciones publicadas durante el período seleccionado. Esta es tu línea base — cada nueva publicación se juzgará contra ella.
La métrica más importante para comparar canales de diferentes tamaños. Es el porcentaje de suscriptores que vieron tu publicación promedio. Un canal con 100k suscriptores y 15% de ER está comprometido; 500k suscriptores con 2% de ER es un caparazón vacío.
Número total de reacciones emoji en una publicación. Una fuerte señal de engagement real — las reacciones requieren un toque activo, no solo lectura pasiva.
Cuántas veces se reenvió una publicación a otro chat o canal. El indicador más claro de una publicación "viral" — a alguien le gustó lo suficiente como para compartirla con su propia audiencia.
ER desglosado por tipo de publicación: texto, foto, video, documento, encuesta. Esto te muestra exactamente qué formato funciona mejor para tu audiencia específica.
No persigas números absolutos. Un canal de 3k con 25% de ER y suscriptores crecientes es más saludable que un canal de 100k con 2% de ER. TG Analytics está diseñado para mostrarte las tendencias, no las métricas de vanidad.
Cómo leer el gráfico de crecimiento, por qué podría mostrar solo datos recientes y qué buscar.
Cada vez que TG Analytics recopila datos, guarda una "instantánea" del recuento actual de suscriptores. El gráfico es una línea de tiempo de esas instantáneas. La granularidad se adapta automáticamente:
Porque Telegram no expone el historial de suscriptores a través de la API. TG Analytics solo puede registrarlo desde el momento en que empiezas a rastrear el canal. Con los días y las semanas, el gráfico se va completando naturalmente. Las publicaciones, vistas y reacciones se obtienen del historial propio de Telegram — esos están disponibles inmediatamente.
Cambia entre las pestañas 7D / 30D / 90D / Todo el tiempo para ver el mismo canal en diferentes niveles de zoom:
En lugar del total, observa el cambio en 7 días. Eso es lo que realmente produjo tu contenido y divulgación recientes — el total es principalmente historia.
Una cuadrícula de 7×24 que muestra las vistas promedio por día de la semana y hora, basada en tu propio canal.
Cada celda representa una combinación de día de la semana × hora del día. La intensidad del color son las vistas promedio de las publicaciones publicadas en esa ventana. Azul oscuro = vistas altas, azul claro = vistas bajas, blanco = no se han publicado publicaciones en esa franja todavía.
La aplicación resalta automáticamente la mejor franja con un borde contorneado y muestra la etiqueta "Mejor: Mar, 17:00" en el encabezado de la tarjeta. Esta es tu ventana de máximo engagement calculada.
Con menos de 10 publicaciones, el mapa de calor estará mayormente vacío — no hay suficiente señal. Se vuelve genuinamente útil después de 30–50 publicaciones distribuidas en diferentes momentos del día.
Aprende de tus ganadores — qué publicaciones resonaron más y qué formato funciona mejor.
Las 10 mejores publicaciones del período seleccionado, clasificadas por vistas. Cada fila muestra:
Un gráfico de anillo que muestra cuántas publicaciones de cada tipo publicaste, con estadísticas por tipo:
Colores: azul para texto, púrpura para foto, rosa para video, naranja para documento, verde para encuesta.
Hasta 6 canales lado a lado — para tu cartera o contra la competencia.
Selecciona 2–6 canales de la fila de alternancia. Los dos primeros se preseleccionan automáticamente.
Las mismas pestañas 7D / 30D / 90D / Todo que en el panel de control.
Filas: suscriptores, Δ durante el período, vistas promedio, ER, recuento de publicaciones. Columnas: una por canal. Cada columna tiene una franja de color que coincide con el gráfico multilínea de abajo.
Una línea por canal en una línea de tiempo compartida — detecta al instante cuál está creciendo más rápido, o cuál está plano.
Dos gráficos de barras abajo: uno para vistas promedio, otro para ER. El ER es la comparación más justa cuando los canales tienen tamaños muy diferentes.
Un canal de 1k y un canal de 1M no se pueden comparar por números absolutos. Pero si el canal de 1k tiene 40% de ER y el de 1M tiene 8% de ER, el más pequeño está mucho más comprometido por suscriptor. Este es el tipo de información por la que TGStat cobra.
Tres formatos — para clientes, análisis adicional o copia de seguridad.
Un informe A4 pulido diseñado para enviarse a clientes, gerentes o partes interesadas. Incluye:
Los gráficos se renderizan de forma nativa dentro del PDF (a través de matplotlib) — no como imágenes — por lo que el texto y los números se mantienen nítidos en cualquier zoom.
Debido a las limitaciones de fuentes en PDF, los emojis de los textos de las publicaciones se eliminan en el informe PDF. El texto original completo se conserva en las exportaciones JSON y CSV.
Una exportación estructurada completa que incluye el panel agregado más los datos sin procesar:
growth_series — cada instantánea de suscriptoressnapshots — pares de marca de tiempo + suscriptores sin procesarposts — cada publicación con texto completo, vistas, reacciones, reenvíos, media_typeheatmap — la matriz de 7×24top_posts, content_mixPerfecto para análisis adicional en Python, Excel o cualquier herramienta de BI.
Tabla plana de publicaciones para análisis de hojas de cálculo:
channel, date, msg_id, views, reactions, forwards, media_type, text; (compatible con Excel en la mayoría de las configuraciones regionales)Abre el panel de control, haz clic en Exportar en la barra de herramientas. Elige un formato, elige una ubicación de guardado — listo. La carpeta predeterminada es ~/.tg_analytics/exports/ pero puedes cambiarla en Ajustes.
Con qué frecuencia se obtienen los datos y cómo configurarlo para tus necesidades.
Un hilo en segundo plano se activa según la programación y actualiza cada canal rastreado — uno a la vez, con una pausa de 3 segundos entre canales para evitar activar la protección contra inundaciones de Telegram.
Barra lateral → Ajustes → sección Recopilación.
Elige en el menú desplegable. El cambio se aplica inmediatamente — sin reiniciar.
Justo debajo del menú desplegable, "Estado de recopilación automática" muestra: hora de la última ejecución, ETA de la próxima ejecución e intervalo actual.
Haz clic en Recopilar ahora en Ajustes para una actualización inmediata de todos los canales. La barra superior muestra un indicador de progreso durante la ejecución. Útil antes de generar un informe.
Intervalos muy cortos (menos de 15 minutos) en muchos canales pueden activar FloodWait. Si ves errores de flood frecuentes en los registros, aumenta el intervalo.
Idioma, apariencia, retención, carpeta de exportación, registros — todo configurable.
5 idiomas compatibles en la interfaz: inglés, ruso, español, portugués (BR), alemán. Cambia en Ajustes → Idioma — la interfaz se actualiza instantáneamente sin reiniciar.
Tres modos:
También puedes alternar entre temas rápidamente haciendo clic en el botón de alternancia de tema en la esquina superior derecha de la aplicación.
Cuánto tiempo conservar instantáneas y publicaciones antiguas en la base de datos local:
Una limpieza diaria se ejecuta en segundo plano y elimina los registros más antiguos que la ventana de retención.
Dónde se guardan los archivos PDF / JSON / CSV. El predeterminado es ~/.tg_analytics/exports/. Cámbialo a cualquier carpeta a través de Ajustes → Elegir carpeta.
Los registros de la aplicación se almacenan en ~/.tg_analytics/logs/:
app.log — registro de actividad general con rotación (5 MB × 5 archivos)crash.log — solo excepciones no controladas con traceback completoHaz clic en "Abrir carpeta" en Ajustes para abrir el directorio de registros en tu gestor de archivos. Útil para reportar problemas.
El botón "Eliminar todo" elimina permanentemente todos los canales rastreados y su historial. Úsalo si quieres empezar de cero. No afecta a tus datos de Telegram — solo a la base de datos de analítica local.
Respuestas rápidas a los problemas comunes.
Haz clic en Más información en el diálogo, luego en Ejecutar de todos modos. Esto sucede porque el ejecutable no está firmado con código. Si no confías en él, compílalo desde el código fuente: clona el repositorio y ejecuta python build.py.
Abre Terminal y ejecuta: xattr -cr "/Applications/TG Analytics.app". Esto elimina el atributo de cuarentena que macOS añade a las aplicaciones no firmadas. Después de eso, haz clic derecho → Abrir en el primer inicio.
No. Telegram no proporciona el historial de suscriptores a través de su API. La aplicación registra instantáneas desde el momento en que empiezas a rastrear — por lo que el gráfico comienza con un punto y crece a medida que ocurren nuevas recopilaciones. Con intervalos de 30 minutos, tendrás una curva completa de 24 horas en un día.
Telegram está limitando la velocidad de tu cuenta. Aumenta el intervalo de recopilación automática (Ajustes → cada 30 min o más) y reduce el número de canales rastreados. La aplicación maneja FloodWait automáticamente pausando — pero si lo ves a menudo, cambia el intervalo.
Solo los canales públicos se pueden rastrear externamente. Los canales privados (solo por invitación) no son accesibles sin membresía. Si eres miembro, el canal aparece en tu lista de administrador automáticamente — revisa la pestaña Canales.
Telegram puede revocar una sesión si inicias sesión desde demasiados dispositivos o restableces manualmente las sesiones en Telegram. Simplemente haz clic en Cerrar sesión e inicia sesión de nuevo con QR o teléfono. Tus canales rastreados y datos analíticos se conservan — viven en la base de datos local, no en la sesión.
Lo más probable es un problema de fuente faltante. Consulta ~/.tg_analytics/logs/app.log para ver el error exacto y abre un issue en GitHub con el extracto del registro. Como solución alternativa, usa la exportación JSON / CSV que no requiere fuentes.
Abre un issue en GitHub Issues o envía un mensaje directo por Telegram: @igor_shelloff. Incluye: qué hiciste, qué sucedió y (si es posible) un extracto del registro.
TG Analytics es y siempre será gratis. Si te ahorra tiempo, aquí tienes cómo puedes ayudar.
Las estrellas ayudan a otros a descubrir el proyecto.
Abrir repositorio¿Encontraste un error o tienes una idea de función?
Abrir un issueApoya el desarrollo continuo de la herramienta.
Donar¿Preguntas o comentarios? Envía un mensaje directo.
@igor_shelloffSi TG Analytics te dice qué funciona, pero también necesitas publicar y llegar a escala — prueba Telegram AutoPoster Pro del mismo desarrollador. Publicación programada, campañas DM, multicuenta, historias, protección auto-stop, informes en Telegram.
Explorar Telegram AutoPoster Pro