Studio e gestione

Dal telefono alla commessa giusta: Telegram (o Comandi rapidi) che archivia da solo

Un bot Telegram e una piccola app sul PC che leggono il numero di commessa e mettono foto, PDF e planimetrie nella cartella giusta del NAS. Stessa cosa con i Comandi rapidi di iPhone.

Il problema non è mandare un file dal telefono: è ritrovarlo tre settimane dopo. Le foto del sopralluogo finiscono in WhatsApp, i PDF in mail, i preventivi firmati in una cartella Download che nessuno apre più. Qui costruiamo un passaggio unico: dal telefono al file già dentro la cartella della commessa, con il nome corretto.

Il meccanismo non richiede di essere programmatori. Un bot Telegram riceve il file e il numero di commessa scritto nella didascalia; una piccola app sul PC dello studio (scritta in Python con Claude Code, o con qualsiasi assistente AI) legge quel messaggio, scarica il file, lo rinomina e lo copia nella cartella della commessa sul NAS. Se non riconosce la commessa non indovina: mette il file in una cartella «da smistare» e ti chiede il numero.

Alla fine trovi la variante senza Telegram, con i Comandi rapidi di iPhone: stesso risultato, un tocco in meno.

Il percorso del file

01Telefono
02Bot Telegram
03App sul PC
04Cartella commessa
Si parte da un gesto normale: condividere il file dal telefono. Quello che cambia è dove arriva.
Sul PC o sul NAS ogni commessa ha la sua cartella: il file ci finisce da solo, con data e mittente nel nome.
Variante iPhone: un Comando rapido nel menù di condivisione fa lo stesso lavoro, senza passare da una chat.

I passaggi

  1. 01

    La mappa delle commesse viene prima di tutto.

    Prima di toccare Telegram, scrivi un foglio (Excel o CSV) con tre colonne: numero di commessa (es. 24-15), nome (es. Ristrutturazione via Roma), percorso della cartella sul NAS (es. NAS > Commesse > 2026 > 24-15_ViaRoma). Tieni il formato dei numeri sempre uguale: è l'unica cosa che l'app userà per capire dove archiviare. Se le commesse hanno anche un nome, aggiungilo: servirà quando scriverai «via roma» al posto del numero.

  2. 02

    Crea il bot in cinque minuti.

    Apri Telegram, cerca @BotFather, avvia la chat e invia /newbot. Scegli un nome (es. «Archivio Studio Rossi») e un username che finisca per «bot». BotFather ti restituisce un token: è la chiave del bot, va incollata solo nella configurazione dell'app sul PC, mai in chat o in un documento condiviso. Aggiungi il bot al gruppo dello studio: così tutto lo studio usa lo stesso canale e i file restano tracciati.

  3. 03

    Prepara il PC che resta acceso.

    L'app deve girare su una macchina accesa quando invii i file: il PC dell'ufficio, un mini PC, o il NAS stesso se supporta Docker. Verifica che la cartella delle commesse sia raggiungibile e scrivibile dal PC. Crea poi una cartella «_da_smistare» accanto alle commesse: è lì che finisce tutto ciò che non viene associato a una commessa.

  4. 04

    Fatti scrivere l'app, non scriverla.

    Apri Claude Code nella cartella di lavoro e incolla il primo prompt qui sotto. Chiedi esplicitamente tre cose: leggere token ed elenco commesse da un file di configurazione, accettare solo i messaggi del gruppo autorizzato, e spiegarti ogni passaggio come se non fossi programmatore. Quando propone il codice, fatti dire come si installa Python e come si avvia lo script: sono due comandi, ma nell'ordine giusto.

  5. 05

    Prova con file veri, scritti male.

    Manda al bot tre cose diverse: una foto con didascalia «24-15», un PDF con «commessa 24 15 planimetria», e un file senza numero. Controlla che i primi due finiscano nella cartella giusta e che il terzo finisca in «_da_smistare» con una risposta che chiede il numero. Se qualcosa non torna, incolla l'errore a Claude Code: due o tre giri sono normali.

  6. 06

    Fallo partire da solo.

    Chiedi l'avvio automatico all'accensione del PC (su Windows: attività pianificata; su Mac: LaunchAgent) e un log giornaliero con data, mittente, commessa riconosciuta e percorso finale. Il log è la parte che si dimentica sempre ed è quella che ti salva quando un file «non è mai arrivato».

  7. 07

    La variante iPhone, senza Telegram.

    Se preferisci non passare da una chat, chiedi il secondo prompt: aggiunge all'app un piccolo indirizzo locale a cui inviare i file. Poi apri Comandi rapidi e crea «Archivia in commessa» con tre azioni: *Chiedi input* (numero di commessa), *Ricevi file* dall'app Condividi, *Ottieni contenuto dell'URL* in POST verso il PC. Aggiungilo al menù di condivisione di iOS: da Foto o File scegli Condividi, il comando, scrivi il numero, il file è archiviato. Fuori dallo studio serve che il PC sia raggiungibile da fuori: la via più semplice è Tailscale su PC e iPhone.

