Configuratiehandleiding voor Telegram-pushmeldingen

Configuratieprincipe en interfacestructuur

Telegram-berichtpushes worden geïmplementeerd op basis van de Telegram Bot API. De volledige push-URL wordt samengesteld uit de Bot Token (toegangssleutel van de bot) en de Chat ID (unieke identificatie van de ontvanger).

Standaardsjabloon voor samenvoegen:

[https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/sendMessage?chat_id=<CHAT_ID>

Stappen om te verkrijgen

Stap 1: maak een bot aan en verkrijg de Bot Token

1. Open Telegram, voer in de zoekbalk de officiële bot @BotFather in en volg deze.
2. Stuur het commando naar @BotFather: /newbot.
3. Voer achtereenvolgens de gevraagde gegevens in:
   • Bot Name: de weergavenaam van de bot (bijvoorbeeld: Meldingsassistent).
   • Bot Username: de unieke gebruikersnaam van de bot (moet eindigen op bot, bijvoorbeeld: my_notice_bot).
4. Na succesvolle aanmaak geeft @BotFather de API-toegangsgegevens weer. Kopieer de tekenreeks HTTP API Token (met een formaat zoals 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).

Stap 2: verkrijg de Chat ID van de ontvanger

Kies de juiste methode op basis van het type berichtontvanger (persoon of groep):

Optie A: meldingen ontvangen als persoon

• Methode één: via de officiële opzoekbot (aanbevolen)
  1. Zoek in Telegram naar @userinfobot en volg deze.
  2. Stuur een willekeurig bericht naar de bot of klik op /start.
  3. De bot retourneert de metadata van het persoonlijke account; het zuiver numerieke getal achter Id is uw persoonlijke Chat ID (bijvoorbeeld: 987654321).
• Methode twee: via de API-interface opvragen
  1. Stuur actief een bericht naar de bot die u zojuist hebt aangemaakt (bijvoorbeeld: hello) om het gesprek te activeren.
  2. Open de browser en bezoek de volgende link (vervang <TOKEN> door de in stap 1 verkregen toegangsgegevens):

      [https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/getUpdates

  3. Haal in de geretourneerde JSON-respons de numerieke waarde op van "result" -> "message" -> "chat" -> "id".

Optie B: meldingen ontvangen in een groep/kanaal

1. Voeg de nieuw aangemaakte bot toe aan de doelgroep in Telegram.
2. Stuur in de groep een willekeurig bericht (bijvoorbeeld: test) of geef de bot beheerdersrechten.
3. Bezoek in de browser de volgende link (vervang <TOKEN> door de in stap 1 verkregen toegangsgegevens):

    [https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/getUpdates

4. Zoek in de geretourneerde JSON-respons het record dat de bijbehorende groepsnaam bevat en haal het veld "chat" -> "id" op.

   Let op: de Chat ID van een groep is meestal een negatief getal dat begint met - of -100 (bijvoorbeeld: -100123456780); bij het samenvoegen moeten het minteken en het voorvoegsel volledig behouden blijven.

Drie, voorbeeld van URL-samenvoeging

Nadat u <TOKEN> en <CHAT_ID> hebt verkregen, vult u deze in het standaardsjabloon in ter vervanging:

1. Voorbeeld van persoonlijke meldings-URL

• Token: 8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t
• Chat ID: 987654321
• Uiteindelijke samengestelde resultaat:

  [https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=987654321](https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=987654321)

2. Voorbeeld van groepsmeldings-URL

• Token: 8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t
• Chat ID: -7
• Uiteindelijke samengestelde resultaat:

  [https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=-100123456780](https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=-100123456780)