Telegram

The Telegram plugin for Login AlertX sends a formatted alert message directly to a Telegram chat or channel every time a monitored event is detected. Unlike the webhook-based plugins, Telegram uses a Bot Token and a Chat ID — no external webhook URL is needed.

What You Need

• An active Premium license
• A Telegram account (mobile app or desktop)
• The Login AlertX Telegram plugin installed (bundled with Login AlertX v3.3.0+)

Step 1: Create a Telegram Bot

Telegram bots are created and managed via BotFather — Telegram’s official bot management bot.

1. Open Telegram and search for @BotFather, or go directly to t.me/BotFather.
2. Start a conversation and send the command: /newbot
3. BotFather will ask for a display name for your bot (e.g. My Login Alerts).
4. Next, provide a username for the bot — it must end in bot (e.g. mylogin_alerts_bot).
5. BotFather will confirm and provide your Bot Token — a long string like 123456789:ABCdefGhIJKlmNoPQRstuVWXyz. Copy and save this securely.

🔒 Keep your Bot Token private. Anyone with your token can send messages through your bot. Never share it publicly.

Step 2: Get Your Chat ID

Login AlertX needs to know where to send messages — this is identified by a Chat ID.

Option A — Send alerts to yourself (personal chat)

1. Search for your new bot by its username in Telegram and Start it (send /start).
2. Open a browser and go to:
   https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
   (Replace <YOUR_BOT_TOKEN> with your actual token.)
3. Look for the "chat" object in the JSON response. Your Chat ID is the numeric "id" value inside it (e.g. 123456789).

Option B — Send alerts to a Telegram channel or group

1. Add your bot to the channel or group as an Administrator.
2. Send any message in that group/channel.
3. Visit https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates — the "id" in the "chat" object will be a negative number (e.g. -1001234567890) for groups and channels. This is your Chat ID.

💡 Tip: If getUpdates returns an empty result, make sure you have sent at least one message to the bot or group after starting it.

Step 3: Configure the Plugin in Login AlertX

1. Open Login AlertX from the system tray.
2. Navigate to the Plugins tab.
3. Locate Telegram Notification Plugin and click it to open its settings.
4. Enter your Bot Token in the Bot Token field.
5. Enter your Chat ID in the Chat ID field.
6. Click Save.

Step 4: Test the Connection

1. With the Telegram plugin settings open, click Test Connection.
2. Login AlertX will send a test alert via your bot.
3. Check your Telegram chat or channel — the test message should appear within a few seconds.

What a Telegram Alert Looks Like

Each Telegram message includes:

• The event type (Login, Failed Login, Lock, Remote Connect, etc.)
• The Windows account name that triggered the event
• The date and time of the event
• The public IP address at the time
• The anomaly score if applicable

Tips & Troubleshooting

• If the test fails with “Chat not found”, make sure you have started the bot (sent /start) before testing, and that the Chat ID is correct.
• For channels, the bot must be added as an Admin with permission to post messages — otherwise Telegram will reject the message.
• If you revoke your bot token from BotFather (/revoke), you must generate a new token and update Login AlertX.
• Telegram alerts require an active internet connection. Alerts generated while offline are retried automatically when connectivity is restored.
• You can use Telegram alongside email, push, Slack, and other plugins simultaneously.

Next Steps

• Set up Slack Alerts
• Set up Microsoft Teams Alerts
• Set up Google Chat Alerts