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 vaak sneller even na. Voor ondernemers die snel willen reageren op berichten via hun OidK-profiel kan dat het verschil maken.

Daarom hebben we een Telegram-bot gebouwd die je kunt koppelen aan je account. 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-mailmeldingen hebben we sowieso, en die blijven werken. De Telegram-bot is een extra kanaal voor wie berichten liever als pushmelding op de telefoon krijgt en er direct op wil kunnen antwoorden.

Telegram is gratis en werkt op telefoon, tablet en computer. Voor een non-profit als OidK is het aantrekkelijk dat één bot iedereen bedient, zonder dat we een eigen app hoeven te bouwen.

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 Instellingen op `/profiel/instellingen`.
Klik bij "Telegram koppelen" op Koppel Telegram. 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. Telegram opent 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 account, en stuurt direct een welkomstbericht waarin je kort ziet wat je nu kunt verwachten.

Vanaf dat moment is je account gekoppeld. Het token is daarna niet meer geldig — eenmalig gebruik, en het verloopt sowieso na vijftien minuten als je het niet gebruikt. Dat voorkomt dat een oude link later misbruikt kan worden.

Het welkomstbericht is toegevoegd in versie 1.15.0 van het platform. Eerder kreeg je alleen een minimaal "Gekoppeld."-berichtje. Nu zie je meteen wat de koppeling doet en welke commando's er zijn.

Wat je via Telegram automatisch ontvangt

Zodra je gekoppeld bent, stuurt de bot je een seintje bij:

Nieuwe berichten in je inbox. Een andere ondernemer (of OidK zelf) stuurt je een bericht; jij krijgt direct een Telegram-melding met de afzender, het onderwerp en de eerste regels van de tekst, plus de knoppen Beantwoorden en Bekijk op OidK.
Community-meldingen, als je dat wilt. In je meldingsvoorkeuren voor de community kun je per soort melding Telegram aanzetten. Standaard staat Telegram daar uit.

Niet elke gebeurtenis op je profiel triggert een bericht — dat zou snel onhandig worden.

Bot-commando's: wat je zelf kunt opvragen

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

`/berichten` — Het aantal ongelezen berichten en je vijf laatste gesprekken, met links naar je inbox.
`/help` — Een overzicht van de beschikbare commando's.
`/link` — Uitleg hoe je je account koppelt, als je dat nog niet hebt gedaan.
`/unlink` — De koppeling verwijderen.

Typ je iets dat geen geldig commando is, dan doet de bot niets. Geen AI-improvisaties, geen pogingen om de boodschap te interpreteren.

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 en geen inloggen op de site.

Hoe het werkt: tik onder de melding op Beantwoorden en typ daarna je antwoord als gewoon bericht in de chat. De bot plaatst je tekst in het juiste gesprek op OidK. De ander krijgt vervolgens een e-mailmelding (en een Telegram-melding als die gekoppeld is) — net zoals wanneer jij vanaf de site had geantwoord. Je krijgt "Bericht verzonden." terug als bevestiging.

De bot onthoudt na het tikken op Beantwoorden dertig minuten bij welk gesprek je antwoord hoort. Ben je later, tik dan opnieuw op de knop of antwoord via je inbox op de site — dan zie je meteen ook wat er eerder gezegd is.

Waarom dit echt scheelt

Stel je krijgt rond half elf 's ochtends een bericht van een collega-ondernemer die wil weten of je volgende week kunt aansluiten bij een klus. Met de Telegram-bot pak je je telefoon, lees je het bericht, tik je op Beantwoorden en typ je "Ja kan, bel me vanmiddag even — past 14u?". Klaar, zonder dat je eerst achter een laptop hoeft.

Privacy en controle

Een paar dingen die we belangrijk vinden:

Tokens vervallen.

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

Koppeling kan altijd los.

In je instellingen kun je met Ontkoppelen de koppeling verwijderen, of je typt `/unlink` in de bot. Vanaf dat moment krijg je geen meldingen meer via de bot. Wil je later terug, dan genereer je een nieuwe link.

De bot ziet alleen zijn eigen chat.

Een Telegram-bot ontvangt de berichten uit de chats waarin hij zit — bij ons is dat jouw privéchat met de bot. Die berichten gebruiken we voor commando's en antwoorden.

Antwoorden alleen als deelnemer.

Een antwoord via de bot wordt alleen geplaatst als jouw gekoppelde account deelnemer is aan het gesprek en een geverifieerd profiel heeft.

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 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 kanaal voor wat via OidK binnenkomt.

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.
Geen bewerken van profielen via de bot. De bot is een meldings- en antwoordkanaal, geen volwaardig dashboard. Voor het bewerken van je profiel, foto's of contactgegevens log je in op de site.
Eén Telegram-chat per account. Wil je met meerdere mensen in een team de berichten ontvangen? Dat zit nu niet in het systeem: een account heeft één gekoppelde chat, en koppel je dezelfde Telegram-chat aan een ander account, dan vervalt de eerdere koppeling.
Telegram zelf is een vereiste. Wil je geen Telegram gebruiken? Geen probleem, e-mailmeldingen 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.

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? Log in, open je instellingen en klik op Koppel Telegram. Na het starten van de bot krijg je meteen je welkomstbericht en weet je dat het werkt.

De OidK Telegram-bot voor ondernemers — sneller reageren