Telegram-klantenservicebot: hoe hij werkt en hoe je hem inricht
Door Roman Zakharenko · Feiten gecontroleerd
Een Telegram-supportbot is een programma dat gekoppeld is aan de Telegram Bot API. Je registreert hem bij @BotFather, krijgt een token, en je code ontvangt berichten van klanten via een webhook of long polling. Telegram-bots kunnen geen gesprekken beginnen, dus elke supportflow start wanneer een klant je bot opent en op 'Start' tikt.
In één oogopslag
- Je maakt een bot aan en krijgt zijn authenticatietoken door @BotFather een bericht te sturen.
- Updates komen binnen via getUpdates of een webhook; de twee methodes sluiten elkaar uit.
- Telegram bewaart niet-afgeleverde updates niet langer dan 24 uur.
- Bots kunnen gebruikers niet als eerste een bericht sturen; de gebruiker moet de bot een bericht sturen of hem aan een groep toevoegen.
- Webhooks werken alleen op de poorten 443, 80, 88 en 8443.
Hoe een Telegram-supportbot werkt
Je maakt een bot aan door in Telegram een bericht te sturen naar @BotFather, die hem registreert en je een authenticatietoken geeft. Je code gebruikt dat token om de Bot API via HTTPS aan te roepen. Het token authenticeert alleen je code; het geeft de bot geen toestemming om wie dan ook een bericht te sturen.
Bots kunnen geen gesprekken beginnen. Een gebruiker moet de bot eerst een bericht sturen of hem aan een groep toevoegen. Elke bot heeft een link in de vorm t.me/ gevolgd door de gebruikersnaam van de bot, die een chat met hem opent, en de eerste keer dat iemand die chat opent, ziet hij een knop 'Start' die het commando /start verstuurt. Sla op dat moment de chat-ID van de gebruiker op: die heb je nodig om later een bericht te sturen, zoals een ticketupdate.
- De klant tikt op je t.me-link op je website of in een e-mail en drukt op 'Start'.
- De bot begroet de klant en toont een kort menu met veelvoorkomende onderwerpen.
- Eenvoudige vragen krijgen direct een antwoord; al het andere wordt verzameld (ordernummer, omschrijving, screenshots).
- De bot maakt een ticket aan in je helpdesk en vertelt de klant wat er nu gebeurt.
- Als een medewerker in de helpdesk antwoordt, wordt het antwoord teruggestuurd naar dezelfde Telegram-chat.
Webhooks vs long polling
De Bot API biedt twee manieren om updates te ontvangen die elkaar uitsluiten: de methode getUpdates (long polling) en webhooks. Zolang er een webhook is ingesteld, werkt getUpdates niet. Hoe dan ook bewaart Telegram updates die je nog niet hebt ontvangen niet langer dan 24 uur, dus een bot die een dag offline is, verliest berichten.
| getUpdates (long polling) | Webhook (setWebhook) | |
|---|---|---|
| Hoe het werkt | Je server vraagt Telegram om nieuwe updates | Telegram stuurt elke update naar je HTTPS-URL |
| Hosting | Elke server die uitgaande verzoeken kan doen | Een publiek HTTPS-endpoint op poort 443, 80, 88 of 8443 |
| Afzender controleren | Niet nodig, je server doet zelf de verzoeken | Stel een secret_token in; Telegram stuurt het terug in de header X-Telegram-Bot-Api-Secret-Token |
Om van een webhook terug te schakelen naar polling, verwijder je de webhook met deleteWebhook of door setWebhook aan te roepen met een lege URL. Beide methodes accepteren drop_pending_updates als je de opgebouwde achterstand wilt weggooien wanneer je je opzet wijzigt.
Knoppen en menu's voor supportflows
Supportbots werken beter met knoppen dan met vrije tekst. Custom reply keyboards vervangen het toetsenbord van de gebruiker door vooraf ingestelde antwoorden, en een druk op een daarvan stuurt die tekst in de chat. Inline keyboards koppelen knoppen aan een specifiek bericht en plaatsen niets in de chat als erop wordt gedrukt. Een inline knop kan een URL openen of callbackdata van 1–64 bytes naar je bot sturen.
Twee details overvallen nieuwe bots vaak. Nadat een gebruiker op een callbackknop drukt, tonen Telegram-clients een voortgangsindicator tot je bot answerCallbackQuery aanroept, dus beantwoord elke callback, ook zonder tekst. En bewerk bij menu's met meerdere stappen het bestaande bericht met nieuwe knoppen in plaats van elke keer een nieuw bericht te sturen; bewerken werkt voor berichten die inline keyboards hebben.
Groepen, privacy mode en verzendlimieten
Bots die aan groepen worden toegevoegd, draaien standaard in privacy mode. In die modus ontvangt een bot commando's die aan hem zijn gericht, reacties op zijn eigen berichten, berichten die via de bot zijn verstuurd en serviceberichten, maar niet het gewone gesprek in de groep. Bots die beheerder van een groep zijn, ontvangen alle berichten, en je kunt privacy mode uitschakelen met /setprivacy in @BotFather, al raadt Telegram dat alleen aan als het absoluut nodig is. Berichten in privéchats met de bot komen altijd aan.
| Waar | Richtlijn |
|---|---|
| Eén chat | Vermijd meer dan één bericht per seconde; korte pieken kunnen doorkomen voordat 429-fouten beginnen |
| Een groep | Niet meer dan 20 berichten per minuut |
| Bulkmeldingen | Ongeveer 30 berichten per seconde over alle gebruikers, tenzij je paid broadcasts inschakelt |
De FAQ van Telegram geeft deze cijfers als indicatie, dus bouw nieuwe pogingen in bij 429-fouten in plaats van op exacte getallen te vertrouwen. Voor een supportbot zijn ze vooral van belang als je veel klanten tegelijk informeert, bijvoorbeeld over een storing. Geef bij long polling ook de parameter offset mee aan getUpdates: updates tot en met die ID worden als bevestigd gemarkeerd en worden niet opnieuw teruggegeven.
Overdracht aan de helpdesk en Telegram Business
Voor overdracht van bot naar mens is het gebruikelijke patroon dat de bot een ticket opent en de antwoorden van medewerkers terugstuurt naar de chat. Zendesk ondersteunt Telegram als Sunshine Conversations-kanaal in de Agent Workspace, waarvoor Suite Professional of hoger nodig is. Berichten worden tickets, en het antwoord van een medewerker in Zendesk verschijnt in de messaging-app van de klant.
Telegram Business is een aparte optie voor kleine teams die klanten vanuit hun eigen Telegram-account antwoorden. De accounteigenaar kan één business bot tegelijk koppelen, kiezen tot welke chats die toegang heeft, en hem inkomende berichten laten verwerken en, waar toegestaan, namens de eigenaar laten antwoorden.
Hoe TascaLab kan helpen
TascaLab bouwt Telegram-supportbots die koppelen met de tools die je al gebruikt, zoals Zendesk, Freshdesk, Jira, Slack of interne systemen, via API's, webhooks en Make of n8n. Een Starter Chat Bot (€ 360) dekt één of twee kanalen met FAQ's en eenvoudige gegevensverzameling, wat past bij Telegram plus een websitewidget. Elk project omvat 30 dagen ondersteuning na livegang en basisdocumentatie, en de meeste projecten duren 1–3 weken. Je kunt beginnen met een gratis Health Check-gesprek van 30 minuten.
Veelgestelde vragen
Kan een Telegram-bot klanten als eerste een bericht sturen?
Nee. Een gebruiker moet de bot een bericht sturen of hem aan een groep toevoegen voordat de bot hem kan schrijven. Sla de chat-ID op bij het eerste contact, zodat je later updates kunt sturen.
Moet ik webhooks of getUpdates gebruiken?
Beide werken, maar niet tegelijk. Webhooks pushen elke update naar je HTTPS-endpoint, terwijl long polling alleen uitgaande verzoeken nodig heeft en eenvoudiger is tijdens de ontwikkeling.
Waarom ziet mijn bot geen berichten in een groep?
Bots draaien standaard in privacy mode en zien alleen berichten die voor hen bedoeld zijn. Maak de bot beheerder van de groep, of schakel privacy mode uit met /setprivacy in @BotFather en voeg de bot opnieuw toe aan de groep.
Ondersteunt Zendesk Telegram?
Ja, als Sunshine Conversations-kanaal in de Agent Workspace, waarvoor volgens Zendesk Suite Professional of hoger nodig is. Berichten komen binnen als tickets en antwoorden van medewerkers gaan terug naar Telegram.
Wil je dit laten opzetten voor je team?
Plan een gratis Health Check: een gesprek van 30 minuten en een schriftelijk rapport met 2–3 concrete aanbevelingen, een vaste prijs en de geschatte lopende kosten. Geen verkooppraatje.
Bronnen
- Telegram — Bots: An introduction for developers
- Telegram — Telegram Bot API
- Telegram — From BotFather to 'Hello World'
- Telegram — Marvin's Marvellous Guide to All Things Webhook
- Telegram — Telegram Bot Features
- Telegram — Bots FAQ
- Telegram — Connected business bots
- Zendesk Help Center — Adding Sunshine Conversations channels to the Zendesk Agent Workspace