https://github.com/theoomoregbee/us-visa-appointment-notifier
This is just a script I put together to check and notify me via email (MailGun) when there's an earlier date before my initial appointment date. It doesn't handle rescheduling.
https://github.com/theoomoregbee/us-visa-appointment-notifier
appointments-manager us visa
Last synced: 11 months ago
JSON representation
This is just a script I put together to check and notify me via email (MailGun) when there's an earlier date before my initial appointment date. It doesn't handle rescheduling.
- Host: GitHub
- URL: https://github.com/theoomoregbee/us-visa-appointment-notifier
- Owner: theoomoregbee
- License: mit
- Created: 2022-08-26T01:00:07.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-01-12T16:40:48.000Z (over 2 years ago)
- Last Synced: 2025-04-07T22:12:10.486Z (about 1 year ago)
- Topics: appointments-manager, us, visa
- Language: JavaScript
- Homepage:
- Size: 77.1 KB
- Stars: 113
- Watchers: 9
- Forks: 56
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# US-visa-appointment-notifier
This is just a script I put together to check and notify me via email ([MailGun](https://www.mailgun.com/)) when there's an earlier date before my initial appointment date. It doesn't handle **rescheduling**.
```
$ npm start
=====>>> Step: starting process with 250 tries left
=====>>> Step: logging in
=====>>> Step: checking for schedules
[{"date":"2023-02-08","business_day":true},{"date":"2023-04-26","business_day":true},{"date":"2023-10-11","business_day":true}]
=====>>> Step: starting process with 249 tries left
=====>>> Step: checking for schedules
[{"date":"2023-04-26","business_day":true},{"date":"2023-10-11","business_day":true}]
=====>>> Step: starting process with 248 tries left
=====>>> Step: checking for schedules
[{"date":"2023-10-11","business_day":true}]
=====>>> Step: sending an email to schedule for 2023-10-11
...
```
## How it works
* Logs you into the portal
* checks for schedules by day
* If there's a date before your initial appointment, it notifies you via email
* If no dates found, the process waits for set amount of seconds to cool down before restarting and will stop when it reaches the set max retries.
> see `config.js` or `.env.example` for values you can configure
## Configuration
copy the example configuration file exampe in `.env.example`, rename the copied version to `.env` and replace the values.
### MailGun config values
You can create a free account with https://www.mailgun.com/ which should be sufficient and use the provided sandbox domain on your dashboard. The `MAILGUN_API_KEY` can be found in your Mailgun dashboard, it starts with `key-xxxxxx`. You'll need to add authorised recipients to your sandbox domain for free accounts
## FAQ
* How do I get my facility ID - https://github.com/theoomoregbee/US-visa-appointment-notifier/issues/3
* How do I get my schedule ID - https://github.com/theoomoregbee/US-visa-appointment-notifier/issues/8, https://github.com/theoomoregbee/US-visa-appointment-notifier/issues/7#issuecomment-1372565292
* How to setup Mailgun Authorised recipients - https://github.com/theoomoregbee/US-visa-appointment-notifier/issues/5
## How to use it
* clone the repo
* run `npm i` within the cloned repo directory
* start the process with `npm start`