Hoe maak je een Telegram-bot met Claude Code of Codex (gids voor beginners)

Heb je nog nooit een bot gecodeerd, maar wil je berichten op Telegram automatiseren? Claude Code, Codex of andere AI-codeerassistenten kunnen het meeste technische werk voor je doen, op voorwaarde dat je ze goed begeleidt. In een paar stappen ga je van een idee naar een bot die echt werkt. Zo pak je het aan.

1. Maak je bot aan op Telegram

Open Telegram en chat met @BotFather, de officiële bot die bots aanmaakt. Typ /newbot, kies een naam en een gebruikersnaam (die moet eindigen op “bot”). BotFather geeft je een token : een lange tekenreeks die als geheime sleutel dient om je bot te besturen. Bewaar die zorgvuldig en deel hem nooit publiekelijk — en als hij toch uitlekt (bijvoorbeeld per ongeluk gepubliceerd op GitHub), ga dan terug naar BotFather om hem in te trekken en een nieuwe te genereren.

2. Open je AI-assistent in een projectmap

Maak een lege map aan op je computer en start de assistent in een terminal op die plek. Hij werkt altijd in de huidige map: daar leest en schrijft hij je bestanden.

3. Geef hem een precieze startprompt

Technische termen heb je niet nodig, maar hoe preciezer je vraag, hoe beter het resultaat. Hier is een prompt die je letterlijk kunt kopiëren en plakken (vervang de waarden tussen vierkante haakjes):

Maak een Telegram-bot in Python met de bibliotheek python-telegram-bot.
De bot moet elke ochtend het weer van [STAD] naar [TIJD] sturen.

Beperkingen:
- Bewaar het Telegram-token in een .env-bestand, nooit hardgecodeerd in de code.
- Maak een .gitignore-bestand dat .env uitsluit.
- Verzin geen enkele geheime waarde (token, API-sleutel): vertel me duidelijk
  waar en hoe ik ze zelf moet invullen.
- Leg me elke stap uit voordat je hem uitvoert.
- Test de bot voordat je het project als afgerond beschouwt.

Voor een bericht dat elke dag wordt verstuurd zonder dat je zelf naar de bot hoeft te schrijven, moet je ook je chat-ID kennen (de identificatie van je gesprek met de bot). Vraag de AI gewoon om uit te leggen hoe je die ophaalt — meestal door eerst een bericht naar de bot te sturen en dan het antwoord van de Telegram-API te lezen.

4. Beveilig het token vanaf het begin

De AI moet een bestand .env aanmaken om het token in op te slaan.

5. Laat de AI de commando’s uitvoeren, met de nodige voorzichtigheid

De AI kan zelf de installatiecommando’s uitvoeren (pip install, npm install, enz.) en de bot starten om hem te testen. Ze vraagt je toestemming voor elke belangrijke actie. Dat is normaal, het is een veiligheidsmaatregel. Wanneer een beginner niet weet hoe hij moet inschatten “wat logisch is”, volstaat één simpele regel: als een commando je wachtwoord vraagt, bestanden aanpast die je niet herkent, of software installeert waarvan je nog nooit hebt gehoord, vraag de AI dan eerst om uit te leggen wat ze gaat doen en waarom, voordat je toestemming geeft.

6. Test je bot

Zodra de bot gestart is, open je Telegram en stuur je hem een bericht. Als hij niet reageert zoals verwacht, beschrijf je het probleem gewoon aan de AI (“de bot reageert niet op /start” of “ik krijg een XYZ-fout”) : hij leest de foutmeldingen en corrigeert de code.

7. Voeg stap voor stap functionaliteiten toe

Zodra de basis werkt, kun je deze verrijken bot geleidelijk: automatische antwoorden, geplande herinneringen, integratie met een externe API… Vraag één functionaliteit per keer aan, test het, en ga dan verder met de volgende. Als je bot gebruikers, hun voorkeuren of herinneringen moet onthouden, vraag de AI dan om permanente opslag te voorzien: een eenvoudig lokaal bestand kan voldoende zijn voor een prototype, maar overleeft niet altijd een herstart op een hosting; een kleine database wordt dan noodzakelijk.

8. Host je bot continu

Om de bot te laten werken zelfs wanneer je computer uit staat, moet je hem op een server hosten. Vraag de AI om de huidige opties uit te leggen (kleine cloudserver, platforms zoals Railway of Fly.io, serverless functies zoals Cloudflare Workers) en om de deployment voor te bereiden. Controleer altijd de actuele voorwaarden en tarieven op het moment dat je dit leest: de gratis aanbiedingen van deze platforms veranderen regelmatig.