I prompt, pronti da copiare

Copia, incolla e cambia solo i dati del tuo progetto.

Prompt 01

Scrivimi un'app Python per Windows che archivia i file ricevuti da un bot Telegram nelle cartelle delle commesse di uno studio tecnico, sul NAS. Requisiti: - token del bot e elenco commesse in un file config.json separato: per ogni commessa numero, nome e percorso della cartella (es. \\NAS\Commesse\2026\24-15_ViaRoma); - ascolto dei messaggi con python-telegram-bot in modalità polling; - per ogni documento, foto o PDF ricevuto: leggo la didascalia, cerco il numero di commessa anche scritto in modi diversi (24-15, 24 15, 2415) o una parte del nome della commessa; se lo trovo copio il file nella cartella corrispondente rinominandolo AAAAMMGG_HHMM_mittente_nomeoriginale e rispondo su Telegram «Salvato in <percorso>»; - se non trovo la commessa, salvo il file nella cartella _da_smistare e rispondo chiedendo il numero di commessa; - accetto solo i messaggi del gruppo o della chat autorizzata (chat id in config.json), ignoro tutto il resto; - log giornaliero su file con data, mittente, commessa riconosciuta e percorso finale; - nessuna credenziale scritta nel codice. Spiegami ogni passaggio come se non fossi un programmatore: come installare Python, come creare l'ambiente, come avviare lo script, come provarlo con un file vero.

Prompt 02

Ora aggiungi all'app un piccolo server HTTP locale con FastAPI, per la variante iPhone con i Comandi rapidi. Requisiti: - endpoint POST /upload che riceve un file e il numero di commessa, applica la stessa logica di archiviazione (rinomina, cartella della commessa, altrimenti _da_smistare) e risponde con il percorso finale in JSON; - accetta solo richieste con un token segreto nell'header, preso da config.json; - avvio sulla rete locale, porta configurabile, log nello stesso file dell'app Telegram. Poi guidami passo per passo a creare il Comando rapido di iPhone: chiedi il numero di commessa, ricevi il file dal menù di condivisione, invia la richiesta POST all'indirizzo del PC (es. http://192.168.1.20:8080/upload) con il token, e mostrami la risposta come notifica. Dimmi anche come trovare l'indirizzo IP del PC e come usarlo fuori casa con Tailscale.

Prompt 03

Rendi più tollerante il riconoscimento della commessa nell'app di archiviazione. Se la didascalia non contiene un numero, confronta il testo con l'elenco delle commesse usando un modello AI (API Anthropic o OpenAI, chiave in config.json) e proponi la cartella più probabile su Telegram, con due pulsanti: «Sì, archivia» e «No, scegli dall'elenco». Il file resta in attesa in _da_smistare finché non rispondo. Aggiungi anche un comando /commesse che restituisce l'elenco delle commesse attive con numero e nome, e un comando /ultimi che elenca gli ultimi dieci file archiviati con percorso e data. Mantieni invariato tutto il resto e mostra solo le modifiche da fare.

Cosa ottieni

Un canale unico (Telegram o un Comando rapido) da cui ogni file arriva già nella cartella della commessa, rinominato con data e mittente, e un elenco di file «da smistare» quando qualcosa non torna. Nessun file più perso tra chat e Download.