De OidK Telegram-bot voor ondernemers

Een e-mailmelding die in je inbox belandt naast tien nieuwsbrieven en twee aanmaningen heeft de neiging te wachten. Een Telegram-pushmelding op je telefoon kijk je vrijwel meteen even na. Voor ondernemers die snel willen reageren op berichten via hun OidK-profiel is dat verschil het verschil tussen een opdracht binnenhalen en een gemiste kans.

Daarom hebben we een Telegram-bot gebouwd die je kunt koppelen aan je profiel. Dit artikel beschrijft hoe je dat instelt, wat je vervolgens automatisch krijgt, hoe je direct vanuit Telegram kunt antwoorden, en waar de praktische grenzen liggen.

Waarom een Telegram-bot, en niet alleen e-mail?

E-mailnotificaties hebben we sowieso, en die blijven werken. Maar in de praktijk zien we dat berichten die binnen tien minuten een reactie krijgen veel vaker tot een echt gesprek leiden dan berichten die pas een dag later worden bekeken. Iemand die naar drie installateurs een berichtje stuurt, kiest meestal degene die als eerste antwoordt.

Telegram is gratis, werkt op zo ongeveer elk apparaat, heeft een fatsoenlijk privacy-verhaal vergeleken met de gebruikelijke verdachten, en — niet onbelangrijk — vraagt geen extra ontwikkelwerk per platform. Voor een non-profit als OidK is dat aantrekkelijk: één bot bedient iedereen, of je nu een Android of iPhone hebt, of een zakelijke tablet die je naast de werkbank hebt liggen.

Setup: koppelen via magic-link

We gebruiken bewust geen formuliertje met "voer je Telegram-username in". Dat zou aanvallers de kans geven andermans account te koppelen door simpelweg een username te raden. In plaats daarvan werkt het via een magic-link.

De stappen, in volgorde:

Log in op je OidK-profiel en open je dashboard op `/profiel/dashboard`.
Ga naar de Telegram-instellingen en klik op "genereer koppel-link". Achter de schermen roept dat de route `/api/profiel/telegram/generate-link` aan, die een uniek token aanmaakt en daar een Telegram-deeplink omheen bouwt.
Klik op de link. Je telefoon opent Telegram en stelt voor om een gesprek te starten met de OidK-bot.
Druk op "start". De bot herkent het token, koppelt jouw Telegram-chat aan jouw profile-user, en stuurt direct een welkomstbericht waarin je kort ziet wat je nu kunt verwachten.

Vanaf dat moment is je profiel gekoppeld. Het token is daarna niet meer geldig — eenmalig gebruik, en het verloopt sowieso na een tijdje als je het niet aanklikt. Dat voorkomt dat een oude link uit je browsergeschiedenis later misbruikt kan worden.

Het welkomstbericht is een nieuwe toevoeging in versie 1.15.0 van het platform. Eerder kreeg je geen bevestiging en moest je gokken of de koppeling was gelukt. Nu weet je het zeker zodra dat eerste bericht binnenkomt.

Wat je via Telegram automatisch ontvangt

Zodra je gekoppeld bent, stuurt de bot je een seintje voor een handvol gebeurtenissen die direct relevant zijn voor jou als ondernemer:

Nieuwe berichten in je inbox. Iemand stuurt je een bericht via je profielpagina; jij krijgt direct een Telegram-melding met de afzender, het onderwerp en de eerste regels van de tekst.
Nieuwe claim die om bevestiging vraagt. Beheer je een vereniging of een tweede bedrijf en wacht er een claim op verificatie? Dan zie je dat in Telegram.
Pending content. Wanneer er nieuws- of event-items wachten op publicatie, krijg je daar een korte notificatie van.
Registraties. Voor admins komt er een melding bij relevante nieuwe registraties op het platform.

Niet elke gebeurtenis op je profiel triggert een bericht — dat zou snel onhandig worden. We sturen alleen wat actie van jou vraagt of waarvan we vermoeden dat je het direct wilt weten.

Bot-commando's: wat je zelf kunt opvragen

De bot luistert naar een aantal commando's die je gewoon in het chatvenster kunt typen:

`/start` — Hier opnieuw beginnen, bijvoorbeeld als je je koppeling weer met een nieuw token wilt vernieuwen. Met `/start link_<token>` koppelt de bot een nieuwe magic-link aan je chat.
`/help` — Een overzicht van de beschikbare commando's en korte uitleg per stuk.
`/stats` — Snelle statistieken voor vandaag. Handig om even te zien of er beweging op het platform is geweest sinds gisteren.
`/pending` — Een lijst van openstaande claims of content die nog op een actie van jou wacht.

Mocht je iets typen dat geen geldig commando is, dan stuurt de bot je vriendelijk terug naar `/help`. Geen rare AI-improvisaties, geen pogingen om de boodschap te interpreteren — gewoon een duidelijke menu-structuur.

Reply-flow: direct antwoorden vanuit Telegram

Hier zit voor de meeste ondernemers de grootste tijdwinst: als je een Telegram-melding krijgt over een nieuw bericht, kun je daar direct in Telegram op antwoorden. Geen omweg via je laptop, geen aparte tab openen, geen inloggen op het dashboard.

