Impf Bot.py 🐍 ⚡ – Bot für Impftermine

Entspahnt in den Sommer ☀

Automatisierte Impftermin-Vermittlung des offiziellen ImpfterminService - Der Patientenservice 116117. Der Bot kann mehrere Standorte parallel durchsuchen und auf verfügbare Terminen überwachen. Dabei wird der gesamte Prozess von der Vermittlungscode-Beschaffung bis zur Reservierung und Benachrichtigung freier Termine ganzheitlich abgebildet.

Wenn ein freier Impftermin / Slot gefunden wird, sendet der Bot eine Benachrichtigung via Zulip (Telegram, Slack, ... sind einfach integrierbar) und macht den Benutzer via Sprachausgabe auf den Slot aufmerksam. So kann der SMS Bestätigungscode manuell oder von überall unterwegs via Lieblings-Chat App übermittelt werden - Impf Bot.py erledigt den Rest. - detaillierter Workflow

Der Bot verwendet Browser-Automatisierung, die im Hintergrund laufen kann und es dem Benutzer ermöglicht manuell einzugreifen sowie einfach nachzuvollziehen, was gerade passiert. Die wichtigen Timings können dabei eingestellt werden, um einen Timeout (bzw. Shadow Ban) zu vermeiden.

This is an improved Python implementation of the Java-based 💉 🤖 Impf-Bot

⭐ Features

⭐ Easy to set up
⭐ Python for the 21st Century
⭐ Full browser automation
⭐ Concurrent checking
⭐ Waiting room detection
⭐ Timeout / Shadow Ban 429 detection
⭐ Automatically re-check Vermittlungscode
⭐ settings.py for single point of configuration
⭐ Zulip integration
⭐ Run custom Commands for Alerting (Text-to-Speech preconfigured)
⭐ Easy to add additional backends, like Telegram, Slack, Webhooks ...

Workflow

This is a two-step process. First you'll need a Vermittlungscode to then book a vaccination appointment. Each center^* has its own valid Vermittlungscode, which you'll need to acquire first to advance to the next step.

1. If you do not have a Vermittlungscode for a center yet
   • The bot will check the site to see if there is vacancy
   • If there is vacancy, the bot will enter your age, email and phone number
   • The bot will alert you that there is vacancy using the alert backends
   • ImpfterminService will send you a SMS with a confirmation code
   • Either enter the code manually or send it to the bot using sms:123-456
   • The Vermittlungscode is sent to your email
   • Enter the Vermittlungscode on the center in settings.py and restart the bot 🚨
2. If you have a Vermittlungscode for a center
   • The bot will enter your Vermittlungscode
   • It will check if there are available appointments
   • If there are appointments, it will alert you using your alert backend
   • You will have to manually choose the appointment for your best convenience
   • Alternatively use a remote access tool (I prefer AnyDesk, but TeamViewer also works) to access your machine remotely

^{* Every center is hosted on a server, indicated by the numbers in the URL, e.g. https://001-iz.impfterminservice.de/impftermine/service?plz=70713 is server 001. Vermittlungscodes are valid for every center on the given server}

⚠ Warning: The online booking isn't an authorization

On the booking date you still have to bring the documents with you, to proof that you are qualified to receive the vaccination. Check out the official guidelines and make sure you are qualified for them. This bot doesn't help you get a privilege. It only allows you to get a date without losing the nerves or waisting a lifetime in pointless callcenter calls.

Setup 👾

Requirements

• Python 3.x
• Selenium for Chrome
• Google Chrome
• pip3 install -r requirements.txt

For Dummies

I don't know anything about programming! And CLI gives me anxiety

Don't worry. It's easy. Follow this Step-by-Step Guide and then come back.

For Techies

git clone https://github.com/alfonsrv/impf-botpy.git
cd impf-botpy
pip3 install -r requirements.txt
# configure settings.py
mv settings.sample.py settings.py
python3 main.py

Configuration

1. Rename settings.sample.py to settings.py
2. Edit the LOCATIONS by adding your Impfzentrum with the name as shown on ImpfterminService
3. If you already have a Vermittlungscode for one of the centers, enter it at code - otherwise leave empty
4. Enter your age, mail and phone number
5. The rest of the settings is ok as is. If you want to check locations with multiple browsers at the same time, dig into the Advanced Features section.

Run it

• python3 main.py und entspahnen
• python3 main.py --alerts to test configured alerts

Support & Contributing

Feature Requests & Feedback

Too complex? Successfully booked an appointment?
Feedback and reasonable feature requests are always much appreciated and can be submitted here!

Adding Backends for Alerts

Contributions are welcome! Adding your favorite backend (e.g. Slack) for alerting is easy. Simply add your preferred integration to

1. alert.py and integrate it with read_code() and send_alert()
2. constructor.py if your API is a bit more complex to keep things tidy
3. settings.py add your relevant settings (must include ENABLED flag)
4. main.py in print_config for NextGen UX
5. Pull Request & Done 💥

Auch ich wünschte, dass es so n Tool nicht geben müsste, aber ist aktuell einfach absolute Katastrophe. Seid vernünftig und missbraucht den Bot nicht, ja?