Utilisez cet article pour connecter un bot Telegram à votre espace de travail Intercom, comprendre ce qui se passe une fois la connexion active, et savoir quoi faire en cas de déconnexion. Après l'installation, les conversations Telegram apparaissent dans l'Inbox avec tous les autres canaux, Fin les gère automatiquement, et les Workflows s'appliquent pleinement.
Ce dont vous aurez besoin avant de connecter
Vous aurez besoin d'un accès administrateur dans votre espace de travail Intercom pour connecter ou déconnecter un canal Telegram.
Avant de connecter, vous aurez besoin d'un bot Telegram et de votre jeton de bot (un identifiant qui donne à Intercom la permission d'envoyer et de recevoir des messages pour votre bot). Créez un bot via @BotFather (le bot officiel de Telegram pour créer et gérer les bots) voir la documentation de Telegram pour les instructions étape par étape.
Note : Votre jeton de bot donne un contrôle total sur le bot. Gardez-le sécurisé et ne le partagez pas au-delà de ce qui est nécessaire pour la connexion Intercom.
Comment connecter Telegram
Ayez votre jeton de bot de @BotFather prêt avant de commencer.
Allez à Paramètres > Canaux > Telegram.
Collez votre jeton de bot dans le champ Jeton de bot.
Cliquez sur Connecter.
Une fois connecté :
Intercom valide votre jeton de bot.
Le webhook (le point de connexion qui reçoit les messages de Telegram) est enregistré, reliant votre bot Telegram à l'Inbox.
L'installation est enregistrée dans le Journal d'activité des coéquipiers (Paramètres > Sécurité > Activité des coéquipiers).
Le canal Telegram apparaît comme actif sous Paramètres > Canaux > Telegram une fois l'installation terminée. Pour vérifier la connexion, envoyez un message test à votre bot Telegram — il devrait apparaître comme une nouvelle conversation dans votre Inbox Intercom en quelques secondes.
Puis-je utiliser le même bot sur plusieurs espaces de travail ?
Chaque bot Telegram ne peut être connecté qu'à un seul espace de travail Intercom à la fois. Si vous essayez de connecter un bot déjà utilisé sur un autre espace de travail, la connexion échouera.
Comment déconnecter Telegram
Pour déconnecter, allez à Paramètres > Canaux > Telegram et cliquez sur Déconnecter.
Les conversations existantes dans l'Inbox ne sont pas affectées lors de la déconnexion, elles restent accessibles et peuvent toujours être gérées par les coéquipiers. Cependant, les clients ne pourront pas envoyer de nouveaux messages au bot tant qu'il n'est pas reconnecté.
Important : La déconnexion supprime définitivement le jeton de bot et le secret du webhook (un identifiant de sécurité lié à la connexion webhook) d'Intercom. Ces identifiants ne peuvent pas être récupérés. Pour reconnecter, vous devrez régénérer votre jeton de bot via @BotFather et refaire l'installation.
Envoyez des formulaires de ticket hébergés aux clients Telegram
Vous pouvez collecter des informations structurées de vos clients Telegram en leur envoyant un formulaire de ticket hébergé — de la même manière que sur Discord, Slack et WhatsApp. Le client vérifie son identité d'un simple tap grâce à la connexion intégrée de Telegram, puis remplit et soumet le formulaire sans quitter le chat.
Note : L'envoi de formulaires de ticket hébergés aux clients Telegram est actuellement en version bêta.
Définissez le domain de votre bot dans BotFather
Le widget de connexion de Telegram ne fonctionne que sur un domain enregistré avec votre bot. Vous devez le définir une fois par bot — le domain dépend de la région d'hébergement de votre espace de travail :
Région | Domain à définir |
États-Unis | app.intercom.com |
Europe | app.eu.intercom.com |
Australie | app.au.intercom.com |
Ouvrez un chat avec @BotFather dans Telegram.
Envoyez
/setdomain.Sélectionnez votre bot.
Envoyez le domain correspondant à votre région dans le tableau ci-dessus.
Note : Si vous ne savez pas dans quelle région se trouve votre espace de travail, vérifiez l'URL que vous utilisez pour vous connecter à Intercom — elle correspond à l'un des domains ci-dessus. Définir le domain d'une mauvaise région empêchera l'apparition du widget de connexion.
Envoyez un formulaire à un client Telegram
Ouvrez la conversation Telegram dans votre Inbox.
Dans le composeur de réponse (ou via les actions
⌘K/Ctrl+K), choisissez d'envoyer un formulaire de ticket hébergé.Choisissez le formulaire et envoyez-le. Le client reçoit un lien dans le chat Telegram.
Ce que le client voit
Il ouvre le lien depuis le chat.
Il est invité à vérifier son identité avec le bouton Se connecter avec Telegram.
Après un tap, le formulaire s'ouvre — il le remplit et le soumet.
Le ticket soumis apparaît dans la conversation, comme tout autre formulaire de ticket hébergé.
Dépannage
Le bouton de connexion n'apparaît pas — le domain du bot n'est pas défini, ou le domain d'une mauvaise région a été utilisé. Relancez
/setdomaindans BotFather avec le domain correct pour votre région.« Vérification échouée » après avoir tapé sur se connecter — confirmez que le bot connecté à votre intégration Telegram correspond au bot pour lequel vous avez défini le domain.