Skip to content

automatically check your U.S. visa application status in CEAC and notice you instantly!

License

Notifications You must be signed in to change notification settings

Andision/CEACStatusBot

Repository files navigation

CEACStatusBot🤖

查看中文文档

automatically check your U.S. visa application status in CEAC and notice you instantly!

Usage

You can deploy it to your own machine, but it is highly recomanded to use Github Actions.

Environment Variables

  • LOCATION: the location code where you applied for your visa. To find the corresponding code for the embassy, please refer to this table.

  • NUMBER: your Application ID or Case Number help icon (e.g., AA0020AKAX or 2012118 345 0001)

  • PASSPORT_NUMBER: your passport number

  • SURNAME: first 5 Letters of surname

  • TIMEZONE: optional, set your timezone to avoid disturbing during sleep. :-) Some example: Asia/Shanghai America/New_York

Notification by Email

Add the following env variables if you want to send notification by email.

  • FROM: the email address you use to send the notification.

  • TO: the email address you want the notification sent to. You can send to more than one email, split the email address with "|" and without space. Here is an example: first@email.com|second@email.com|third@email.com

  • PASSWORD: the password of the FROM email. Notice: for some email, such as QQ Mail, you should use "authorization code" instead of your password here, because this repo use SMTP to send email. Check the SMTP usage of your Mailbox Service Provider for more details.

  • SMTP: (optional) specify the smtp server to send the email (e.g. smtp.example.com, smtp.example.com:587)

Notification by Telegram bot

Add the following env variables if you want to send notification by a Telegram bot.

Create a Telegram bot and get the info below according to this tutorial.

  • TG_BOT_TOKEN: the bot token

  • TG_CHAT_ID: the chat id you want to receive the notification

Github Actions

  1. folk this repo

  2. set your Environment Variables in Github -> Settings -> Secrets and variables -> Actions -> New repository secret image

  3. check your workflow in Actions and your Mailbox / Telegram

TODO

  • Send Email to multiple emails.
  • Add more third-party notification services.
  • More human-friendly interface.

Special Thanks

Contributor

h4x3rotab : Telegram bot, Adaption to new CEAC interface

Related Project

Part of the code in this repo refers to the following project. Thank you for your pretty work.

About

automatically check your U.S. visa application status in CEAC and notice you instantly!

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages