Co-WIN automated slot booking

Automatically book vaccine slots as and when they become available

This application aims to automatically book vaccine slots for registered beneficiaries on the Co-WIN website as per availability. Users need to have an account registered on UMANG with the same phone number that is registered with Co-WIN and enable the 4-digit MPIN login process. Options for vaccine registration are obtained beforehand and a booking is attempted once a slot becomes available. No manual intervention (OTP or captcha) from the user is needed.

Features

• Automatic sign-in without manual intervention (no need to enter OTPs or Captchas continuously)
• Options stored between sessions (no need to refill the form every time)
• Ability to select one or more custom beneficiaries
• Filtering using selected state and district
• Filtering using pincode
• Filtering using age limit
• Filtering using vaccine name
• Filtering using vaccine dose
• Filtering using vaccine price
• Filtering using vaccine slot
• Filtering using custom date ranges
• Ability to select update rate
• Auto-download of appointment certificate

Setup

The setup procedure is demonstrated for Google Chrome. A similar procedure should be followed for other webkit browsers as well.

The application automatically sends out requests for OTPs once every few minutes. To automatically capture the OTPs received on the phone in the browser, Google Messages is used along with a browser extension.

1. Make sure Google Messages is installed and selected as the default SMS app on your phone.

2. Visit Google Messages Web on your browser and login by scanning the QR code from your phone. Make sure you select Remember this computer while logging in. On your phone, enable background sync for the Messages app. If configured for the first time, a user prompt asks if you want the app to keep running in the background - select Yes in that case. This will ensure that you are kept logged in for subsequent sessions. Close the tab once you have been logged in.

3. Download the file Google Messages vaccine extension and extract it in a directory. The location of this directory cannot change once it has been set up.

This is dev version of the extension and needs to be set up manually; porting to the extension store is a work in progress.

4. Open Google Chrome. Navigate to More Tools > Extensions.

5. Click on Developer Mode.

6. Click on Load Unpacked.

7. Browse to the directory where you extracted the files and click on Select Folder. Make sure you go inside the Google-Message-Extension directory.

8. The extension should show up on the Extensions page.

9. Visit autoslot.herokuapp.com and click on Connect to Google Messages.

10. A new tab opens up. Wait until the indicator on the top-left of the screen turns green. Do not manually click anywhere on the window, or refresh/close this tab. Doing any of these would result in you failing to log in to the system.

11. Go back to the Automated vaccine slot booking page and login using your UMANG phone number and MPIN.

12. Select your vaccine preferences and click on Start. A vaccine booking will be made automatically once a slot becomes available.

13. The appointment certificate gets downloaded once a booking is made.

You can login to the official Co-WIN portal to reschedule or cancel the appointment if necessary.

License

GNU General Public License v3.0