Automazione · Bot

Telegram
Channel Suite

Toolkit Python modulare per la gestione completa di canali Telegram: backup automatico, mirroring cross-canale, scheduling intelligente, analytics, anti-spam e content curation. Un pannello di controllo per chi gestisce uno o più canali in modo professionale.

Python Pyrogram FastAPI PostgreSQL APScheduler Docker
8Moduli integrati
12Canali gestiti
95%Spam bloccato
20hRisparmio / settimana
Architettura modulare
📋
Mirror & Forward
Copia contenuti tra canali in tempo reale
💾
Backup Engine
Backup completo con media, scheduling e export
📅
Smart Scheduler
Programmazione post con fasce orarie ottimali
🛡️
Anti-Spam
Filtro link, flood e utenti sospetti
📊
Analytics
Crescita iscritti, engagement, best time
🔄
RSS Auto-Post
Pubblica da feed RSS con formattazione
👋
Welcome Bot
Messaggi di benvenuto e onboarding
🧹
Content Cleaner
Rimozione post vecchi, duplicati, link rotti
⚙️
Admin Dashboard
Pannello web per configurazione e monitoring

Funzionalità principali

📋

Mirror & Forward cross-canale

Copia automatica dei contenuti da uno o più canali sorgente a canali destinazione. Supporta testo, foto, video, documenti e album. Filtri per keyword, tipo di media o orario. Possibilità di aggiungere watermark, footer personalizzato o rimuovere link del canale sorgente.

💾

Backup completo del canale

Esportazione dell'intero storico del canale: testi, media, metadati, reazioni. Backup incrementale giornaliero con retention configurabile. Export in JSON strutturato o ripristino su canale di backup con un comando. Ideale per protezione da ban o perdita accidentale.

📅

Scheduling intelligente

Programmazione post con coda prioritaria. Analisi automatica delle fasce orarie a maggiore engagement per suggerire gli slot migliori. Supporto contenuti ricorrenti (daily digest, weekly roundup). Preview del post prima della pubblicazione.

🛡️

Anti-spam e moderazione

Filtro automatico link sospetti, messaggi flood e bot. Blocco utenti con pattern ripetitivi. Whitelist/blacklist configurabili. Captcha per nuovi membri nei gruppi collegati. Report giornaliero delle azioni di moderazione.

📊

Analytics e reporting

Tracking crescita iscritti, views per post, tasso di engagement, retention rate. Identificazione dei contenuti più performanti. Report settimanale automatico via messaggio privato all'admin. Confronto performance tra canali gestiti.

🔄

RSS Auto-Post e Content Curation

Monitoraggio feed RSS da blog, testate e fonti selezionate. Pubblicazione automatica con formattazione Telegram (bold, link, immagine). Filtri per keyword per pubblicare solo contenuti rilevanti. De-duplicazione per evitare post ripetuti.

Demo — sessione di gestione
tg-suite — admin@server
$ tg-suite status
Connected to 12 channels (3 source, 9 managed)
Mirror engine: running — 847 messages forwarded today
Scheduler: active — 14 posts in queue
Anti-spam: active — 23 blocked today (95.2% catch rate)
Backup: last run 03:00 — 142.3 GB total

$ tg-suite mirror --from @tech_news_source --to @my_tech_channel --filter "AI,Python,ML"
Monitoring @tech_news_source for keywords: AI, Python, ML
New match: "OpenAI rilascia GPT-5..." → forwarded to @my_tech_channel
New match: "Python 3.14 release notes" → forwarded to @my_tech_channel
Skipped: "Bitcoin crolla del 5%" (no keyword match)

$ tg-suite backup --channel @my_tech_channel --incremental
Scanning for new messages since last backup...
Found 156 new messages, 34 media files
Backup complete → /backups/my_tech_channel/2026-04-08.json (2.1 MB)

$ tg-suite analytics --channel @my_tech_channel --period 7d
📈 Subscribers: 8,421 (+312 this week, +3.8%)
👁 Avg views/post: 2,847 (engagement rate: 33.8%)
🏆 Best performing: "5 librerie Python..." (6.2k views, 89 reactions)
Best posting time: Tue/Thu 09:00-10:00 (+42% vs avg)

Snippet chiave — Mirror Engine

from pyrogram import Client, filters
from pyrogram.types import Message
import asyncio

app = Client("tg_suite", api_id=API_ID, api_hash=API_HASH)

# Configurazione mirror
MIRROR_RULES = [
    {
        "source": "@tech_news_source",
        "target": "@my_tech_channel",
        "keywords": ["AI", "Python", "ML", "data"],
        "strip_links": True,
        "add_footer": "📡 via @my_tech_channel",
    }
]

@app.on_message(filters.channel)
async def mirror_handler(client: Client, msg: Message):
    for rule in MIRROR_RULES:
        if str(msg.chat.username) != rule["source"].strip("@"):
            continue

        # Filtro keyword
        text = (msg.text or msg.caption or "").lower()
        if not any(kw.lower() in text for kw in rule["keywords"]):
            continue

        # Forward con footer personalizzato
        await client.copy_message(
            chat_id=rule["target"],
            from_chat_id=msg.chat.id,
            message_id=msg.id
        )
        log.info(f"Mirrored: {msg.text[:50]}... → {rule['target']}")

app.run()

Stack tecnologico

Client Telegram
Pyrogram (MTProto)
API nativa, no limiti Bot API
Backend API
FastAPI + WebSocket
Dashboard real-time e REST
Database
PostgreSQL + Redis
Persistenza + cache + code
Scheduling
APScheduler + Celery
Cron, code async, retry
Deploy
Docker + docker-compose
One-command deploy su VPS
Monitoring
Logging + Healthcheck
Alert su errori e downtime

Risultati e applicabilità

La suite gestisce attualmente 12 canali in parallelo con un uptime del 99.7%. Il modulo mirror ha inoltrato oltre 25.000 messaggi nell'ultimo mese, con un tasso di errore inferiore allo 0.1%.

L'anti-spam blocca il 95% dei messaggi indesiderati nei gruppi collegati, con un tasso di falsi positivi sotto il 2%. Il modulo analytics ha identificato che i post pubblicati nelle fasce orarie suggerite ottengono in media il 42% di views in più.

Il backup incrementale giornaliero protegge l'intero storico dei canali (142 GB di media inclusi), con possibilità di ripristino completo su un nuovo canale in caso di ban o perdita.

Il sistema è pensato per content creator, agenzie di comunicazione e aziende che gestiscono canali Telegram come canale di marketing o community. Ogni modulo è indipendente e attivabile singolarmente. Configurazione tramite file YAML o dashboard web.

← Tutti i progetti Prossimo progetto →