Stel je voor: je klanten kunnen 24/7 vragen stellen via Telegram en krijgen direct een slim, contextueel antwoord terug, zonder dat jij er wakker voor hoeft te liggen. Of je gebruikt een private Telegram-bot als persoonlijke assistent die je agenda checkt, taken aanmaakt en je bestanden doorstuurt. Met n8n en de Telegram Bot API is dit in 2026 binnen bereik van elke ondernemer.
Wat je nodig hebt
Voor deze handleiding heb je nodig: - Een Telegram-account (telegram.org of de app) - Een n8n-installatie (cloud of Docker; zie onze beginner-handleiding voor de setup) - Een OpenAI API-sleutel (voor GPT-5) of Anthropic API-sleutel (voor Claude Sonnet 4.6) - Optioneel: een Google Sheets-spreadsheet voor gesprekslogboek - Circa 60 minuten Kennis van programmeren is niet vereist. De enige 'code' die je aanraakt zijn de JavaScript-expressies in n8n, en die leggen we stap voor stap uit.
Stap 1: Bot aanmaken via BotFather
Open Telegram en zoek naar @BotFather. Dit is de officiele Telegram-bot waarmee je nieuwe bots aanmaakt. Start een gesprek en stuur het commando /newbot. BotFather stelt je twee vragen: 1. Naam van de bot (dit is de weergavenaam, mag spaties bevatten, bijv. 'Mijn Bedrijfsbot') 2. Username van de bot (moet eindigen op 'bot', bijv. 'mijnbedrijf_bot') Na het aanmaken geeft BotFather je een bot-token. Dit token ziet eruit als: 5893712847:AAHKxL9pUyQ1jmEkZnDrSZlVEBzXc4tMnQw Kopieer dit token zorgvuldig. Je hebt het nodig in stap 3. Deel dit token nooit publiekelijk, want hiermee kan iedereen namens jouw bot berichten sturen.
Stap 2: Telegram Credential aanmaken in n8n
Open n8n en ga naar 'Credentials'. Klik op 'Add credential' en zoek op 'Telegram'. Er is maar een veld: 'Access Token'. Plak hier je bot-token uit Stap 1. Klik op 'Save' en daarna op 'Test connection'. n8n stuurt een test-request naar de Telegram API en geeft aan of het token geldig is. Als de test slaagt, zie je de naam van je bot en het gebruikers-ID bevestigd. Geef de credential een duidelijke naam, bijv. 'Telegram Bot Bedrijfsnaam'. Als je meerdere bots wilt bouwen, kun je voor elke bot een aparte credential aanmaken.
Stap 3: Nieuwe workflow aanmaken met Telegram Trigger
Maak een nieuw workflow aan in n8n. Voeg als eerste node de 'Telegram Trigger' toe. Configureer hem als volgt: - Credential: selecteer de Telegram-credential die je net aanmaakte - Updates: kies 'message' (voor reguliere berichten) en 'callback_query' (voor inlineknop-klikken) n8n genereert automatisch een webhook-URL. Kopieer deze URL. Je kunt hem vinden rechtsonder in de trigger node onder 'Webhook URL'. Nota: In n8n cloud werkt de webhook automatisch. Bij een zelfgehoste installatie moet je zorgen dat n8n bereikbaar is via internet (bijv. via een domein of ngrok tijdens het testen).
Stap 4: Berichten en commando's herkennen met IF-node
Voeg na de Telegram Trigger een 'Switch' node toe. Hiermee stuur je de workflow verschillende kanten op, afhankelijk van wat de gebruiker stuurt. Maak de volgende routes: Route 1: Tekst start met '/start' Route 2: Tekst start met '/help' Route 3: Tekst start met '/status' Route 4: Alle andere tekst (de 'default' route) Voor de commando-routes stuur je een vaste response terug. Voor de default route stuur je het bericht door naar de AI-node.
Stap 5: Welkomstbericht en helptext instellen
Verbind Route 1 (/start) met een 'Telegram' node (Send Message). Configureer: - Chat ID: {{ $json.message.chat.id }} - Text: het welkomstbericht (zie voorbeeld hieronder) - Parse Mode: Markdown (voor vetgedrukte tekst en links) Verbind Route 2 (/help) ook met een Telegram Send Message node met een helptekst. Tip: gebruik Telegram Markdown voor opmaak. Tekst tussen *sterretjes* wordt vet, tekst tussen `backticks` wordt als code weergegeven.
Stap 6: AI-antwoorden genereren met OpenAI of Claude
Verbind de default route van de Switch node met een OpenAI- of Anthropic (Claude)-node. Configureer de AI-node: Voor OpenAI: - Model: gpt-4o of gpt-5 - Systeemprompt: zie hieronder - Gebruikersprompt: {{ $json.message.text }} - Max tokens: 400 (houdt antwoorden beknopt voor Telegram) Voor Claude Sonnet 4.6 (Anthropic): - Model: claude-sonnet-4-6-20260801 - Systeemprompt: zie hieronder - Max tokens: 400 Beide modellen werken uitstekend voor Telegram-bots. Claude Sonnet 4.6 is iets beter in nuancering bij complexe vragen. GPT-4o is sneller bij korte antwoorden.
Stap 7: AI-antwoord terugsturen naar Telegram
Verbind de AI-node met een 'Telegram' node (Send Message). Dit is de node die het AI-antwoord terugstuurt naar de gebruiker. Configureer: - Chat ID: {{ $('Telegram Trigger').item.json.message.chat.id }} - Text: {{ $json.choices[0].message.content }} (voor OpenAI) of {{ $json.content[0].text }} (voor Claude) - Reply to Message ID: {{ $('Telegram Trigger').item.json.message.message_id }} (optioneel, voor reply-thread) Door de Chat ID van de Telegram Trigger te gebruiken, weet n8n naar welk gesprek het antwoord gestuurd moet worden. Dit werkt voor zowel privegesprekken als groepschats.
Stap 8: Inline knoppen toevoegen voor een menu
Telegram ondersteunt inline knoppen onder een bericht. Dit is handig om gebruikers te helpen snel opties te kiezen zonder tekst te hoeven typen. Je kunt knoppen toevoegen via de 'Reply Markup' in de Telegram node. Voeg bij het welkomstbericht (/start) de volgende inline keyboard toe. Als een gebruiker op een knop klikt, ontvangt je bot een 'callback_query' in plaats van een gewoon bericht. Zorg dat je de Telegram Trigger ook op 'callback_query' hebt geconfigureerd (zie Stap 3).
Stap 9: Gesprekken loggen in Google Sheets
Voeg aan het einde van de AI-route een 'Google Sheets' node toe met Operation 'Append Row'. Zo log je elk gesprek voor latere analyse: welke vragen komen het meest voor, hoe lang zijn de antwoorden, hoe verloopt de klanttevredenheid. Gebruik de volgende kolommen in je spreadsheet: - Datum/tijd - Chat ID - Gebruikersnaam - Vraag - Antwoord - Model gebruikt Dit logboek helpt je de bot te verbeteren. Analyseer wekelijks welke vragen de bot verkeerd of onvolledig beantwoordt en pas de systeemprompt aan.
Stap 10: Bot live zetten en grondig testen
Activeer de workflow via de schakelaar rechtsboven ('Active'). Zoek nu in Telegram naar de gebruikersnaam van je bot en start een gesprek. Stuur /start en controleer of je het welkomstbericht ontvangt. Stuur daarna een willekeurige vraag en kijk of de AI-response binnenkomt. Test ook de edge cases: - Wat gebeurt er als je een leeg bericht stuurt? - Wat als de vraag te lang is (>4096 tekens)? - Wat als je de bot uitnodigt in een groepschat? Voor groepschats: de bot ontvangt standaard alleen berichten die aan hem gericht zijn (als @gebruikersnaam) of berichten die beginnen met /commando@gebruikersnaam. Pas de Telegram Trigger aan als je alle groepberichten wilt verwerken (dit verhoogt de kosten).
Beveiliging en best practices
Whitelist gebruikers: als de bot voor intern gebruik bedoeld is, voeg een IF-node toe die controleert of de Chat ID in een toegestane lijst staat. Weiger berichten van onbekende chat-IDs. Rate limiting: voeg een Google Sheets-check toe die telt hoeveel berichten een gebruiker in het afgelopen uur heeft gestuurd. Blokkeer tijdelijk als dat meer dan 50 berichten zijn. Gevoelige data: sla nooit wachtwoorden, BSN-nummers of betaalgegevens op in Google Sheets of verstuur ze via de bot. Gebruik de bot alleen voor algemene informatieverstrekking. Token rotatie: vervang je bot-token periodiek (via BotFather: /revoke). Update dan ook de credential in n8n. Backup: exporteer je n8n-workflow regelmatig als JSON-bestand. Zo kun je hem snel herstellen bij een serverprobleem.
Veelgemaakte fouten en oplossingen
Bot reageert niet op berichten Oplossing: controleer of je workflow actief is (groene schakelaar). Controleer of de webhook correct is ingesteld via getWebhookInfo (zie Stap 3). Bij zelfhosting: zorg dat je n8n-omgeving bereikbaar is via HTTPS op het juiste domein. Fout: 'Bad Request: chat not found' Oplossing: de Chat ID klopt niet. Gebruik altijd de Chat ID uit het huidige inkomende bericht: {{ $json.message.chat.id }}. Gebruik nooit een hardcoded Chat ID. Fout: 'Message is too long' Oplossing: Telegram heeft een limiet van 4096 tekens per bericht. Voeg in je systeemprompt toe: 'Beperk je antwoord tot maximaal 300 woorden.' Of splits lange antwoorden op in meerdere berichten via een Loop-node. Bot antwoordt op zichzelf in een loop Oplossing: voeg een IF-node toe die controleert of de afzender een bot is: {{ $json.message.from.is_bot === true }}. Stop de workflow als de afzender een bot is. OpenAI-fout: 'Rate limit exceeded' Oplossing: voeg een 'Wait' node toe van 1 seconde voor de OpenAI node. Dit voorkomt dat je bij een burst van berichten de rate limit raakt.
Uitbreidingen: wat bouw je daarna?
1. Geheugen toevoegen: sla de laatste 5 berichten op in Google Sheets en stuur ze als context mee naar de AI. Zo heeft de bot een 'geheugen' en kan hij doorvragen stellen. 2. Afbeeldingen verwerken: de Telegram API stuurt ook foto's door. Gebruik de OpenAI Vision-API om foto's te analyseren. Handig voor bots die producten beoordelen of schades inspecteren. 3. Spraakberichten transcriberen: Telegram stuurt spraakberichten als audio-bestanden. Stuur ze naar de OpenAI Whisper API voor transcriptie en verwerk de tekst dan met GPT. 4. Wekelijkse rapportage: maak een apart n8n-workflow (getriggerd door een schema) dat elke maandag een samenvatting stuurt van de meest gestelde vragen uit het Google Sheets-logboek. 5. Koppeling met CRM: als een gebruiker offerteaanvraag stuurt (via de inline knop), maak dan automatisch een HubSpot-contact en deal aan. Stuur direct een bevestiging terug via de bot.
Handige links en verdere leesstof
- Telegram Bot API documentatie: https://core.telegram.org/bots/api - n8n Telegram node documentatie: https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.telegram - BotFather op Telegram: https://t.me/BotFather - n8n community forum: https://community.n8n.io - Workflows.nl: n8n koppelen aan de OpenAI API (deze site) - Workflows.nl: WhatsApp Business automatiseren met n8n