Borgerservice Telegram Bot

A Telegram bot that notifies its users when an appointment at Borgerservice becomes available.

Example Setup: MitID appointment

Step 0: Create a .env File (Optional)

Run the following command in a terminal:

$ cp .env.example .env

We will now fill out the missing values in the resulting .env file (or you can simply configure the corresponding environment variables in your shell.)

Step 1: Obtaining a Telegram Bot Token

Create a new Telegram bot by using the BotFather and set up the BORGERSERVICE_TELEGRAM_TOKEN environment variable with the resulting bot token.

Step 2: Obtaining the Borgerservice URL and Cookie

In a web browser, go to this page, set the interface language to English (this is important) in the upper-right corner, then navigate to MitID > Other. Open the DevTools' Network tab, reload the page, copy the current URL as well as the Cookie from the main HTTP request, and set up the corresponding environment variables.

Step 3: Connect to your Bot

Launch the bot by running npm start. You can now add your bot on Telegram, which will subscribe you to the notifications automatically 🙂

Dependencies

• Node v14 (the latest LTS version as of writing)