Telegram

Tous les connecteursBoîte de réceptionTelegram

Configuration rapide#

Si l'option Créer avec un QR code est disponible sur le connecteur Telegram, sélectionnez-la, scannez le QR code ou choisissez Ouvrir Telegram, puis appuyez sur Créer le bot dans le bot de configuration. Revenez dans Make Agent Fast, vérifiez le nom d'utilisateur du bot, puis sélectionnez Connecter ce bot. Aucune copie de token n'est nécessaire. La configuration expire au bout de 15 minutes ; vous pouvez l'annuler et la relancer.

Si la configuration rapide n'est pas disponible, utilisez Se connecter avec un token de bot ci-dessous. Les deux méthodes appliquent les mêmes vérifications de connexion et la même confirmation de remplacement.

Le formulaire de création suggère le nom d'affichage de votre agent et un nom d'utilisateur au format maf_<agent>_<random>_bot. Les deux sont modifiables ; la partie aléatoire réduit les collisions de noms, mais c'est Telegram qui effectue la vérification finale de disponibilité. Les bots existants ne sont pas renommés.

Une fois le bot créé, le bot de configuration envoie un bouton Connecter ce bot qui ouvre l'écran d'examen de connexion authentifié de votre agent. La création du bot ne suffit pas à le connecter. Une fois la confirmation réussie, Ouvrir le bot vous mène à la conversation pour effectuer vos tests. /start ou /help rétablit une configuration active ou affiche les boutons du tableau de bord et du guide.

Créer et préparer un bot manuellement#

Suivez l'Introduction to Bots officielle de Telegram et le guide BotFather :

1. Ouvrez le compte vérifié @BotFather dans Telegram.
2. Lancez /newbot, choisissez un nom d'affichage, puis un nom d'utilisateur unique se terminant par bot.
3. Copiez le token du bot. Toute personne possédant ce token contrôle le bot.
4. Si vous le souhaitez, configurez la photo, la description, le texte « À propos » et l'aide localisée des commandes dans BotFather avant le lancement.

Le token sert à l'API Telegram Bot ; ce n'est ni un code de connexion Telegram, ni un API ID, ni un API hash.

Se connecter dans Make Agent Fast#

Ouvrez la page Canaux de l'agent, choisissez Telegram, collez le Token du bot, indiquez si les réponses compatibles doivent aussi être énoncées à voix haute, puis sélectionnez Connecter.

Make Agent Fast appelle getMe de Telegram pour valider le token et afficher le nom d'utilisateur du bot. Il appelle ensuite setWebhook avec l'URL HTTPS publique du connecteur, un token de vérification secret, et message, callback_query et my_chat_member comme types de mises à jour acceptés. Les mises à jour en attente existantes ne sont pas supprimées.

Aucune étape manuelle de webhook n'est normalement requise. Arrêtez tout service de polling avant de vous connecter. Si le bot dispose d'un autre récepteur de webhook, examinez et confirmez son remplacement ; Make Agent Fast ne le reprend jamais silencieusement. Un agent peut répondre sur jusqu'à cinq bots Telegram simultanément ; chaque bot constitue sa propre connexion. Enregistrer un autre bot ajoute une nouvelle connexion au lieu de remplacer la connexion actuelle. Un bot déjà rattaché à un autre agent doit d'abord y être déconnecté.

Tester la conversation#

1. Ouvrez le lien t.me du bot depuis un compte Telegram qui n'est pas celui du propriétaire.
2. Sélectionnez Démarrer ; les bots ne peuvent pas initier une conversation avec un utilisateur.
3. Envoyez une question textuelle dont la réponse figure dans vos sources.
4. Envoyez un message vocal si la voix est activée.
5. Vérifiez que les réponses arrivent, que Dernier message change et que le fil apparaît dans Conversations.

Les messages privés sont publics par défaut : les visiteurs n'ont pas besoin de l'approbation du propriétaire. Les réponses dans les groupes sont désactivées tant que le propriétaire n'active pas Répondre dans les groupes lorsque le bot est mentionné ou qu'on lui répond. Le mode confidentialité de Telegram (Privacy Mode) et les autorisations du groupe continuent de s'appliquer. Testez d'abord les messages directs.

Fonctionnement de la voix#

Telegram prend en charge la voix entrante et la voix sortante dans ce connecteur. La voix entrante est téléchargée puis transcrite avant le tour de l'agent. Lorsque Répondre par la voix est activé et qu'un fournisseur de synthèse vocale est disponible, Make Agent Fast envoie une réponse vocale/audio en plus du texte. Si la transcription ou la synthèse vocale échoue, demandez à l'utilisateur de réessayer par écrit et consultez l'erreur du connecteur.

Renouveler, désactiver ou supprimer#

Si le token est exposé, générez-en un nouveau ou révoquez-le immédiatement dans BotFather, mettez à jour le connecteur avec le nouveau token, puis testez à nouveau. La mise à jour des identifiants d'un même bot conserve ses paramètres et son statut de pause. Le remplacer par un autre bot nécessite une confirmation et conserve l'historique du bot précédent séparé.

Désactiver un bot arrête les réponses en local ; le supprimer archive la connexion et conserve son historique. Aucune de ces actions ne supprime le bot Telegram ni n'appelle deleteWebhook, ce qui pourrait perturber un récepteur plus récent. Les connexions archivées ignorent les messages entrants. Les bots créés via la configuration rapide peuvent actualiser leurs identifiants après des événements du cycle de vie côté gestionnaire, mais un bot en pause reste en pause et un changement de propriétaire désactive la connexion en vue d'un examen.

Dépannage#

Ne collez jamais un token actif dans de la documentation, du code source, des outils d'analyse ou une capture d'écran destinée au support.