No matching documentation found

Telegram

The Telegram notification channel in Login AlertX delivers real-time, tamper-resistant security alerts directly to your personal Telegram chat, group, or channel. Starting with Login AlertX v4.4.0, Telegram is integrated directly into the core monitoring engine and outbox queue — providing a 1-click auto-pairing wizard, native GPS location pins, and rich security media attachments (webcam photos, desktop screenshots, and ambient audio recordings) with zero external plugin installation required.

What You Need

  • An active Personal, Business, or Server license (or 30-day free trial)
  • A Telegram account (mobile app, desktop, or web)
  • A dedicated Telegram bot (created in under 60 seconds via @BotFather)

Step 1: Create a Telegram Bot

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

  1. Open Telegram and search for @BotFather, or open t.me/BotFather.
  2. Start the chat and send the command: /newbot
  3. BotFather will ask for a display name for your bot (e.g. My Security Alerts).
  4. Next, provide a username for your bot — it must end in bot (e.g. my_login_alertx_bot).
  5. BotFather will generate your Bot Token — a string formatted like 123456789:ABCdefGhIJKlmNoPQRstuVWXyz. Copy this token.
🔒 Keep your Bot Token private. Anyone with your token can send messages through your bot. Never share it publicly or post it in public repositories.

Step 2: 1-Click Auto-Pairing in Login AlertX

Login AlertX features an automatic pairing wizard that discovers and links your Chat ID with zero manual configuration or JSON parsing.

Option A — Personal Chat (Direct to your phone or desktop)

  1. Open Login AlertX from the system tray.
  2. In the sidebar navigation, click Mobile Alerts (or click the Telegram card on the Notification Channels page).
  3. Select the Telegram tab.
  4. Toggle Enable Telegram Alerts to the On position.
  5. Paste your Bot Token into the Bot Token field.
  6. Click Link Telegram. Login AlertX immediately verifies the token with Telegram and displays your bot’s username (e.g. @my_login_alertx_bot).
  7. The status message will prompt: “Open Telegram, find @your_bot and send any message…”
  8. In Telegram, open the conversation with your bot and send any message (e.g. hello or /start).
  9. Login AlertX instantly detects your message, links your Chat ID, and displays a green ✔ Linked! Chat ID: 123456789 status indicator.

Option B — Telegram Channel or Group (For IT Teams & Fleets)

  1. Add your bot to the target channel or group as an Administrator with permission to Post Messages.
  2. In Login AlertX, paste your Bot Token and click Link Telegram.
  3. Send any message in your Telegram group or channel.
  4. Login AlertX will automatically capture the group or channel’s Chat ID (formatted as a negative number, e.g. -1001234567890) and complete the link.

Step 3: Security & Media Attachments

Once linked, customize exactly what evidence is attached to your Telegram alerts:

  • Send Location: Dispatches a native Telegram GPS map pin with precise latitude/longitude coordinates and accuracy radius (or public IP geolocation fallback).
  • Send Webcam Photo: Silently captures a high-resolution photo from the connected webcam upon login or unlock.
  • Send Desktop Screenshot: Captures the active desktop display across all monitors.
  • Send Audio: Records a short ambient audio clip via the system microphone using WASAPI silent capture.

Step 4: Test Your Alert

  1. With the Telegram tab open, click Send Test Message.
  2. Login AlertX dispatches a test alert through the background service.
  3. Check your Telegram chat — the test alert will appear within seconds, confirming that token, chat permissions, and outbox routing are active.
  4. Click Save Settings to ensure all preferences are persisted.

What a Telegram Alert Looks Like

Each Telegram alert is formatted for instant readability and includes:

  • Event Type: Login, Session Unlock, Failed Login Attempt, Remote Desktop Connect, Screen Lock, or System Startup
  • Machine & User: e.g. admin (DESKTOP-PC01) — know exactly which computer was accessed
  • Timestamp: Exact date, local time, and UTC time of the trigger
  • Public IP Address: Accurate external IP with ISP and geographic details
  • AI Anomaly Score: Machine learning risk evaluation (0.00 to 1.00) with classification (Low, Medium, or High Risk)
  • Location Pin: Interactive map pin opening directly in Telegram and Google Maps
  • Evidence Attachments: Full-resolution webcam snapshot, screenshot, or audio recording

Tips & Troubleshooting

  • Progressive Delivery: High-priority text alerts are delivered instantly (< 1 second). Photo and audio attachments follow immediately after capture processing finishes.
  • Offline Queueing: If your machine is disconnected from the internet, alerts are saved in the local SQLite transactional outbox and delivered automatically as soon as internet connectivity returns.
  • Unlinking / Re-pairing: To switch to a different chat or bot, click Unlink on the Telegram tab, enter the new bot token, and re-link.
  • Bot Admin Permissions: For public or private Telegram channels, the bot must have “Post Messages” administrative permission enabled in channel settings.

Next Steps

Scroll to Top