Telegram
Anyy se connecte à Telegram avec un jeton de bot et le profil d’interrogation longue de Bot API. Il prend en charge les messages privés, groupes, médias entrants, associations et contrôles de santé en direct.
1. Créer un bot Telegram
Dans Telegram, ouvrez le compte officiel BotFather :
- Envoyez
/newbot. - Choisissez le nom affiché et le nom d’utilisateur du bot.
- Copiez une fois son jeton.
- Vérifiez les paramètres de confidentialité/groupes de BotFather si vous comptez l’ajouter à des groupes.
Traitez ce jeton comme un mot de passe. Toute personne le possédant peut agir comme le bot.
2. Ajouter le compte dans Anyy
Ouvrez Dashboard → Channel → Add → Telegram. Saisissez l’identifiant du compte et le jeton du bot pour l’entrée Bot API à interrogation longue. Utilisez l’assistant CLI ci-dessous pour les règles ; le formulaire d’identifiants Dashboard ne les inclut pas.
La configuration CLI est également disponible :
anyy setup channel
Choisissez Telegram dans l’assistant. La configuration enregistre le jeton comme référence de secret du profil et vérifie l’identité distante avec Telegram getMe avant que l’adaptateur devienne sain.
3. Choisir les règles d’accès
Les règles par défaut sont :
| Conversation | Valeur par défaut |
|---|---|
| Messages privés | pairing |
| Groupes | mention |
La règle des messages privés peut être open, allowlist, pairing ou disabled. Le catalogue actuel propose mention, allowlist, open ou disabled pour les groupes. Les listes d’autorisation existantes utilisent les identités numériques Telegram des utilisateurs/chats ; la configuration Telegram actuelle ne permet pas d’en modifier les entrées. Consultez les limites communes de configuration.
Un bot ouvert peut consommer le quota du fournisseur et exposer les outils à des expéditeurs inattendus. Vérifiez la règle d’accès et les outils activés avant d’élargir l’accès.
4. Démarrer et vérifier
anyy channel reload
anyy channel doctor telegram
Envoyez ensuite un message privé au bot. Avec la règle d’association par défaut, listez puis approuvez l’expéditeur en attente depuis la CLI :
anyy channel pairing list --channel telegram
anyy channel pairing approve --request REQUEST_ID
Après approbation, envoyez un autre message et vérifiez qu’Anyy répond dans la même conversation Telegram.
Groupes et mentions
Ajoutez le bot à un groupe et utilisez son @username avec la règle mention par défaut. Si les réglages de confidentialité Telegram l’empêchent de recevoir les messages de groupe voulus, modifiez-les dans BotFather et réajoutez/rechargez le bot selon les exigences de Telegram.
L’adaptateur actuel ne revendique aucune prise en charge des fils Telegram ; ne comptez pas sur un routage par sujet.
Médias et longues réponses
Anyy peut préparer les médias Telegram entrants pris en charge pour la session. Les longs textes sortants sont découpés selon la limite de l’adaptateur. Les téléchargements de médias et la taille des messages restent soumis aux limites de l’adaptateur et de Telegram.
Dépannage
| Symptôme | Points à vérifier |
|---|---|
| Jeton rejeté | Régénérez/copiez le jeton BotFather et remplacez l’identifiant enregistré |
| Le bot reste en temporisation | Lancez anyy channel doctor telegram ; vérifiez getMe et l’accès réseau à Bot API |
| Le message privé reçoit un avis d’association mais aucune réponse | Approuvez la demande, puis envoyez un nouveau message |
| Message de groupe ignoré | Mentionnez le bot, vérifiez la règle/liste d’autorisation et le mode de confidentialité BotFather |
| Messages anciens ou en double | Inspectez la santé de l’interrogation longue et rechargez ; Anyy conserve le décalage de mise à jour Telegram |
Pour les commandes communes des canaux, consultez Plateformes de messagerie.