📱Telegram

Parlez à vos sessions depuis votre téléphone. Harness Maxxing inclut sa propre passerelle Telegram : aucun programme supplémentaire à installer.

• Un seul bot, relié uniquement à votre conversation privée.
• Un fil par session ouverte - la conversation Telegram reflète la page Sessions - plus Crons (rapports des tâches), Alertes (alertes de connexion) et Notifications (le flux de notifications : ventes, commandes, vos scripts… selon les règles que vous avez définies, publiées par le bot lui-même, avec un bouton Ask Harness). Un fil s'appelle <projet>/<sujet> · <titre de la session>, précédé de l'émoji du projet s'il en a un (menu … du projet dans Sessions -> Définir un émoji…), par exemple 🛒 acme/blog · Launch plan. Changer l'émoji renomme les fils.
• Un fil est la session elle-même : ce que vous écrivez sur le téléphone apparaît dans l'interface web et vous pouvez continuer là-bas, et inversement.
• Écrivez dans la conversation principale (ou créez un fil) pour démarrer une nouvelle session : le bot demande dans quel sujet.

Configuration (Paramètres -> Telegram)

1. Dans Telegram, ouvrez @BotFather, envoyez /newbot, choisissez un nom et un nom d'utilisateur se terminant par bot. Copiez le jeton qu'il vous donne (123456789:AA...).
2. Dans BotFather, ouvrez les paramètres de votre bot et activez les sujets (fils) pour les conversations privées, afin que chaque session ouverte ait son propre fil. Sans cela, tout fonctionne dans la conversation principale (utilisez /topic pour choisir le sujet avec lequel il discute).
3. Collez le jeton dans Paramètres -> Telegram. Le serveur le vérifie.
4. Cliquez sur Lier, ouvrez sur votre téléphone le lien t.me/<bot>?start=<code> et appuyez sur Start. Le code est valable 15 minutes. À partir de là, les messages de toute autre conversation sont ignorés.
5. Cliquez sur Synchroniser les fils (ensuite, c'est automatique : voir plus bas).
6. Choisissez les options : rapports des crons, alertes de connexion, connexion en deux étapes, mode de réponse (progression en direct, par défaut = un seul message d'état mis à jour pendant que Claude travaille, avec sa liste de tâches et chaque étape, replié en un résumé à la fin ; réponse finale = seulement la réponse). Appuyez sur Envoyer un test.

Fils = sessions ouvertes

Sessions reflétées : celles avec lesquelles vous discutez (pas celles lancées par des tâches planifiées - leurs rapports vont dans Crons), non archivées, actives au cours des 30 derniers jours (Paramètres -> Telegram -> Garder un fil pendant : 7, 14, 30 ou 90 jours), 50 au maximum. Une session plus ancienne retrouve simplement son fil quand elle est de nouveau utilisée. La synchronisation s'exécute quelques secondes après chaque changement et toutes les 10 minutes ; rien à planifier. Si Telegram refuse un instant de supprimer un fil (trop de requêtes, pas de connexion), la synchronisation suivante le supprime. Renommer une session renomme son fil : Telegram affiche une petite ligne « sujet renommé » dans le fil.

Utilisation

• Écrivez dans le fil d'une session : Claude répond dans ce fil. Pendant qu'il travaille, vous voyez « est en train d'écrire… » et, pour les tâches plus longues, le message d'état en direct.
• Envoyez des photos et des fichiers : ils sont enregistrés dans <topic>/attachments/telegram/YYYY-MM/ et transmis à Claude avec votre légende.
• Commandes :

• La cloche d'une session (interface web, à côté de son titre) : avec le miroir désactivé (par défaut), elle publie un court message « terminé » dans le fil de la session quand un tour se termine ; avec le miroir activé, elle fait sonner les réponses reflétées.

Connexion en deux étapes

Paramètres -> Telegram (ou Paramètres -> Sécurité) -> Connexion en deux étapes : après le bon mot de passe, un navigateur qui n'est pas encore de confiance attend votre approbation dans Telegram. Le fil Alertes reçoit un message avec l'IP, le navigateur, un code à 6 chiffres et deux boutons :

• Autoriser : la page de connexion s'ouvre toute seule ;
• Refuser : la connexion est refusée - et comme le bon mot de passe a été saisi, changez-le (Paramètres -> Sécurité).

Quand les boutons ne répondent pas, saisissez le code du message sur la page de connexion. Une demande expire au bout de 2 minutes ; 5 codes erronés l'annulent, et après 20 codes erronés en une heure sur l'ensemble du serveur, les codes sont suspendus pendant l'heure (le bouton Autoriser fonctionne toujours) - quelqu'un qui connaît le mot de passe ne peut pas essayer des codes depuis de nombreuses adresses. Une page de connexion rouverte remplace sa demande précédente. Faire confiance à ce navigateur pendant 30 jours (coché par défaut) évite la deuxième étape sur ce navigateur ; Oublier les navigateurs de confiance oblige tous les autres navigateurs à redemander (changer le mot de passe le fait aussi). Changer le mot de passe, oublier les navigateurs ou désactiver la connexion en deux étapes annule aussi toutes les demandes encore en attente, même une que vous auriez autorisée par erreur.

L'activer envoie une première demande : elle n'est réellement activée qu'une fois que vous l'avez approuvée, de sorte qu'un bot qui ne répond pas ne peut pas vous bloquer l'accès. Délier Telegram la désactive.

Telegram ne répond pas (bot supprimé, Telegram en panne, téléphone perdu) : sur le serveur, en SSH,

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

Dépannage

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

Pour vous déconnecter : Paramètres -> Telegram -> Délier (oublie le jeton et la conversation).