Hoe het werkt: de bot stuurt je het bericht met de relevante context. Als je daarop reageert via Telegram's "reply"-functie (of als simpel volgend bericht in dezelfde chat, mits de context nog vers is), ziet de bot dat en plaatst jouw antwoord als reply in de juiste messaging-thread op OidK. De bezoeker krijgt vervolgens een e-mailnotificatie dat er een nieuw bericht voor hem klaarstaat — net zoals wanneer jij vanuit het dashboard had geantwoord.

Voor het gemak houden we een korte context-cache bij die de bot vertelt welk bericht bij welke conversatie hoort. Reageer je binnen redelijke tijd, dan komt je antwoord op de juiste plek. Wacht je dagen tussen de melding en je antwoord, dan kan het verstandiger zijn om het via het dashboard te doen — gewoon om te zien wat er allemaal eerder gezegd is.

Waarom dit echt scheelt

Stel je krijgt rond half elf 's ochtends een berichtje van iemand die een offerte wil voor volgende week. Met een gewone e-mailnotificatie maak je dat misschien pas 's avonds open. Met de Telegram-bot trek je je telefoon, lees je het bericht, typ je "Ja kan, kom morgen even langs om te kijken — past 14u?", en je bent klaar. De ontvanger ziet jouw reactie binnen een paar minuten in zijn mail. Dat is een conversatie die gisteren een dag had gekost en nu vijf minuten kost.

Voor wie veel onderweg is — en dat geldt voor de meeste ondernemers in de Kempen — is dit een merkbaar verschil in hoe responsief je profiel aanvoelt voor potentiële klanten.

Privacy en controle

Een paar dingen die we belangrijk vinden:

Tokens vervallen.

Een gegenereerde koppel-link werkt eenmalig en is niet eindeloos geldig. Mocht je per ongeluk een link delen of laten slingeren, dan is de schade beperkt.

Koppeling kan altijd los.

In je dashboard kun je met één klik de Telegram-koppeling weer ontkoppelen. Vanaf dat moment stuurt de bot je niets meer en is jouw chat niet meer aan je profiel gekoppeld. Wil je later terug, dan genereer je een nieuwe link.

We hebben geen toegang tot jouw Telegram-chats.

De bot ziet alleen wat jij naar de bot stuurt — niet je andere gesprekken, niet je contacten, niet je adresboek. Dat is een eigenschap van hoe Telegram-bots werken; ze zien uitsluitend hun eigen kanaal.

Geen anonieme bots aan onze kant.

De koppeling is altijd een-op-een tussen één Telegram-account en één profile-user op OidK. Je kunt niet "een bot" toevoegen die namens jou antwoordt zonder dat we weten welk Telegram-account daarachter zit.

Use cases waar dit echt zinvol is

Eenmanszaken in de bouw, installatie of dienstverlening.

Je staat de hele dag bij een klant, in de auto of op een bouwplaats. Je hebt geen tijd om je laptop te openen, maar je telefoon zit in je broekzak. Pushmelding, antwoord, klaar.

Horeca-ondernemers met wisselende drukte.

Tussen lunch en avond is er een gat waarin je perfect even kunt antwoorden. Met Telegram zie je het bericht direct binnenkomen en hoef je geen vast inboxmoment in te plannen.

Ondernemers die OidK gebruiken naast hun vaste mailflow.

Je hoofdmail zit vol, je OidK-berichten verzuipen daarin. Met Telegram heb je een apart, schoon kanaal voor wat via OidK binnenkomt.

Verenigingsbeheerders die snel moeten beslissen.

Een claim om te bevestigen, een evenement om te keuren — pop-up, beslissing, klaar.

Beperkingen — wees daar eerlijk over

Een paar dingen die de bot bewust niet doet, en waarover we transparant willen zijn:

Alleen tekst-replies. Je kunt vanuit Telegram geen bijlagen, foto's of bestanden meesturen die in de OidK-thread terechtkomen. Voor bijlagen moet je naar het dashboard.
Geen bewerken van profielen via de bot. De bot is een notificatie- en reply-kanaal, geen volwaardig dashboard. Voor het bewerken van je profielinhoud, het toevoegen van foto's of het updaten van je contactgegevens log je in op `/profiel/dashboard`.
Eén Telegram-account per profile-user. Wil je met meerdere mensen in een team de berichten ontvangen? Dat zit nu nog niet in het systeem. Voor verenigingen of bedrijven met meerdere beheerders is dat een logische volgende stap, maar nog niet beschikbaar.
Telegram zelf is een vereiste. Ben je principieel tegen Telegram, of heb je je telefoon zo dichtgezet dat installeren niet kan? Geen probleem, e-mailnotificaties blijven gewoon werken. De bot is een aanvulling, geen verplichting.

Hoe je begint

Heb je nog geen profiel op OidK? Lees dan eerst hoe je je profiel claimt. Heb je je profiel wel maar staat het nog niet ingevuld, loop dan de profiel-checklist door, anders krijg je sowieso weinig binnen om op te reageren.

Wil je begrijpen hoe het berichtensysteem zelf werkt voordat je de Telegram-bot koppelt? Lees berichten ontvangen op OidK zonder je e-mail prijs te geven.

Klaar om te koppelen? Open je dashboard, ga naar de Telegram-instellingen en genereer je magic-link. Binnen een minuut krijg je je eerste welkomstbericht en weet je dat het werkt.

De OidK Telegram-bot voor ondernemers — sneller reageren