Bot Telegram

Vtes.Bot

Archiviato PersonaleDocker Hub

Il compagno su Telegram di Vtes.Manager: consultare tornei e leghe, iscriversi, inserire il proprio risultato e ricevere le notifiche, senza aprire il browser.

Nessun comando da ricordare oltre a /menu. Dentro Telegram un comando in più è un comando che nessuno digita: tutta la navigazione è a pulsanti, e ogni schermata ha il suo Indietro, perché in una navigazione a bottoni un vicolo cieco costringe a ricominciare da capo.

La classifica si impagina da sola. Un messaggio Telegram si ferma a 4096 caratteri: la pagina viene tarata su quel limite invece di essere fissata a occhio, e vincitori e finalisti compaiono senza posizione numerica.

Due client verso il Manager, non uno. Quello pubblico legge classifiche senza credenziali; quello interno, con chiave condivisa, fa le azioni per conto di qualcuno. Sono due cose diverse e passano da due porte diverse, con il webhook che espone un percorso opaco per non lasciare il token del bot nei log del proxy.

Stato. Dismesso il 13 agosto 2026 insieme al Manager.

apr 2026prima immagine pubblicata
7gruppi di schermate
5tipi di notifica
20righe per pagina di classifica

Piattaforma

Runtime
Python 3.13, tutto asincrono
Librerie
aiogram per Telegram, httpx per l'API, aiosqlite, pydantic, APScheduler
Stato locale
SQLite con il minimo indispensabile: collegamento, lingua, preferenze di notifica
Esecuzione
webhook in produzione, polling in sviluppo, senza bisogno di un indirizzo pubblico

Cosa si fa dalla chat

Eventi
tornei e leghe, con classifica paginata a venti righe
Iscrizioni
iscriversi e disiscriversi dove le iscrizioni sono aperte
Risultati
flusso guidato: tavolo, VP da 0 a 5 a mezzi punti, game win, riepilogo
Profilo
statistiche, clan e tipi di mazzo più giocati, storico paginato
Navigazione
tutta a pulsanti, con Indietro su ogni schermata

Notifiche

Tipi
evento pubblicato, round completato, classifica aggiornata, evento chiuso, promemoria
Promemoria
a sette, tre e un giorno dall'evento, da un job giornaliero
Preferenze
disattivabili una per tipo, dal profilo

Verso il Manager

Due client
uno pubblico senza credenziali per leggere, uno interno con chiave condivisa per agire
Collegamento account
token monouso valido quindici minuti, generato dal Manager e validato dal bot
Privacy
per chi non ha collegato l'account i nomi sono abbreviati, come nelle viste pubbliche

Stato

Dismesso
13 agosto 2026, insieme a Vtes.Manager
Cosa resta
immagine su Docker Hub in sola lettura

Stack

Tecnologie
PythonaiogramSQLitepydantic