akshayitzme / cowinalerter-node

Heroku Ready to Deploy Express.js app to check Slot Availability every 15 secs, sends telegram alerts when there is a Slot Available.

CowinAlerter-Node

Automatically checks for available slots every 15 seconds, sends Alerts via Telegram.

Features

• Heroku Ready.
• Checks Slot Availability of 5 days.
• Supports Finding Slots by Pin Code & District Code.
• Personalized Alerts.. Alerts based on Users Age Group, Dose, FirstDose..etc
• Checks Slot Availability in background.

Set Up

Heroku

• Fork this Repository
• Add Users in Users.json refer this gist
• Connect Forked GitHub repo to Heroku.
• Set Telegram Bot Id in Heroku Config Vars. see guide also see env.example
• Add NodeJs Buildpack.
• Deploy App

LocalHost

• Clone this Repository
• Add Users in Users.json refer this gist
• Set Telegram Bot Id in .env file. see env.example
• Install Dependencies yarn install or npm i
• Run Server

   node index

Works well in all other Hosting Platforms.

Notes

• to find district ID, use this API

References

APISetu

Licence

cowinalerter-node's Issues

Repeated duplicate Alerts

Issue: Sends Duplicated Alerts.

Reason:

Cowin DB holds data for 4 minutes. Hence if we send API request within that 4 minutes, we might get cached data. so actually the db is only updated after 4 minutes. since the program checks slot availability every 15 seconds.. each 15 seconds in 4 minute, it gets cached data. that's why the program sends duplicate alerts. within that time that slot maybe expired or the available dose count must have changed.

Duplicate alerts will flood the chat with unwanted messages. eventually becomes a problem 😞

Solution

create an effective method to find duplicate alerts. session_id might be a helpful. ensure one session_id is alerted only once.