README.md

SparkyH1BDropBoxAlert

Disclaimer

My script only reads Telegram group and alerts if matching word is found. I am not associated with the telegram group used in this script. This script just downloads the messages shared in the telegram and alerts for availability. Sometimes it could send false alarm. So, have caution.

Overview

SparkyH1BDropBoxAlert is a Python script designed to monitor specific Telegram chats for messages containing available appointment slots for H1B and H4 visa processing, then alert users via email, push notification and Alexa notifications.

Frustration + ChatGpt + Python + free time + innovation = My tool to alert me for the month I need

Read the instructions below and as well as FAQ & Detailed pages under WIKI section.

Prerequisites

Before you can run this script, you will need:

• Python 3.x
  • Download & install Python using https://www.python.org/downloads/
    • Make sure to install these packages as well. telethon pandas pytz requests
• A Telegram account with API access. https://core.telegram.org/api/obtaining_api_id#:~:text=Obtaining%20api_id&text=Sign%20up%20for%20Telegram%20using,parameters%20required%20for%20user%20authorization.
• An SMTP server (Gmail used in this example) for sending emails. https://support.google.com/mail/answer/185833?hl=en
• Optional: An Alexa device with Notify Me and Voice Monkey skills for voice notifications.
  • https://www.amazon.com/Thomptronics-Notify-Me/dp/B07BB2FYFS
  • https://www.amazon.com/TopVoiceApps-com-Voice-Monkey/dp/B08C6Z4C3R
• Optional: IFFT configuration
  • Create an account in IFFT, install its mobile app.
  • Create an Applet in web version with EMAIL. Whenever you receive email to IFFT from your registered email, setup push notication. Make sure to use the same SMTP email used in previous step in here as well. Otherwise push notication will not work.

Configuration

1. Telegram API: Sign up for Telegram API access and obtain your api_id and api_hash. Replace your_telegram_app_id and your_telegram_app_hash in the config.ini with your actual Telegram API credentials.
2. SMTP Settings: Replace [email protected] and your_smtp_password in the config.ini with your actual email and password that will be used to send notifications.
3. Configure IFFT Applet with same email ID to receive push notication - Refer Wiki page for more detailed instruction.
4. Alexa Notify Me: Set up Alexa Notify Me and obtain your access code. Replace your_Alexa_notifify_me_access_code in the config.ini with your actual Notify Me access code.
5. Alexa Voice Monkey: Set up Voice Monkey for your Alexa device and obtain the URL. Replace your_Alex_Voice_Monekey_URL in the config.ini with your actual Voice Monkey URL. Refer WIKI page for detailed instruction

Step 3 to 5 are optional. But highly recommend configuring at least one otherwise, high chance you will the alert.

Installation

To install the required Python libraries, run the following command:

pip install -r requirements.txt

How to Run

python SparkyH1BDropBoxAlert.py