TM Tool — il gestionale del tour manager
TM Tool (Tour Manager Tool) trasforma il flusso caotico di un tour (mail, chat WhatsApp, vocali, PDF, note prese al telefono) in task chiari, prepara le bozze delle risposte, tiene traccia di chi deve ancora rispondere e raccoglie i dati confermati in un unico grafo del tour, da cui escono calendario, daily sheet, tourbook e impronta CO₂.
Le parole che userai
| Tour | Un progetto separato (es. «Vertigo Tour 2027»): messaggi, task, grafo e tourbook di un tour non si mescolano mai con quelli di un altro. |
| Task | Una cosa da fare ricavata da un messaggio: prenotare un hotel, avvisare il catering di una dieta, aggiornare un pass. |
| Bozza | Il testo preparato dal tool per un task. Non parte mai da sola: la apri in Gmail o WhatsApp, controlli e invii tu. |
| Fatto | Un'informazione confermata (un soggiorno, un treno, una dieta) scritta nel grafo. Ogni fatto ha chi l'ha confermato e quando. |
| Grafo | L'archivio dei fatti del tour, collegati tra loro (persona → soggiorno → hotel → città). È la fonte di tutti i documenti. |
| Incongruenza | Due messaggi che dicono cose diverse sulla stessa cosa (orari, date, hotel): il tool te le segnala, decidi tu. |
Le schermate di questa guida usano un tour di esempio con dati fittizi (Vertigo Tour 2027) e account demo
tm@sound-demo.it / produzione@sound-demo.it. Schermate aggiornate al 2026-10-25 18:16.
02Account e profili
Ci sono due ruoli. L'amministratore vede tutti i tour, li crea e invita le persone. L'utente vede e lavora solo sui tour che gli sono stati assegnati. Non esiste una registrazione libera: si entra solo con un invito.
2.1 · Primo avvio: creare l'account amministratore
Al primissimo avvio il tool non ha account e mostra questa pagina. Si usa una volta sola, da chi installa il tool: appena esiste un account la pagina si chiude e da lì in poi si entra solo con un invito.
- 1La tua email: sarà il nome utente.
- 2Una password di almeno 8 caratteri.
- 3La stessa password, per conferma.
- 4Crea amministratore: entri subito e arrivi alla pagina Tour.
2.2 · Invitare una persona (amministratore)
- Nella barra laterale apri Amministrazione›Utenti e accessi.
- Nel riquadro Invita una persona scrivi l'email del collega e spunta i tour a cui deve accedere.
- Premi Crea link di registrazione, copia il link e mandalo alla persona (mail, WhatsApp…).
- 1Email della persona. Consigliata: così solo quell'indirizzo potrà usare il link.
- 2I tour che la persona potrà vedere. Puoi cambiarli anche dopo.
- 3Crea link di registrazione.
- 1Il link personale. Vale una sola volta, per 7 giorni, e non viene più mostrato.
- 2Copia e invialo. Se lo perdi: revocalo (in «Link in attesa») e creane un altro.
2.3 · Creare il proprio profilo dal link (utente invitato)
- Apri il link ricevuto (va bene da computer, tablet o telefono).
- L'email è già compilata se l'amministratore l'ha indicata. Scegli una password (almeno 8 caratteri) e ripetila.
- Premi Crea account ed entra: vedrai subito i tour che ti sono stati assegnati.
- 1Email (bloccata se l'invito è nominativo).
- 2Scegli la password.
- 3Ripetila.
- 4Crea account ed entra.
- 1Apri per entrare nel tour.
- 2Il tuo account e il pulsante Esci.
Se dopo la registrazione vedi «Nessun tour assegnato», l'account funziona ma l'amministratore non ti ha ancora dato accesso a un tour: chiedigli di spuntarlo in Utenti e accessi.
2.4 · Accedere
- 1Email del tuo account.
- 2Password.
- 3Accedi. La sessione resta aperta 7 giorni su quel browser.
Dopo 5 tentativi sbagliati di fila l'accesso per quell'email si blocca per un minuto.
2.5 · Password dimenticata, account da gestire
Non c'è un «password dimenticata» automatico: l'amministratore crea un link nuova password e te lo manda. Dalla stessa tabella gestisce tutti gli account.
- 1I tour a cui l'utente ha accesso: spunta o togli…
- 2…e premi Salva accessi.
- 3Link nuova password: crea un link (una volta, 7 giorni) per reimpostarla.
- 4Rendi amministratore / togli il ruolo.
- 5Disattiva: la persona non può più entrare (si può riattivare).
Amministratore chiuso fuori? Se nessun amministratore riesce più a entrare, chi gestisce il server del tool può crearne o reimpostarne uno
(python tools/create_admin.py tua@email.it).
03I tour
Ogni tour ha i suoi messaggi, task, grafo, date e tourbook, e la sua etichetta Gmail. Si gestiscono dalla pagina Tutti i tour · nuovo sotto il nome del tour nella barra laterale.
- 1Nome del tour, es. «Fuori Rotta Tour 2026».
- 2Etichetta Gmail del tour. Vuota =
TOUR/<nome del tour>(vedi Gmail). - 3Crea e apri: crea il tour e ti porta nei suoi Task attivi.
- 1Il tour aperto in questa scheda. Il menu a tendina cambia tour solo in questa scheda.
- 2Apri il tour.
- 3Apri in nuova scheda: puoi lavorare su due tour in parallelo, uno per scheda.
- 4Modifica: rinomina, cambia etichetta Gmail, Archivia (sparisce dal menu ma i dati restano).
- 5Periodo del tour e etichetta Gmail in uso.
Chi c'è dietro un tour. Ogni riquadro mostra anche Creato da (l'account che ha creato il tour) e Accesso: tutti gli account attivi che possono aprirlo, cioè gli amministratori (segnati «admin», vedono sempre tutti i tour) e gli utenti a cui il tour è stato assegnato in «Utenti e accessi». Se gli account sono più di tre vedi i primi tre e un «+N altri»: cliccalo per aprire l'elenco completo. Gli account disattivati non compaiono. Per i tour creati prima che il tool registrasse chi li crea compare «non registrato»: un amministratore può indicarlo (o correggerlo) dal menu Creato da dentro Modifica.
04L'interfaccia
Tutte le pagine hanno la stessa struttura: a sinistra il tour e il menu, in alto il titolo della pagina e il tuo account.
- 1Il tour su cui stai lavorando e il link alla pagina Tour.
- 2Il menu: Operativo, Inbox, Grafo, Calendario, Viste rapide, Aiuto e (solo admin) Amministrazione.
- 3Riepilogo della pagina (qui: task aperti e incongruenze).
- 4Il tuo account (admin se amministratore) e Esci.
- 5L'impronta CO₂ del tour: clic per il dettaglio.
- 6Scansiona risposte e Approva tutti i pending (vedi Task attivi).
- 7Le incongruenze trovate tra i messaggi: clic per espandere.
- 8Un task: la barra colorata a sinistra è l'urgenza.
| Voce del menu | A cosa serve |
|---|---|
| Task attivi | La pagina di lavoro quotidiana: cosa c'è da fare, bozze, risposte attese. |
| Carica messaggi | Far entrare nel tool mail, chat, documenti, vocali e note. |
| Fatti confermati | Il grafo del tour: correggere i dati, generare i tourbook. |
| Tourbook grafo | Versione stampabile di tutti i fatti del grafo. |
| Impronta CO₂ | Stima delle emissioni di viaggi, hotel, trasporti pesanti e pasti. |
| Calendario tour | Le date del tour, il dettaglio di ogni giorno, daily e report stampabili. |
| Viste rapide | Tabelle per tipo: roster, alloggi, spostamenti, pass, diete, trasporti pesanti. |
| Guida utente | Questa guida. |
| Chiedi all'assistente | Il pulsante in basso a destra: un assistente che risponde alle domande sull'uso del tool (vedi Assistente). |
| Utenti e accessi · Reset | Solo amministratori: account e azzeramento dei dati. |
05Assistente della guida
Un assistente a cui chiedere in linguaggio naturale come si usa il TM Tool: «come invito un collega?», «dove scarico il tourbook in Word?», «si può collegare WhatsApp?». Risponde in base a questa guida.
- 1Il pannello si apre dal pulsante Chiedi all'assistente, in basso a destra in ogni pagina dopo l'accesso.
- 2La conversazione: risposte brevi, con i passaggi da seguire e il rimando alla sezione della guida.
- 3Nuova chat: ricomincia da zero (l'assistente dimentica le domande precedenti).
- 4Scrivi la domanda e premi Invio (Maiusc+Invio per andare a capo).
- Ricorda la conversazione: puoi fare domande di seguito («e se il link è scaduto?»). Sa anche in che pagina sei, quindi puoi chiedere «a cosa serve questo pulsante?» nominandolo.
- Sa cosa si può fare e cosa no: se una funzione non esiste ancora te lo dice (vedi Cosa si può fare), invece di inventarla.
- Non vede i dati dei tuoi tour (task, persone, hotel) e non fa azioni al posto tuo: spiega come farle. Per sapere «dove dorme Marta» usa le Viste rapide.
- Può sbagliare: per le operazioni delicate (reset, accessi, Gmail) verifica sempre nella sezione della guida che ti indica.
- È disponibile solo dopo l'accesso. Se risponde «non è ancora configurato» o «non risponde», avvisa chi gestisce il tool.
06Carica messaggi
Tutto ciò che entra nel tool passa da qui. Ogni messaggio viene letto dall'AI, che ne estrae persone, date, hotel, treni, diete e pass e crea i task corrispondenti nel tour indicato.
- 1Gmail: collegamento diretto della casella, non ancora disponibile (vedi Gmail): per ora le mail si caricano come file.
- 2Tipo fonte: scegli che cosa stai caricando prima di selezionare i file.
- 3File singoli o multipli: clic e scegli uno o più file (Ctrl/⌘+clic per sceglierne più di uno).
- 4Cartella intera: carica tutti i file di una cartella.
- 5Nota manuale: scrivi o detta un'informazione ricevuta a voce.
- 6Aggiungi nota: la nota segue lo stesso percorso di un messaggio.
| Tipo fonte | Cosa caricare |
|---|---|
Il testo di una mail salvato come .txt (in Gmail: ⋮ › Scarica messaggio dà il file .eml). | |
| WhatsApp · Telegram · SMS | L'esportazione della chat in .txt (vedi WhatsApp), o il testo copiato in un file. |
| Biglietti, conferme hotel, rooming list: ogni pagina viene trascritta. | |
| Immagine | Foto e screenshot (anche di chat): il testo viene trascritto. |
| Audio | Vocali e registrazioni di telefonate: vengono trascritti parola per parola. |
| Foglio di calcolo | Excel (.xlsx, .xls), Apple Numbers (.numbers) e CSV: rooming list,
call sheet, piani di viaggio. Le celle si leggono direttamente, senza AI: ogni riga diventa una scheda con i nomi delle colonne
(per esempio «Nome: Mario Rossi; Hotel: Grand Hotel; Check-in: 2026-11-21»), anche per i fogli nascosti. Tieni una riga di
intestazione con nomi chiari (Nome, Hotel, Check-in…): l'AI capisce meglio i dati. Si leggono al massimo 500 righe per foglio. |
Appena invii una nota o uno o più file compare il riquadro Caricamento in corso… con il tempo trascorso. Per i file mostra anche a che punto è («2 di 4 file elaborati», il nome del file e la fase) con una barra di avanzamento. Ogni messaggio richiede da qualche secondo a un paio di minuti. Non ricaricare e non ricliccare: il tool blocca già i doppi invii.
L'esito del caricamento
Alla fine il tool dice sempre com'è andata:
- Inserito correttamente (riquadro verde): il messaggio ha prodotto dei task, ad esempio «Nota inserita correttamente: 2 task create» o «3 file su 4 inseriti correttamente: 5 task create». Vieni portato da solo in Task attivi, dove il riepilogo resta in alto. Se alcuni file non hanno prodotto task o non sono stati caricati, il riquadro li elenca prima di portarti alle task.
- Caricato, ma non ha prodotto task (riquadro rosso): l'AI ha letto il messaggio ma non ci ha trovato nulla da organizzare. Il motivo dice se mancavano del tutto informazioni sul tour o se ha riconosciuto qualcosa (per esempio «1 persona, 1 data di tour»), che resta comunque registrato, senza però un'azione da fare. Riformula il messaggio dicendo cosa va organizzato, per chi, dove e quando, ad esempio «prenotare l'hotel a Bologna per Mario Rossi dal 21 al 23 novembre».
- Già inserito (nessun task nuovo): lo stesso testo o lo stesso file era già stato caricato in questo tour, quindi viene saltato.
- Problema di sistema (riquadro rosso): l'elaborazione non è riuscita, per esempio perché l'AI non risponde. Il messaggio riporta l'errore: riprova tra poco, i file già elaborati vengono riconosciuti.
Per la nota manuale, in tutti i casi negativi il testo resta nel riquadro: premi Modifica il testo, correggilo e reinvialo. Per i file, se nessuno produce task resti in Carica messaggi con il motivo: premi Chiudi, sistema il file e ricaricalo.
La nota manuale e la dettatura
Per le informazioni senza un messaggio da caricare (telefonata, riunione, backstage). Scrivi cosa ti è stato detto, ad esempio «Il fonico mi ha detto per telefono che il check-in dell'hotel a Bologna slitta al 22». Il task creato resta evidenziato in azzurro come Inserito a mano finché non lo confermi.
Il pulsante Detta trascrive la voce: in Chrome, Edge e Safari il testo compare mentre parli; negli altri browser registri, premi Ferma e il testo arriva poco dopo (la trascrizione la fa il server del tool, non un servizio esterno). La prima volta il browser chiede il permesso per il microfono: clicca Consenti. Controlla sempre il testo prima di premere «Aggiungi nota».
Fonti caricate
Nel menu a sinistra, sotto Inbox, Fonti caricate elenca tutto ciò che è entrato nel tour, dal più recente: file, note manuali e chat WhatsApp. Per ognuna: nome, tipo, chi l'ha caricata, data, quanti task e quanti fatti confermati ne sono nati. Clicca il nome per leggerne il testo; la casella in alto cerca per nome, tipo o utente.
«Caricata da» è l'account che ha caricato il file o scritto la nota; per i messaggi WhatsApp arrivati da soli sono le persone che li hanno scritti. Per le fonti caricate prima del 15 novembre 2026 non è registrato. Una fonte segnata «elaborazione non completata» non ha finito l'estrazione: ricaricala, i duplicati vengono riconosciuti.
07Task attivi e bozze
La pagina di lavoro. I task aperti sono divisi per urgenza (alta media bassa), poi vengono quelli in attesa di risposta.
Come nasce l'urgenza. La propone l'AI leggendo il messaggio, poi la data la alza da sola: a 30 giorni o meno un task aperto è almeno media, a 7 giorni o meno è alta. La data che conta è quella del task (la scadenza, se l'hai messa, altrimenti check-in o partenza); se il task non ha una data vale la prossima data del tour. La data non abbassa mai l'urgenza. Se non sei d'accordo, apri Modifica e scegli tu: la tua scelta vince sempre e resta finché non rimetti «Automatica».
- 1Urgenza e tipo di task (alloggio, biglietto_treno, catering, pass…).
- 2Scrivi al fornitore: bozza di richiesta a chi deve fare la cosa (hotel, agenzia, catering).
- 3Rispondi al mittente: bozza di risposta a chi ha scritto il messaggio («ricevuto, ci pensiamo noi»).
- 4Prenota assistita (solo alloggi, treni, voli, auto): vedi Prenotazione assistita.
- 5Approva e invia: genera la bozza e la segna subito come inviata, senza revisione. Non spedisce nulla: serve quando la invii comunque tu (Vedi bozza › Apri in Gmail).
- 6Conferma nel grafo: l'informazione è già certa, scrivila tra i fatti del tour.
- 7Modifica: correggi descrizione, dati estratti e scadenza prima di confermare.
- 8Annulla task: scarta un task inutile o duplicato (non entra nel grafo).
- 9seleziona: per le azioni su più task insieme.
Il ciclo di vita di un task
| Stato | Cosa significa · come ci arriva |
|---|---|
| Da fare | Appena creato da un messaggio. Compare nella sezione della sua urgenza. |
| In attesa risposta | Hai inviato una richiesta al fornitore e premuto Inviata ✓: aspetti la sua risposta. |
| Fatto ✓ | Chiuso: risposta del fornitore arrivata, avviso inviato (es. al catering), chiuso a mano o con «Chiudi selezionati». Una risposta al mittente invece non cambia lo stato: rispondere a chi ha scritto non vuol dire aver fatto la cosa. |
| Confermato | Scritto nel grafo come fatto: sparisce dai task attivi e compare in Fatti confermati. |
| Annullato | Scartato. Non entra nel grafo. |
Le bozze: controlli tu, invii tu
Il tool non invia mai nulla da solo. Ogni bozza si apre già compilata nel programma giusto, la rileggi e premi Invia lì.
- 1Tipo di bozza: richiesta al fornitore, risposta via email o via WhatsApp.
- 2Il testo proposto, con oggetto e destinatario se noti.
- 3Apri in Gmail: apre una nuova mail con destinatario, oggetto e testo già scritti.
- 4Inviata ✓: premilo dopo aver inviato davvero. Una richiesta passa «in attesa risposta», un avviso chiude il task.
- 5Scarta: elimina la bozza (puoi generarne un'altra).
Se il testo non va bene, premi Scarta e rigenera, oppure correggilo direttamente in Gmail prima di inviare. Se usi più account Google,
Gmail si apre su quello indicato in GMAIL_ACCOUNT nel file .env.
Aspettare e registrare le risposte
- 1Simula risposta fornitore: in fase di prova crea una risposta finta (positiva o negativa) per vedere il ciclo completo.
- 2Vedi bozza: rileggi cosa era stato inviato.
- 3chiudi a mano: la conferma è arrivata per altra via (es. al telefono).
Il pulsante Scansiona risposte in alto legge le risposte arrivate: se il fornitore conferma, i dati confermati (hotel, date, numero di prenotazione…) diventano un fatto nel grafo e il task si chiude; se rifiuta, il task torna da fare. Al termine compare il riepilogo di cosa è stato registrato.
Azioni su più task
- 1Approva selezionati: genera e segna come inviate le bozze dei task selezionati.
- 2Chiudi selezionati: li segna come fatti.
- 3Approva tutti i pending: lo stesso per tutti i task da fare del tour. Chiede conferma.
Attenzione: «Approva» (singolo, selezionati o tutti) non invia mail o messaggi: genera le bozze e fa avanzare lo stato dei task come se fossero state inviate. Le richieste vanno comunque spedite da Gmail o WhatsApp (pulsante Vedi bozza sul task).
Paracadute: «Approva tutti i pending» salta sempre i task delicati, che restano da rivedere a mano: importi da 500 € in su, modifiche di prenotazioni esistenti (con numero di conferma), pagamenti, bonifici e fatture.
Incongruenze
- 1Cosa non torna e tra quali informazioni.
- 2Ignora quando hai verificato. Per correggere usa Modifica sul task o Correggi sul fatto.
Correggere un task
- 1Descrizione del task.
- 2Scadenza (opzionale).
- 3Salva correzioni: questa versione è quella che finirà nel grafo alla conferma.
Nei campi estratti (persone, date, città…) separa più nomi con la virgola. Correggere qui, prima della conferma, evita fatti sbagliati nel tourbook.
Categoria sbagliata. Se l'AI ha messo il task nella categoria sbagliata (per esempio un pasto finito sotto «Altro», o un treno segnato come aereo), cambiala dal menu Categoria e premi Salva correzioni: Alloggio, Treno, Aereo, Auto / transfer, Pasti / catering, Pass, Trasporto merci (bilici), Chiarimento, Altro. Il form resta aperto e mostra i campi della nuova categoria (per un alloggio: hotel, città, check-in, check-out…): compila quelli che servono e salva di nuovo. La categoria decide che tipo di bozza viene scritta, se compare «Prenota assistita» e che fatto entra nel grafo alla conferma. Si può cambiare finché il task non è confermato o annullato.
08Prenotazione assistita
Per alloggi, treni, voli e auto il tool può aprire il sito di prenotazione e compilare per te i campi che conosce (stazioni, città, persone). Scelta finale e pagamento li fai sempre tu sul sito.
- 1Il passo in cui ti trovi.
- 2I siti disponibili per quel tipo di task: clic per aprirlo e iniziare la compilazione.
- Premi Prenota assistita sul task e scegli il sito.
- Il sito si apre nel tuo Chrome con i dati compilati. Le date spesso vanno inserite a mano: i calendari dei siti non si lasciano compilare.
- Scegli l'offerta e completa il pagamento sul sito, come faresti normalmente.
- Torna nel tool e registra l'esito (Registra → grafo): la prenotazione diventa un fatto confermato.
Funzione opzionale: richiede un componente aggiuntivo (Chrome con un'estensione di supporto) configurato da chi gestisce il tool. Se manca, i pulsanti segnalano «non raggiungibile» e tutto il resto funziona normalmente.
09Fatti confermati e tourbook
Il grafo contiene solo ciò che una persona ha confermato. Da qui si correggono i dati e si generano i documenti del tour.
- 1Tourbook grafo: tutti i fatti in una pagina stampabile.
- 2Genera Tourbook Professionale: il tourbook completo, scaricabile in Word ed Excel.
- 3Totale CO₂ del tour e dettaglio.
- 4Un fatto: tipo, dati e collegamenti (persone, hotel, città), chi l'ha confermato e quando.
- 5Correggi il fatto.
- 6Rimuovi il fatto dal grafo (chiede conferma).
- 1Salva correzione: sostituisce il fatto (il precedente resta nello storico) e ricalcola subito CO₂ e pasti.
- 2Aggiungi come fatto in più: se una registrazione copre due cose (es. «Firenze e Torino»), correggi questa con la prima e aggiungi l'altra.
Per il calcolo della CO₂ servono città riconoscibili, una per campo («Firenze», non «Firenze e Torino»).
La fonte di ogni fatto
Sotto ogni fatto c'è la riga Fonte: il file da cui è nato (o «Nota manuale», la chat WhatsApp), il tipo, chi l'ha caricato e quando. Cliccando il nome si apre la fonte in Fonti caricate, con il suo testo.
Stesso soggetto, più etichette
In alto ci sono le etichette di persone, venue e fornitori del tour. Capita che lo stesso soggetto compaia con nomi diversi («Artista» ed «Elisa», «San Siro» e «Milano stadio») o che un'etichetta sia proprio sbagliata. Gli strumenti:
- Possibili doppioni (riquadro arancione in cima): il tool propone le coppie sospette, per esempio un nome contenuto in un altro («Conti» e «Federico Conti») o due grafie dello stesso nome. Unisci tiene il nome più completo, Al contrario tiene l'altro, Non sono la stessa toglie la coppia dai suggerimenti per sempre.
- Trascina un'etichetta sull'altra (dello stesso tipo) e conferma. Tutti i fatti dell'etichetta trascinata passano su quella di arrivo; il nome trascinato diventa un suo nome alternativo (il «+1» sull'etichetta). Da un telefono, dove il trascinamento non c'è, usa Unisci a un'altra etichetta nella scheda.
- Clicca un'etichetta (cioè apri la sua scheda) per: rinominarla (il nome vecchio resta come nome alternativo); vedere e aggiungere nomi alternativi, ad esempio «Artista» per Elisa, anche prima che compaiano; separare un'etichetta unita per sbaglio (sezione «Etichette unite qui»: torna com'era, con i suoi fatti); cambiarne il tipo, per un'etichetta finita nel tipo sbagliato (una Persona che è un Fornitore): se nel nuovo tipo c'è già un'etichetta con lo stesso nome, le due vengono unite; eliminarla se è sbagliata: i fatti restano nel grafo, perdono solo il collegamento a quell'etichetta.
Da quel momento, nel tour: i task che nominano «Artista», aperti o futuri, vengono intestati a Elisa; confermandoli, il fatto va sotto Elisa; tourbook, pasti e diete contano una persona sola. I nomi alternativi valgono solo per quel tour. Togliere un nome alternativo (✕ nella scheda) o separare due etichette non riscrive i nomi già cambiati nei task.
Cambiare la categoria di un fatto
In Correggi c'è il menu Categoria: se un fatto è finito nella categoria sbagliata (per esempio un soggiorno registrato come spostamento) scegli quella giusta. Il modulo mostra i campi della nuova categoria già compilati con i valori che corrispondono (la città d'arrivo diventa la città dell'hotel, la data diventa il check-in…): completa quelli che mancano e premi Salva correzione. Fino al salvataggio non cambia nulla; con «annulla il cambio» torni alla categoria di prima. Anche il task da cui il fatto è nato passa alla nuova categoria.
Tourbook grafo
- 1Stampa / Salva PDF: nella finestra di stampa scegli «Salva come PDF».
Tourbook professionale
Il documento da dare alla crew: travel party, itinerario, documenti, trasporti, merci, alloggi, pasti e diete, avvisi, info pratiche, guida per città, checklist, CO₂ e controlli sui dati. I dati vengono dal grafo; le parti generali (info pratiche, città) le scrive l'AI. La generazione richiede di solito un minuto, al massimo 2–3: non chiudere la pagina.
- 1Stampa / Salva PDF.
- 2Scarica Word: file .docx modificabile.
- 3Scarica Excel: file .xlsx con le tabelle.
- 4Rigenera testi: rifà le parti scritte dall'AI (altrimenti vengono riusate finché i dati del tour non cambiano).
Le sezioni con bordo tratteggiato si possono correggere direttamente nella pagina prima di stampare. Word ed Excel contengono i dati generati, non le correzioni fatte nella pagina: correggi nel file scaricato.
10Calendario e daily
- 1Clic su una data per il dettaglio del giorno.
- 2Scegli il periodo…
- 3…e apri il Report periodo stampabile, giorno per giorno.
- 1Stampa Daily: il daily sheet del giorno, da stampare o salvare in PDF.
- 2Torna al calendario.
Il dettaglio del giorno raccoglie i task, gli spostamenti e chi dorme in hotel quella notte. Le date si popolano da sole man mano che i messaggi le citano.
Correggere il calendario. Clicca il tipo di giornata, la città, la venue o le note di una data per modificarli: Invio salva, Esc annulla. Una correzione fatta a mano non viene più sovrascritta dai messaggi caricati dopo. Le date del calendario sono un riepilogo del tour, non fatti del grafo: per hotel, viaggi e persone correggi nelle viste rapide o in Fatti confermati.
11Viste rapide
Tabelle pronte per rispondere al volo a «dove dorme X?», «chi è celiaco?», «quando parte il bilico?».
Ogni vista ha tre parti:
- Confermati nel grafo (modificabili): i fatti confermati di quel tipo (soggiorni, spostamenti, pass, catering e diete, trasporti pesanti). Ogni campo si modifica cliccandolo: scrivi, poi Invio salva e Esc annulla. La modifica è una correzione nel grafo, come Correggi in Fatti confermati: il fatto viene sostituito (il precedente resta nello storico) e tourbook, CO₂ e pasti usano subito il nuovo valore. Le persone si scrivono separate da virgola. Per dividere un fatto in due (es. «Firenze e Torino») usa Correggi → a fine riga.
- Da confermare (sola lettura): i task aperti dello stesso tipo. Si correggono con Modifica sulla scheda del task e poi si confermano nel grafo.
- Tutto ciò che dicono i messaggi (chiuso, da aprire): i dati estratti da ogni messaggio, confermati o no, in sola lettura.
Roster. Mostra le persone del grafo: nome, ruolo, telefono, email e note si modificano allo stesso modo. Se cambi un nome, cambia in tutti i fatti di quella persona; se il nome nuovo è già nel roster il tool lo segnala, perché si tratta della stessa persona scritta in due modi. Il ruolo aggiorna anche il pass della persona. Sotto ci sono le persone citate nei messaggi ma non ancora confermate.
Se un salvataggio non riesce (per esempio una data di check-out prima del check-in) la cella torna al valore precedente e un avviso rosso in basso spiega il motivo.
- 1Le viste rapide nel menu: Roster, Alloggi, Spostamenti, Pass, Diete, Trasporti pesanti.
- 2Clic su un nome per il profilo della persona.
- 1Tourbook personale: il programma di quella persona (viaggi, hotel, pass), da stampare o mandare.
Più bilici sullo stesso viaggio. Se sette bilici fanno la stessa tratta lo stesso giorno il task è uno solo: apri Modifica e scrivi 7 in numero mezzi (bilici) sullo stesso viaggio. Le tonnellate sono sempre quelle di un mezzo, e la CO₂ è tonnellate per mezzo × km × numero di mezzi: sette bilici contano sette volte il singolo viaggio. Campo vuoto = 1 mezzo.
Tonnellate non note. Se conosci solo la classe del mezzo, scegli classe del mezzo nel form: il campo tonnellate per mezzo si riempie da solo con il valore di partenza della classe (32 per «>32t», 16 per «16-32t»). Quando conosci il peso vero scrivilo al suo posto: un numero inserito a mano non viene più toccato.
Alloggi. Nel Modifica di un task alloggio c'è numero camere: la CO₂ dell'hotel si calcola per camera e per notte, quindi per una prenotazione di gruppo indicalo sempre.
12Impronta CO₂
Una stima delle emissioni del tour calcolata dai fatti confermati: spostamenti, notti in hotel, trasporti pesanti e pasti dello staff.
Le voci n/d mancano di un dato (città non riconosciuta, km o tonnellate assenti): correggi il fatto e il totale si aggiorna subito. Le assunzioni usate per i pasti sono elencate sotto la tabella.
13Amministrazione
Solo per amministratori: Utenti e accessi (descritto sopra), il Collegamento WhatsApp (WhatsApp › 15.4) e il reset dei dati.
- 1Solo il tour aperto: cancella messaggi, task, date e fatti di quel tour. Gli altri restano.
- 2Tutto il database: come ripartire dal primo avvio (gli account restano, senza tour).
- 3Per confermare digita la parola indicata e premi Azzera.
Il reset è irreversibile e non crea backup. Se i dati servono, chiedi prima un backup a chi gestisce il server del tool.
14Gmail
Il collegamento diretto della casella Gmail al tool non è ancora disponibile: è in preparazione.
- Per ora le mail si caricano come file: in Gmail apri la mail › ⋮ › Scarica messaggio (file
.eml), oppure copiane il testo in un file.txt, e caricala da Carica messaggi con Tipo fonte: Email. Gli allegati (PDF, biglietti) si caricano a parte, come PDF o immagine. - Le bozze per i fornitori si aprono comunque in Gmail con Apri in Gmail (vedi Task attivi e bozze): quello funziona già.
L'etichetta Gmail che compare sulla scheda del tour (pagina Tour) servirà al collegamento diretto, quando sarà disponibile: per ora non serve configurarla.
15WhatsApp
WhatsApp entra nel tool in due modi: i messaggi scritti al numero WhatsApp del tour arrivano da soli (15.3), le altre chat si esportano e si caricano (15.1). Le risposte partono da WhatsApp con un clic (15.2).
15.1 · Esportare una chat e caricarla
iPhone
- Apri la chat o il gruppo e tocca il nome in alto.
- Scorri in fondo › Esporta chat › Senza media.
- Salvala in File (o inviala a te stesso via mail) e scompatta lo zip: dentro c'è
_chat.txt.
Android
- Apri la chat o il gruppo › menu ⋮ in alto a destra.
- Altro › Esporta chat › Senza media.
- Salvala su Drive o inviala via mail: è un file
.txt.
- Nel tool apri Carica messaggi, scegli Tipo fonte: WhatsApp e carica il
.txt. - Vocali, foto e PDF arrivati in chat: salvali e caricali con il tipo Audio, Immagine o PDF. Uno screenshot della chat va benissimo come immagine.
- Aggiornamenti della stessa chat: un file identico viene riconosciuto e saltato, ma una nuova esportazione contiene anche i messaggi vecchi
e verrebbe riletta tutta, creando task doppi. Per aggiornare, apri il
.txt, tieni solo i messaggi dopo l'ultimo caricamento, salvalo come nuovo file e carica quello. Eventuali doppioni si scartano con Annulla task.
15.2 · Rispondere su WhatsApp
Quando un task nasce da una chat, Rispondi al mittente prepara una risposta adatta a WhatsApp.
- 1La bozza è indicata come «Risposta al mittente · WhatsApp».
- 2Apri in WhatsApp: si apre WhatsApp (app o web) con il testo già scritto. Scegli tu la chat o il gruppo e invia: non serve conoscere il numero.
- 3Inviata ✓ dopo l'invio.
15.3 · Il numero WhatsApp del tour: come usarlo (per tutti)
Il tour ha un numero WhatsApp dedicato, gestito da un assistente di produzione. Quello che gli scrivi entra nel TM Tool da solo e in circa un minuto diventa un task, senza esportare né caricare niente. Il numero te lo dà l'amministratore del tool: salvalo in rubrica con un nome riconoscibile (es. «Produzione — nome del tour»).
- Scrivi un'informazione sul tour, in chat privata con il numero: «Fabio Fontana è celiaco, niente glutine», «Camera singola per Alessia Rossi a Roma dal 12 al 14 dicembre», «Il treno di Marta va spostato al 21».
- Aspetta la conferma: l'assistente risponde in una riga con quello che ha annotato, per esempio «Annotato ✅ Fabio Fontana è celiaco: niente glutine. L'ho passato alla produzione.»
- Ritrova il task nel tool: dopo circa un minuto è in Task attivi del tour collegato al numero, con la fonte «whatsapp». Da lì si lavora come per una mail: bozze, risposte, conferme.
Come scrivere bene: un'informazione completa per messaggio, con chi (nome e cognome), quando (data, orario) e dove (città, hotel, venue). Meglio un messaggio unico e completo che tre spezzati: ogni messaggio viene letto da solo, e uno a metà può diventare un task incompleto o doppio.
- Se l'assistente ti fa una domanda («Di chi è il treno?»), rispondi: gli manca un dato essenziale per annotare.
- Annota soltanto: non prenota, non conferma, non cancella e non paga. Le azioni le fa la produzione dal tool.
- Non risponde a domande sul tour («A che ora è il soundcheck?», «Ho l'hotel a Napoli?»): non vede i dati del tool e gira la richiesta alla produzione.
- Vocali: vengono trascritti e passati come testo. Foto e PDF arrivano solo se l'amministratore li ha attivati; altrimenti l'assistente ti dice che non può riceverli.
- Se risponde che c'è un problema tecnico, rimanda il messaggio più tardi: non è stato registrato. Succede anche se in un'ora arrivano troppi messaggi (vedi 15.5).
- Gruppi: il numero non può entrare nei gruppi già esistenti della band (regole di Meta, vedi 15.5). Per quei gruppi usa l'esportazione della chat (15.1).
Quello che scrivi lo legge la produzione e resta salvato: su WhatsApp, sulla piattaforma dell'assistente (Karacal) e nel TM Tool. Scrivi solo informazioni che servono al tour e non mandare documenti (passaporti, carte) se non te li chiede la produzione.
15.4 · Configurare il collegamento (amministratori)
Tutto si fa da Amministrazione›Collegamento WhatsApp, senza toccare il server. La pagina mostra se il collegamento è attivo, il tour collegato, l'ultimo messaggio ricevuto e quanti sono in attesa.
- Tour collegato: scegli il tour in cui devono finire i messaggi e premi Salva. Cambialo quando inizia un nuovo tour. Con «nessuno» i messaggi restano in attesa invece di diventare task.
- Genera token: il tool crea la chiave che permette all'assistente di consegnare i messaggi. Copiala subito: viene mostrata una sola volta.
- In Karacal: Integrations›Custom MCP server›collega. Name
TM Tool, URL quello mostrato nella pagina (finisce con/mcp), Bearer token = la chiave appena copiata, poi Add Server. Il messaggio «This server requires an API key / Bearer token» dopo Verify è normale. - Assistente: nella configurazione
Jessica-WhatsAppil server si aggiunge da Data Sources›Add›Apps & tools. Prima di modificare la configurazione ferma il deployment (Stop), poi salva e riavvialo (Start). Prompt e impostazioni sono nel runbookdocs/KARACAL_SETUP.md§ 10. - Prova: scrivi al numero un'informazione di test e controlla che dopo un minuto il task sia nel tour collegato.
- Messaggi in attesa: se l'elaborazione non riesce (per esempio l'AI non risponde) il messaggio non si perde. In Carica messaggi compare il riquadro WhatsApp — N messaggi in attesa: apri il tour giusto e premi Importa in questo tour.
- Rigenera token se la chiave è finita dove non doveva (mail, chat, documenti): quella vecchia smette subito di funzionare. Poi incolla la nuova in Karacal, altrimenti i messaggi non arrivano più.
- Spegni collegamento per interrompere l'arrivo dei messaggi (per esempio a fine tour). L'assistente risponderà che c'è un problema tecnico.
- Foto e PDF: si attivano nel deployment WhatsApp su Karacal (Allow images, Allow documents), con il deployment fermo.
- Limite orario: la pagina mostra quanti messaggi sono arrivati nell'ultima ora sul massimo consentito (60 di base).
Se compare limite raggiunto, i nuovi messaggi vengono rifiutati finché il conteggio non scende: chi scrive deve rimandarli più tardi.
Il massimo si cambia solo nella configurazione del server (
WHATSAPP_MAX_PER_HOUR). - Se la pagina dice Impostato sul server, token e tour vengono dal file di configurazione del server e si cambiano solo lì.
15.5 · Sicurezza e privacy
- Chi può consegnare messaggi al tool: solo l'assistente su Karacal, con il token. Il tool ne conserva solo un'impronta, il traffico è cifrato e senza token (o con il collegamento spento) l'indirizzo rifiuta tutto.
- Cosa può fare l'assistente: soltanto consegnare messaggi. Non legge i dati del tool, non prenota, non invia niente. Nel caso peggiore un messaggio sbagliato o malevolo crea un task inutile, che una persona vede prima di agire.
- Chi può scrivere al numero: chiunque ne conosca il numero, e i suoi messaggi diventano task. Il mittente indicato nel tool è il nome che l'assistente ricava dalla conversazione, non un'identità verificata. Dai il numero solo a crew e produzione e tratta i task WhatsApp come informazioni da verificare.
- Limite di messaggi: il tool accetta al massimo 60 messaggi all'ora (valore di base). Ogni messaggio costa alcune chiamate all'AI: il tetto evita che un errore o un abuso facciano partire migliaia di elaborazioni.
- Dove restano i messaggi: su WhatsApp, su Karacal (lo storico è visibile agli amministratori in Analytics) e nel TM Tool. Chi scrive al numero va informato. Diete, salute e documenti sono dati personali delicati.
- Gruppi: per le regole di Meta un numero business può stare solo in gruppi creati da lui, con al massimo 8 partecipanti e ingresso tramite link d'invito.
16Cosa si può fare (e cosa non ancora)
Un riepilogo per rispondere in fretta alla domanda «il TM Tool lo fa?».
Si può fare
- Gestire più tour separati e lavorarci in parallelo in schede diverse.
- Invitare colleghi con un link e decidere a quali tour accedono; rendere qualcuno amministratore o disattivarlo.
- Importare mail salvate come file (
.eml,.txt), chat WhatsApp/Telegram/SMS esportate, PDF, foto, screenshot, vocali e fogli Excel, Numbers o CSV. - Ricevere in automatico, come task, i messaggi scritti al numero WhatsApp del tour.
- Aggiungere informazioni a voce o a mano con la nota manuale e la dettatura.
- Ottenere i task con urgenza, le bozze per il fornitore o per il mittente, e aprirle già compilate in Gmail o WhatsApp.
- Approvare o chiudere più task insieme; vedere e ignorare le incongruenze tra messaggi.
- Correggere task e fatti, anche dopo la conferma nel grafo.
- Farsi compilare i siti di prenotazione di treni, voli, auto e hotel (prenotazione assistita).
- Stampare o salvare in PDF daily sheet, report di un periodo, tourbook del grafo e tourbook personali.
- Generare il tourbook professionale e scaricarlo in Word ed Excel.
- Stimare l'impronta CO₂ del tour.
- Fare domande all'assistente della guida.
Non si può fare (per scelta o non ancora)
- Inviare mail o messaggi dal tool: per scelta. Le bozze si inviano sempre da Gmail o WhatsApp, dopo averle controllate.
- Pagare o completare una prenotazione: per scelta. Scelta finale e pagamento li fai tu sul sito.
- Ricevere in automatico i gruppi WhatsApp esistenti: no, per le regole di Meta (vedi WhatsApp › 15.5). Arrivano da soli solo i messaggi scritti al numero del tour; per i gruppi si caricano le chat esportate.
- Collegare direttamente la casella Gmail: non ancora, è in preparazione. Per ora le mail si caricano come file (vedi Gmail).
- Ricevere Telegram o SMS in automatico: no, si caricano le esportazioni.
- Registrarsi senza invito o reimpostare la password da soli: no, serve un link dell'amministratore.
- Spostare task o fatti da un tour all'altro: no, ogni tour è separato.
- Ricaricare nel tool un tourbook modificato in Word o Excel: no, il file scaricato si modifica fuori dal tool.
- Annullare un reset: no, il reset è definitivo.
- Far vedere all'assistente i dati del tour o fargli fare azioni: no, risponde solo su come si usa il tool.
17Problemi frequenti
| Cosa vedi | Cosa fare |
|---|---|
| «Server non raggiungibile» | Il tool non risponde: controlla la connessione, riprova tra qualche minuto e, se continua, avvisa chi gestisce il tool. |
| «Link non valido» | L'invito è scaduto (7 giorni), già usato o revocato: chiedi all'amministratore un nuovo link. |
| «Non hai accesso a questo tour» | Il tour non è tra i tuoi: chiedi all'amministratore di assegnartelo. |
| «Nessuna Chiave API Karacal…» | Un servizio AI del tool non è configurato o è fermo: avvisa chi gestisce il tool. |
| «Caricato, ma non ha prodotto task» | Il messaggio non conteneva un'azione da organizzare: riformulalo indicando cosa fare, per chi, dove e quando (Carica messaggi). |
| «Non caricata per un problema di sistema» | L'elaborazione non è riuscita (spesso l'AI non risponde): riprova tra qualche minuto e, se continua, avvisa chi gestisce il tool. |
| Caricamento lento | Normale: ogni file richiede fino a un minuto. Non ricliccare. |
| Task doppio | Due messaggi dicevano la stessa cosa: Annulla task sul doppione. |
| Dato sbagliato nel tourbook | Correggilo alla fonte: clicca il campo nella vista rapida (o Correggi sul fatto in Fatti confermati), poi rigenera il tourbook. |
| «i file Numbers richiedono la libreria numbers-parser» | Il server non sa ancora leggere i file Numbers: in Numbers usa Archivio › Esporta › Excel e carica il .xlsx. |
| Il microfono non parte | Consenti il microfono al sito (icona a sinistra dell'indirizzo) e, su Mac, al browser in Impostazioni di Sistema › Privacy › Microfono. |
| Password dimenticata | Chiedi all'amministratore un Link nuova password. |
python tools/guide_screenshots.py.