vaccine-slack-notifier

Slack Notifier for India's 18+ Vaccine Appointment

MIT License

Stars
4

Vaccine Slack Notifier

Slack Notifier for India Vaccine Appointment. This checks the Co-WIN portal periodically to find vaccination slots available in the provided pin codes and for your age.

It triggers a slack notification to your channel added as a part of environment variable for all the pin codes added to the environment variable

Note: This utility uses COWIN Public APIs data. There is a delay noticed with respect to updating data with respect to slot availability. Do use the utility with that in mind

Prerequisites

  • You need to setup slack incoming webhooks to be able to receive alerts. Follow the following tutorial and use the webhook link in your environment variables
  • You need a DigitalOcean account to deploy this on a cloud provider. If not click on the deploy button below and first create your account.

Deployment

To deploy this project click the button below to deploy the code on DigitalOcean

Environment Variables

To run this project, you will need to add the following environment variables to your .env file

PINCODES - List of pin codes you want separated by a space

SLACK_WEBHOOK - The Webhook link for slack to trigger messages

SCHEDULE - The Cron Entry to control frequency of hits

AUTH_TOKEN - Your CoWin Auth Token. This needs to be updated everyday as the token is valid for a single day.

An example version can be seen here

Run Locally

Clone the project

  git clone https://github.com/rohitjmathew/vaccine-slack-notifier

Go to the project directory

  cd vaccine-slack-notifier

Using PM2

  • Install PM2
  npm install pm2 -g
  • Start the server
  make pm2-run
  • Stop the server
  make pm2-stop

Using Docker

  • Ensure Docker is installed

  • Start the server

  make docker-run
  • Stop the server
  make docker-stop

Screenshots

Contributing

Contributions are always welcome!

See CONTRIBUTING.md for ways to get started.

License

MIT

This readme was created with readme.so :)