Créer un assistant IA sur Telegram (voix + texte) avec n8n
· Par AI Compare
Un bot Telegram qui comprend la voix et le texte, se souvient du contexte et utilise vos outils, construit dans n8n.
Ce que vous allez créer
Un assistant IA personnel avec lequel vous discutez dans Telegram. Envoyez-lui un texte ou un message vocal : il transcrit la voix, comprend la demande, utilise des outils (agenda, e-mail, contacts, recherche web) et répond en texte ou en audio. Il se souvient de la conversation récente, donc les questions de suivi fonctionnent.
Il reprend la structure du modèle communautaire n8n « Turn Telegram into an AI assistant with OpenAI voice, memory and tools ».
Ce qu’il vous faut
- Une instance n8n avec une URL HTTPS publique (n8n Cloud, ou auto-hébergé avec un domaine). Telegram doit pouvoir joindre votre webhook.
- Un compte Telegram.
- Une clé d’API OpenAI (chat, transcription et synthèse vocale en option). Vous pouvez utiliser d’autres fournisseurs de modèles pour le chat.
- En option : des credentials Google pour les outils Agenda et Gmail.
Étape 1 : créer le bot Telegram
- Dans Telegram, ouvrez @BotFather et envoyez
/newbot. - Choisissez un nom d’affichage et un nom d’utilisateur se terminant par
bot(5 à 32 caractères). - Copiez le jeton que BotFather vous donne.
- Dans n8n, créez un credential Telegram et collez le jeton comme Access Token.
Étape 2 : la structure du workflow
| # | Nœud | Rôle |
|---|---|---|
| 1 | Telegram Trigger (updates: message) | Reçoit chaque message envoyé au bot |
| 2 | IF : vérification de l’expéditeur | N’autoriser que votre propre ID utilisateur Telegram, pour que des inconnus n’utilisent pas votre assistant (ni votre budget API) |
| 3 | Switch : texte ou voix | Oriente selon que message.voice existe ou non |
| 4 | Telegram: Get File (branche voix) | Télécharge le message vocal en données binaires |
| 5 | OpenAI: Transcribe a recording | Transforme l’audio en texte |
| 6 | Edit Fields (Set) | Place le texte des deux branches dans un même champ, par exemple prompt |
| 7 | AI Agent | Analyse la demande et décide quels outils appeler |
| 8 | Modèle de chat + mémoire (sous-nœuds) | OpenAI Chat Model et Simple Memory avec l’ID du chat Telegram comme clé |
| 9 | Outils (sous-nœuds) | Google Calendar, Gmail, recherche web, calculatrice |
| 10 | Telegram: Send Message | Répond dans le même chat |
Étape 3 : configurer l’AI Agent
- Prompt : mappez le champ unifié
promptde l’étape 6. - Message système : décrivez le rôle de l’assistant, votre fuseau horaire et les règles, par exemple : « Tu es mon assistant personnel. Nous sommes le {{ $now }}. Demande confirmation avant d’envoyer des e-mails. »
- Mémoire : utilisez Simple Memory avec la clé de session
{{ $('Telegram Trigger').item.json.message.chat.id }}pour que chaque chat ait son propre historique. - Outils : ajoutez chaque outil comme sous-nœud et donnez-lui une description claire, par exemple « Créer des événements d’agenda. Entrée : titre, heure de début, heure de fin. »
Étape 4 : répondre par la voix (facultatif)
Ajoutez un nœud OpenAI Generate audio (synthèse vocale) après l’agent et envoyez le résultat avec Telegram Send Audio ou Send Voice. Gardez la réponse texte par défaut ; les réponses vocales coûtent plus cher et sont plus lentes.
Conseils de sécurité et de coût
- Vérifiez toujours l’ID utilisateur de l’expéditeur. Un bot public sans cette vérification peut être utilisé par quiconque le trouve.
- Demandez à l’agent de confirmer avant les actions qui envoient des e-mails ou suppriment quelque chose.
- La transcription vocale et les longues conversations consomment des tokens. Limitez la mémoire aux 10 à 20 derniers messages.
n8n face à Zapier et Make pour ce cas d’usage
Les déclencheurs Telegram existent dans les trois outils, mais l’AI Agent de n8n, avec outils et mémoire dans un seul workflow, en fait l’endroit le plus pratique pour créer un vrai assistant. Dans Zapier ou Make, il faudrait plusieurs étapes par outil et davantage d’opérations par message. Voir Agents IA dans Zapier, Make et n8n.
