> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Telegram ## Vue d’ensemble Connectez vos agents IA ElevenLabs à Telegram pour répondre aux messages envoyés à votre bot. Cette intégration permet à vos agents de recevoir les messages entrants dans les discussions privées et les groupes, de consulter les informations des discussions, d’envoyer des réponses et de réagir aux messages via l’API Telegram Bot. ## Fonctionnalités | Fonctionnalité | Prise en charge | | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------- | | Mode zéro rétention (ZRM) | Non pris en charge | | Pièces jointes dans les déclencheurs | Non prises en charge, les photos, fichiers et autres médias des messages entrants ne sont pas transmis à l’agent | | Pièces jointes dans les outils | Non prises en charge, les outils fonctionnent uniquement avec du texte | ## Configuration #### Créer un bot Telegram Ouvrez Telegram et démarrez une conversation avec [@BotFather](https://t.me/BotFather). Envoyez `/newbot` et suivez les instructions pour choisir un nom et un nom d’utilisateur pour votre bot. BotFather vous répondra avec un jeton de bot. #### Se connecter dans ElevenLabs Dans la configuration de l’intégration ElevenLabs, cliquez sur **Connect** et collez le jeton de bot fourni par BotFather. #### Activer le déclencheur Après la connexion, activez le déclencheur **Telegram Message** et sélectionnez l’agent qui doit traiter les messages entrants. ElevenLabs enregistrera automatiquement un webhook auprès de Telegram afin que votre bot commence à recevoir des messages. ## Utiliser le bot dans les groupes Le bot n’a **pas** besoin d’être administrateur du groupe, et vous n’avez **pas** besoin de désactiver le [mode confidentialité](https://core.telegram.org/bots/features#privacy-mode) de Telegram. Lorsque le mode confidentialité est activé, ce qui est le cas par défaut, Telegram transmet les messages qui s’adressent explicitement au bot, exactement ceux que cette intégration écoute : * Les **mentions avec `@`** du nom d’utilisateur du bot, par exemple `@my_bot quel est le statut ?`. * Les **réponses aux propres messages du bot**, y compris les échanges de suivi au sein de la même conversation. Les messages qui ne s’adressent pas au bot sont volontairement ignorés. Le bot ignore également les messages provenant d’autres bots et n’agit pas sur les messages modifiés ou supprimés. > **Note** > > Telegram n’applique les modifications du mode confidentialité et du rôle d’administrateur qu’aux groupes que le bot rejoint **après** la > modification. Si vous avez précédemment activé ou désactivé le mode confidentialité dans [@BotFather](https://t.me/BotFather), ou rendu > le bot administrateur d’un groupe pour « résoudre » les mentions, retirez le bot du groupe puis ajoutez-le à nouveau afin que le nouveau > paramètre prenne effet. C’est généralement ce qui permet aux mentions de fonctionner, et non le rôle d’administrateur > lui-même. Dans les discussions de groupe et de supergroupe, la réponse de l’agent est envoyée comme réponse citée au message déclencheur, afin de rester visuellement associée à la question même lorsque la discussion est active. Dans les discussions privées en tête-à-tête, la réponse citée est désactivée car elle serait redondante. ## Outils d’agent Lorsque vous ajoutez des outils Telegram à un agent, les outils intégrés suivants sont disponibles : | Outil | Description | | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `telegram_get_chat` | Consulte les métadonnées de la discussion actuelle, telles que le type, le titre, le nom d’utilisateur et la description. Le `chat_id` est associé à la conversation actuelle et ne peut pas être redirigé. | | `telegram_send_message` | Envoie un message texte dans la discussion actuelle. Le `chat_id` est associé ; le modèle contrôle `text` et l’option `parse_mode` facultative (`HTML`, `Markdown` ou `MarkdownV2`). | | `telegram_react_to_message` | Réagit au message déclencheur avec un seul emoji issu de l’[ensemble de réactions](https://core.telegram.org/bots/api#reactiontypeemoji) autorisées pour les bots Telegram, utile lorsqu’un bref accusé de réception (`👍`, `🎉`, `❤`) est plus naturel qu’une réponse texte. `chat_id` et `message_id` sont tous deux associés à l’interaction d’origine. Définir une nouvelle réaction remplace toute réaction précédemment définie par le bot sur ce même message. | > **Info** > > Certaines discussions limitent les emoji autorisés via le paramètre **Available reactions** de Telegram. Si un > appel de réaction est rejeté, demandez à l’agent de se rabattre sur une réponse texte. ## Variables dynamiques Lorsqu’un agent s’exécute depuis Telegram, les variables dynamiques suivantes sont disponibles dans les prompts et les outils : | Variable | Description | | ------------------------------------- | ----------------------------------------------------------------------------------------------- | | `integration__telegram_chat_id` | ID de la discussion Telegram où se déroule la conversation. | | `integration__telegram_message_id` | `message_id` Telegram du message utilisateur qui a déclenché l’interaction actuelle de l’agent. | | `integration__telegram_connection_id` | ID de connexion de l’intégration ElevenLabs. | Consultez les [variables dynamiques](/docs/fr/eleven-agents/customization/personalization/dynamic-variables) pour savoir comment les référencer dans les prompts et les appels d’outils. ## Liens utiles * [Documentation de l’API Telegram Bot](https://core.telegram.org/bots/api) * [Mode confidentialité](https://core.telegram.org/bots/features#privacy-mode) * [BotFather, créer et gérer des bots](https://t.me/BotFather)