Telegram-notificaties

Telegram-koppeling stuurt notificaties naar je Telegram-account of -groep over nieuwe bestellingen, dagelijkse omzet, of on-demand de verkoopstand van een specifiek event.

Wanneer gebruik je dit

• Je wil een ping bij elke betaalde bestelling (beheerders).
• Dagelijks overzicht van de omzet in een Telegram-bericht (beheerders).
• Groepsgesprek bij organisatoren waar iedereen met /stand de actuele verkoop kan opvragen van één event.

Eerste koppeling

1. Voeg in Telegram de VoordeMensen-bot toe (vraag support voor de bot-naam).
2. Stuur een eerste bericht naar de bot (bv. /start). De bot herkent je en maakt een record aan.
3. Ga in het Dashboard naar Koppelingen → Telegram. Je ziet jouw record met Chat ID, Voornaam, Achternaam ingevuld.
4. Klik op de rij om in te stellen welke notificaties je wil.
5. Zet de koppeling aan met de Activeren-knop (play-icoon) in de lijst. De gebruiker krijgt dan direct een bevestiging in Telegram (zie Berichten aan de gebruiker).

Instellingen

Account gegevens (read-only)

Deze velden vult het systeem in zodra de bot je herkent:

Veld	Uitleg
Chat ID	Unieke Telegram-ID (door Telegram toegekend)
Voornaam / Achternaam	Zoals ingesteld in je Telegram-profiel

Instellingen

Veld	Uitleg
Actief	Aan = bot stuurt berichten. Uit = tijdelijk stoppen zonder verwijderen.
Notificatie types	Alleen voor admin accounts (geen event-beperking). Keuze uit Elke bestelling en Dagelijks overzichtsbericht.

Evenement beperking (voor groepen)

Voor een Telegram-groep stel je één event in waarop /stand gegevens mag opvragen:

Veld	Uitleg
Mag opvragen	Het event (of hoofdevenement) waarvan deze groep de verkoopstand mag zien. Laat leeg om toegang te blokkeren.

Twee gebruiksmodi

Mode	Wie	Wat zie je
Admin (geen event-beperking)	Beheerder-account	Elke bestelling → push per order · Dagelijks overzicht → omzet per dag
Groep (wel event-beperking)	Telegram-groep, bv. organisator-team	Alleen on-demand: type /stand <organisatie> <event-id> → bot reageert met huidige verkoop van het toegestane event. Het exacte commando staat in het activatiebericht.

De lijst

Kolommen in Koppelingen → Telegram:

Kolom	Betekenis
Chat ID	Unieke ID
Voornaam / Achternaam	Profielnaam
Mag opvragen	Gekoppeld event (of "Geen beperking")
Actief	Aan / uit

Filters

• Status - Actief / Niet actief.
• Type - Admin accounts / Groepen (met evenement).

Acties

• Activeren / Deactiveren (play/pause) - toggle Actief zonder het formulier te openen. De gebruiker krijgt hierover een Telegram-bericht; het dashboard meldt Telegram geactiveerd of Telegram gedeactiveerd.
• Bewerken (potlood) of klik op de rij - opent het formulier. Hier wijzig je onder meer Mag opvragen (het event van een groep) en de Notificatie types van een admin-account; beide worden bij opslaan bewaard. Zet je hier Actief om, dan gaat er géén bericht naar de gebruiker.
• Verwijderen (prullenbak).

Berichten aan de gebruiker

Bij de Activeren / Deactiveren-actie stuurt de bot (vdmBot) een bericht naar de gekoppelde chat:

Situatie	Bericht
Geactiveerd, met event-beperking	"Je account is geactiveerd. Je kunt de verkoopstand van je voorstelling opvragen met het commando: /stand <organisatie> <event-id>" - met de ingevulde waarden voor jouw organisatie en event.
Geactiveerd, zonder event-beperking	"Je account is geactiveerd. Je ontvangt vanaf nu meldingen via deze bot."
Gedeactiveerd, met event-beperking	"Je account is gedeactiveerd. Je kunt de verkoopstand niet meer opvragen."
Gedeactiveerd, zonder event-beperking	"Je account is gedeactiveerd. Je ontvangt geen meldingen meer."

Lukt het versturen niet (bijvoorbeeld omdat de gebruiker de bot heeft geblokkeerd), dan blijft de status wél omgezet en toont het dashboard de waarschuwing Let op: het Telegram-bericht aan de gebruiker kon niet worden verstuurd (zie logs). Laat de gebruiker dan zelf even een bericht naar de bot sturen en probeer opnieuw.

Tips

• Een bot per omgeving - gebruik een aparte bot voor test/productie om dooreen te voorkomen.
• Groepen - voeg de bot toe als groepslid en geef 'm admin-rechten zodat hij berichten mag sturen.
• Dagelijks overzicht komt op vaste momenten (zie Reminders voor hoe het cron-systeem werkt).

---

Zie ook: Reminders · API-keys · Overzicht integraties