Connecter FoneClaw à un bot Telegram : créer, associer et vérifier
Guide pour connecter FoneClaw à un bot Telegram privé : créer le bot avec BotFather, associer votre compte, tester une tâche Android et corriger les erreurs courantes.
- Pour connecter FoneClaw à un bot Telegram, créez un bot dédié avec le BotFather officiel, récupérez son token et gardez ce token privé comme un mot de passe du bot.
- Dans FoneClaw, enregistrez le token, ouvrez votre propre bot Telegram, envoyez hello dans les dix minutes et attendez la confirmation d’association avant d’utiliser la conversation.
- Une réponse dans Telegram confirme que la demande arrive à FoneClaw ; elle ne remplace pas les permissions Android, les approbations applicables ni la vérification du résultat enregistré.
- En cas d’erreur, distinguez token invalide, mauvais bot, fenêtre d’association expirée, bot déjà utilisé, réseau indisponible et conflit avec un autre programme qui reçoit déjà les messages du bot.
Créer un bot Telegram dédié
Pour connecter FoneClaw à un bot Telegram, commencez par créer un bot séparé. Cette connexion n’est pas la même chose que contrôler l’application Telegram par la voix. Ici, Telegram sert de conversation privée pour envoyer une demande à FoneClaw ; l’action Android reste exécutée par FoneClaw sur le téléphone, avec les permissions nécessaires.
Dans Telegram, ouvrez le tutoriel officiel Telegram sur BotFather et utilisez le compte vérifié @BotFather. La commande utile est /newbot. BotFather vous demandera un nom et un identifiant de bot, puis fournira un token unique. Ce token authentifie le bot auprès de Telegram. Ce n’est pas votre mot de passe Telegram personnel, ni un code de connexion à votre compte, mais il doit rester privé : toute personne qui le possède peut tenter d’utiliser ce bot.
Utilisez de préférence un bot dédié à FoneClaw. Cela évite les conflits avec un autre service déjà relié au même bot et rend le dépannage plus simple. Si votre besoin est de piloter Telegram à la voix depuis le téléphone, gardez cette procédure séparée : le guide Contrôler Telegram par la voix traite cet usage distinct.
Associer votre compte privé
Dans FoneClaw, utilisez le champ BotFather token pour coller le token fourni par BotFather, puis appuyez sur Save bot token pour l’enregistrer. Après l’enregistrement, ne retournez pas parler à BotFather pour l’association. Ouvrez votre propre bot Telegram, celui que vous venez de créer, puis envoyez hello.
L’association attend ce premier message pendant dix minutes. Elle concerne uniquement les conversations privées : la connexion se lie au compte Telegram qui envoie le premier message au bot. Si une autre personne envoie le premier message depuis son compte, ce compte peut être associé. Cette règle impose de vérifier le bon bot et le bon compte avant d’envoyer hello.
Attendez le message de confirmation avant de commencer à discuter avec FoneClaw via Telegram. Si rien ne se passe, vérifiez d’abord que le token enregistré correspond au bot ouvert et que vous êtes bien dans une conversation privée avec ce bot. Si la fenêtre a expiré, appuyez sur Connect this chat sur votre téléphone, puis envoyez de nouveau hello à votre propre bot pendant la nouvelle fenêtre de dix minutes indiquée et attendez la confirmation.
Vérifier un premier résultat Android pris en charge
Une fois l’association confirmée, testez avec une demande Android simple. Évitez une action sensible pour le premier essai. Par exemple, envoyez au bot : « Crée une tâche : préparer les points pour l’appel client ». Cette demande ne contient aucune date, aucun jour et aucun repère relatif ; la tâche doit donc rester sans échéance.
La réussite ne se limite pas à recevoir une réponse dans Telegram. Cette réponse confirme que FoneClaw reçoit votre demande, mais l’action doit ensuite être prise en charge côté Android. FoneClaw peut avoir besoin de permissions ou d’une approbation selon le cas. Vérifiez le résultat dans l’endroit prévu pour les tâches personnelles. Pour comprendre pourquoi une demande sans date doit rester non planifiée, consultez Tâche IA Android sans date : l’enregistrer sans risque.
Si vous découvrez FoneClaw, commencez aussi par le guide Installer FoneClaw sur Android et réussir sa première tâche IA. Il explique comment choisir une petite action, contrôler les permissions et confirmer le résultat. La connexion Telegram est seulement un point d’entrée supplémentaire ; elle ne donne pas accès à tous vos chats Telegram personnels et ne transforme pas chaque message en action automatique.
Diagnostiquer l’erreur de connexion précise
Si la connexion échoue, cherchez l’erreur précise plutôt que de recommencer toute la configuration. Les causes les plus fréquentes se distinguent bien : token invalide, mauvais bot ouvert, message hello envoyé hors délai, bot déjà utilisé par une connexion, réseau indisponible ou conflit avec un autre programme qui reçoit déjà les messages du bot.
| Symptôme | Cause probable | Action sûre |
|---|---|---|
| Le token est rejeté | Token incomplet, copié avec une erreur ou remplacé | Retournez dans BotFather, copiez le token du bon bot et enregistrez-le à nouveau |
| Aucune confirmation après hello | Mauvais bot, fenêtre d’association expirée ou conversation non privée | Vérifiez le bon bot et la conversation privée. Si la fenêtre a expiré, appuyez sur Connect this chat sur votre téléphone, puis envoyez hello à votre propre bot pendant la nouvelle fenêtre de dix minutes indiquée |
| Le bot est déjà connecté | Ce bot est peut-être déjà utilisé par une connexion FoneClaw | Vérifiez l’usage actuel du bot ou créez un bot dédié pour cette connexion |
| Telegram est inaccessible | Réseau ou accès Telegram indisponible | Vérifiez la connexion, puis réessayez sans changer inutilement le token |
| Conflit avec un autre service | Un autre programme reçoit déjà les messages du bot | Préférez créer un bot dédié ; supprimez le webhook seulement si vous voulez arrêter la livraison vers cet ancien service |
Le point le plus important concerne le webhook. Le retirer arrête la livraison vers l’adresse actuellement configurée pour ce bot. Si le bot sert déjà à un autre outil, cette suppression peut interrompre cet outil. Pour éviter ce risque, le choix le plus propre est souvent de créer un nouveau bot avec BotFather et de le réserver à FoneClaw.
Mettre en pause, reprendre ou supprimer la connexion
FoneClaw propose des contrôles pour gérer la connexion après l’association. Le bouton Pause connection sert à interrompre la réception sans supprimer toute la configuration. Le bouton Resume connection sert à reprendre une connexion mise en pause. Si vous mettez la connexion en pause, pensez à la reprendre avant d’attendre une réponse depuis Telegram.
Mettre à jour le token conserve l’association et l’historique de discussion local. En revanche, supprimer la connexion a un effet plus fort côté FoneClaw : la suppression retire le token enregistré, les demandes en file et les enregistrements de livraison ; l’historique local de chat reste conservé. Cette suppression locale ne révoque pas à elle seule le token côté Telegram. Si vous voulez neutraliser le bot ou remplacer son token, faites aussi les actions nécessaires dans BotFather.
Pour vérifier ce que FoneClaw peut faire après la connexion, consultez Fonctionnalités FoneClaw. La connexion Telegram est un moyen de demander une action, pas une promesse d’automatisation permanente ni de prise en charge de tous les groupes, canaux ou chats personnels. Pour installer l’application actuelle sur votre téléphone, utilisez Télécharger FoneClaw, puis testez une tâche simple et visible avant de confier des demandes plus longues.