notify

Create a bot with @BotFather, export the token as TELEGRAM_BOT_TOKEN, and run notify.py with an event and message flag. The script sends via the Telegram Bot API over HTTPS using only the Python standard library, so it works in detached jobs.

Message @BotFather on Telegram, send /newbot, and follow the prompts to receive a token. Then message your bot once and run the telegram_get_chat_id.py helper script with the token exported to print your chat_id.

Yes, sending with the question event blocks and polls Telegram for your reply, printing it as JSON with exit code 0. Inline buttons or free-text replies both work, and a timeout returns exit code 5 so scripts can fall back to a default.

Telegram allows only one process to long-poll a bot token, so a second getUpdates call returns 409 Conflict. Run the notifyd dispatcher daemon as the single poller and let jobs communicate through its spool directory instead.

Yes, the scripts are pure Python and run unchanged on Windows. The references include PowerShell commands for setting environment variables, sending messages, and running the dispatcher as a logon task or NSSM service.

Telegram rejects messages over 4096 characters, so longer bodies are automatically split into numbered parts that break on newlines where possible. Buttons attach to the final part, and whitespace is preserved exactly across boundaries.