Telegram | ElevenLabs Documentation

Connectez vos agents ElevenLabs à 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. 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é 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.

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, 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 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.

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 pour savoir comment les référencer dans les prompts et les appels d’outils.