Telegram koppelen aan Elido

Elido verstuurt Telegram-meldingen via een bot die je zelf aanmaakt. De bot stuurt berichten naar een specifieke chat — hetzij een privé-DM met jezelf, hetzij een groep. Jij bezit het bot-token; Elido bewaart het alleen versleuteld.

Stap 1 — Een bot aanmaken met BotFather

1. Open Telegram en zoek naar @BotFather, of open https://t.me/BotFather.
2. Stuur /newbot.
3. Volg de prompts: kies een weergavenaam, en daarna een gebruikersnaam (moet eindigen op bot, bijv. AcmeElidoBot).
4. BotFather antwoordt met je API-token. Het ziet eruit als 123456789:AABBccDD.... Kopieer het nu — je kunt het later ophalen via /mybots, maar het is sneller om het meteen te kopiëren.

Stap 2 — Je chat-ID vinden

Je hebt de numerieke chat-ID nodig van waar je berichten naartoe wilt sturen.

Voor DM's (alleen jijzelf):

1. Stuur een willekeurig bericht naar je nieuwe bot.

2. Open deze URL in een browser en vervang TOKEN door je token:

   https://api.telegram.org/botTOKEN/getUpdates
   

3. Zoek "chat":{"id":...} in de respons. Dat nummer is je chat-ID. Voor persoonlijke chats is dit meestal een positief getal van 9 cijfers.

Voor een groep:

1. Voeg de bot toe aan de groep.
2. Stuur een bericht in de groep waarin je de bot @-vermeldt (bijv. @AcmeElidoBot hello).
3. Open dezelfde getUpdates-URL hierboven. Groepschat-ID's zijn negatieve getallen (bijv. -1001234567890).

Stap 3 — Elido configureren

1. Ga naar Instellingen → Meldingen → Telegram → Kanaal toevoegen.
2. Plak het bot-token en de chat-ID.
3. Klik op Opslaan. Elido stuurt een testbericht. Verwacht dit binnen 2 seconden in Telegram.

Gebeurtenissen kiezen

Klik na het koppelen op Gebeurtenissen configureren om te selecteren welke gebeurtenissen een bericht triggeren:

• threshold.exceeded — aanbevolen startpunt.
• scan.failed — direct nuttig voor elke link waarvan je de bestemming niet zelf beheert.
• link.created — nuttig voor gedeelde workspaces waarin je zicht wilt hebben op nieuwe links.

De integratie verwijderen

Ga naar Instellingen → Meldingen → Telegram → Verwijderen. Dit verwijdert het bot-token uit de database van Elido. Trek desgewenst de bot zelf in via BotFather met /revoke.

Probleemoplossing

"Unauthorized" in het bezorglogboek — Het token is onjuist. Controleer dit door het volgende in een browser te plakken:

https://api.telegram.org/botTOKEN/getMe

Als dit {"ok":false,...} teruggeeft, is het token ongeldig.

"Chat not found" — De chat-ID is onjuist, of de bot is nooit aan de groep toegevoegd. Controleer voor groepen of de bot lid is en stuur een bericht waarin je de bot vermeldt voordat je getUpdates aanroept.

Geen bericht na het klikken op Test — Controleer getUpdates om te bevestigen dat de bot enige interactie heeft ontvangen. Als de respons leeg is, heeft Telegram nog geen contact tussen de gebruiker/groep en de bot geregistreerd.

Berichten in de groep zijn onzichtbaar — Sommige Telegram-groepen hebben "slow mode" of plaatsen alleen toe voor beheerders. Maak de bot beheerder met de rechten "Berichten plaatsen".