9. Los problemen op en onderhoud je bot

Een bot die vandaag werkt, kan morgen niet meer werken: een bijgewerkte dependency, een hoster die zijn regels wijzigt, een verlopen token… Houd bij wat de AI heeft opgezet (vraag hem om claude.md te documenteren) zodat je hem gemakkelijk opnieuw de context kunt geven. Kopieer bij een storing eenvoudigweg de foutmelding naar de AI: dat is vaak voldoende om het probleem te identificeren en op te lossen.

Antwoorden, programmeren of uitzenden: drie verschillende logica’s

Een Telegram-bot kan drie heel verschillende dingen doen: antwoorden op een ontvangen bericht, een geprogrammeerd bericht sturen op een vast tijdstip, of een melding naar meerdere gebruikers uitzenden. Het laatste geval is veeleisender: je moet de lijst beheren van mensen die een gesprek met de bot zijn begonnen, hun voorkeuren, en de verzendlimieten van Telegram respecteren. Een bot kan niet spontaan naar willekeurig welk Telegram-account schrijven; elke gebruiker moet eerst het gesprek zijn gestart.

Wat gratis is, wat betaald is

Een bot maken met BotFather is gratis, en de Telegram Bot API wordt meestal niet per aanroep gefactureerd, maar Telegram legt snelheidslimieten op, en sommige functionaliteiten kunnen hun eigen voorwaarden hebben. Wat de AI-assistent betreft, het gebruik hangt af van je abonnement: een abonnement zoals Claude Pro of Max of ChatGPT Pro omvat gebruik van de tool.

Wat hosting betreft, verschillende platforms (Cloudflare Workers, Railway, Fly.io…) bieden doorgaans een gratis niveau dat geschikt is voor een kleine persoonlijke bot met weinig verkeer. Maar deze aanbiedingen veranderen regelmatig en variëren afhankelijk van het werkelijke gebruik van je bot : controleer altijd de actuele voorwaarden voordat je je vastlegt. Samengevat: het is heel goed mogelijk om een eerste Telegram-bot te draaien zonder een cent uit te geven.

Enkele ideeën voor Telegram-bots

Prijs- en shoppingsurveillance

• Prijsdalingsmelding: houd een product in de gaten en krijg een melding zodra het onder een ingestelde drempel zakt.
• Brandstofprijsvergelijker: melding wanneer een tankstation in de buurt onder een bepaalde prijs per liter zakt.
• Beschikbaarheidssurveillance: melding zodra een uitverkocht artikel weer beschikbaar is.

Financiën & markten

• Beurs- / cryptokoers: stuur de prijs van Bitcoin, een aandeel of een ETF, of meld bij sterke schommelingen.
• Portefeuillesurveillance: bereken dagelijks de totale waarde van je beleggingen.
• Wisselkoers: melding wanneer een valutapaar een interessante drempel bereikt.

Weer & milieu

• Dagelijks weer voor jouw stad, elke ochtend verstuurd.
• Weermelding bij onweer, zware regen of verwachte vorst.
• Luchtkwaliteit / pollen.

Productiviteit & privéleven

• Persoonlijke takenbot: taken toevoegen, verwijderen en herinneren direct in Telegram.
• RSS-monitorbot: houd meerdere sites in de gaten en stuur alleen nieuwe artikelen.
• Samenvattingsbot: stuur een artikel of tekst naar de bot en ontvang een samenvatting.
• Meldingsbot voor je eigen site: nieuwe bestelling, nieuw formulier, serverfout.
• Domoticabot: melding wanneer een apparaat of sensor van status verandert.
• Persoonlijke dagboekbot: sla snel notities op en vind ze terug via zoeken.
• Pakketten volgen: bundel de status van je leveringen in één bot.

Om te onthouden

Je hoeft niet te kunnen programmeren om een werkende Telegram-bot te maken. De rol van de AI is om jouw ideeën om te zetten in code, de technische commando’s uit te voeren en fouten te corrigeren. Jouw rol is om duidelijk te beschrijven wat de bot moet doen, je toegangen te beveiligen, vragen te stellen, de AI te vragen of zij vragen heeft en het resultaat te testen. Het is echt teamwork tussen jouw visie en de technische uitvoering van de AI.