📱Telegram

Parla con le tue sessioni dal telefono. Harness Maxxing include un suo gateway Telegram: nessun programma aggiuntivo da installare.

• Un solo bot, collegato solo alla tua chat privata.
• Un thread per ogni sessione aperta - la chat Telegram rispecchia la pagina Sessioni - più Crons (report dei job), Alerts (avvisi di accesso) e Notifications (il feed delle notifiche: vendite, ordini, i tuoi script… secondo le regole che imposti, pubblicate dal bot stesso, con un pulsante Ask Harness). Un thread si chiama <project>/<topic> · <session title>, con l'emoji del progetto davanti quando ce n'è una (menu … del progetto in Sessioni -> Imposta un'emoji…), ad esempio 🛒 acme/blog · Launch plan. Cambiando l'emoji i thread vengono rinominati.
• Un thread è la sessione stessa: quello che scrivi dal telefono compare nell'interfaccia web e puoi continuare lì, e viceversa.
• Scrivi nella chat principale (o crea un thread) per avviare una nuova sessione: il bot ti chiede in quale topic.

Configurazione (Impostazioni -> Telegram)

1. In Telegram, apri @BotFather, invia /newbot, scegli un nome e un nome utente che termini con bot. Copia il token che ti dà (123456789:AA...).
2. In BotFather, apri le impostazioni del tuo bot e attiva i topic (thread) per le chat private, così ogni sessione aperta ha il suo thread. Senza, tutto funziona nella chat principale (usa /topic per scegliere con quale topic parlare).
3. Incolla il token in Impostazioni -> Telegram. Il server lo verifica.
4. Clicca Collega, apri sul telefono il link t.me/<bot>?start=<code> e premi Start. Il codice è valido 15 minuti. Da quel momento, i messaggi provenienti da qualsiasi altra chat vengono ignorati.
5. Clicca Sincronizza i thread (in seguito è automatico: vedi sotto).
6. Scegli le opzioni: report dei cron, avvisi di accesso, accesso in due passaggi, modalità di risposta (avanzamento in tempo reale, quella predefinita = un messaggio di stato aggiornato mentre Claude lavora, con la sua lista di attività e ogni passaggio, ridotto a un riepilogo alla fine; risposta finale = solo la risposta). Premi Invia test.

Thread = sessioni aperte

Sessioni rispecchiate: quelle con cui parli (non quelle avviate dai job pianificati - i loro report vanno in Crons), non archiviate, attive negli ultimi 30 giorni (Impostazioni -> Telegram -> Mantieni un thread per: 7, 14, 30 o 90 giorni), al massimo 50. Una sessione più vecchia riottiene semplicemente il suo thread quando viene usata di nuovo. La sincronizzazione parte qualche secondo dopo ogni modifica e ogni 10 minuti; non c'è nulla da pianificare. Se Telegram rifiuta per un momento di eliminare un thread (troppe richieste, nessuna connessione), la sincronizzazione successiva lo elimina. Rinominare una sessione rinomina il suo thread: Telegram mostra nel thread una piccola riga "topic rinominato".

Come si usa

• Scrivi nel thread di una sessione: Claude risponde in quel thread. Mentre lavora vedi "sta scrivendo…" e, per i compiti più lunghi, il messaggio di stato in tempo reale.
• Invia foto e file: vengono salvati in <topic>/attachments/telegram/YYYY-MM/ e passati a Claude insieme alla tua didascalia.
• Comandi:

• La campanella di una sessione (interfaccia web, accanto al titolo): con il mirror disattivato (predefinito) pubblica un breve messaggio "terminato" nel thread della sessione quando un turno finisce; con il mirror attivo fa suonare le risposte rispecchiate.

Accesso in due passaggi

Impostazioni -> Telegram (o Impostazioni -> Sicurezza) -> Accesso in due passaggi: dopo la password corretta, un browser non ancora affidabile attende la tua approvazione in Telegram. Il thread Alerts riceve un messaggio con l'IP, il browser, un codice di 6 cifre e due pulsanti:

• Consenti: la pagina di accesso si apre da sola;
• Nega: l'accesso viene rifiutato - e dato che è stata digitata la password corretta, cambiala (Impostazioni -> Sicurezza).

Quando i pulsanti non rispondono, digita il codice del messaggio nella pagina di accesso. Una richiesta scade dopo 2 minuti; 5 codici errati la annullano, e dopo 20 codici errati in un'ora sull'intero server i codici vengono sospesi per quell'ora (il pulsante Consenti funziona comunque) - chi conosce la password non può provare codici da molti indirizzi. Una pagina di accesso riaperta sostituisce la sua richiesta precedente. Considera attendibile questo browser per 30 giorni (selezionato di default) salta il secondo passaggio su quel browser; Dimentica i browser attendibili fa sì che ogni altro browser chieda di nuovo (anche cambiare la password ha lo stesso effetto). Cambiare la password, dimenticare i browser o disattivare l'accesso in due passaggi annulla anche ogni richiesta ancora in attesa, persino una che hai consentito per errore.

Attivarlo invia una prima richiesta: viene attivato davvero solo dopo la tua approvazione, così un bot che non risponde non può escluderti. Scollegare Telegram lo disattiva.

Telegram non risponde (bot eliminato, Telegram fuori servizio, telefono perso): sul server, tramite SSH,

maxxing 2fa off             # password only again (every trusted browser is forgotten)
maxxing 2fa status          # on / off

Risoluzione dei problemi

maxxing telegram status     # bot, chat, threads, settings, last error
maxxing telegram test       # sends a test message

Per scollegare: Impostazioni -> Telegram -> Scollega (dimentica il token e la chat).