Skip to content
MKController

MikroTik Telegram Alerts with MKController

Summary MKController’s Telegram integration sends device alert notifications — such as offline events — directly to your Telegram account through the @mkcontroller_bot. Configuration takes two steps: find your Telegram user ID using @userinfobot, then link it to your MKController account under Sites → Settings → Users. Once active, alerts arrive 24/7 without requiring you to check the dashboard.

What Is MKController Telegram Alert Integration?

MKController Telegram integration is a notification channel that delivers device alert messages — offline events, reconnections, and custom alerts — directly to your Telegram account via the official @mkcontroller_bot. Once configured, you receive push notifications on your phone in real time, without needing to open the MKController dashboard.

Telegram is the notification channel of choice for many ISPs and WISPs because it is free, works on all mobile operating systems, and delivers messages reliably even in low-bandwidth conditions — making it ideal for network operators who are frequently on-site.

This guide uses offline device alerts as the example, but the same steps apply to any alert type in MKController.

Step 1: Find Your Telegram User ID

You need your Telegram numeric user ID to link the account. The fastest way to get it is through @userinfobot.

  1. Open Telegram on your phone or at web.telegram.org.

  2. In the search bar, type @userinfobot.

    Search for @userinfobot in Telegram

  3. Select @userinfobot from the results and click Start.

  4. The bot responds with your account details. Copy the number shown in the Id field — this is your Telegram user ID.

    Telegram userinfobot showing your numeric user ID

Step 2: Configure the Alert in MKController

  1. Log in to app.mkcontroller.com.

  2. In the left menu, go to Sites and open the Settings for the Site where you want to enable alerts.

    Sites → Settings in MKController menu

  3. In the Alerts section, click the pencil icon next to the alert type you want to configure (for this example: device offline).

    Edit Alert option in MKController Sites Settings

  4. Set the alert frequency. For example, 5 minutes means MKController will send one alert every 5 minutes for as long as the device remains offline. Choose the interval that matches your SLA requirements.

  5. Click Save.

    Alert frequency configuration in MKController

  1. Still in the Site Settings, go to the Users section and click the pencil icon next to your user.

    Edit User in MKController Site Settings

  2. In the Telegram field, paste your Telegram user ID (the number from Step 1).

  3. Click Save and then OK on the confirmation popup.

    Enter Telegram user ID in MKController user settings

Step 4: Activate the MKController Telegram Bot

  1. Back in Telegram, search for @mkcontroller_bot.

    Search for @mkcontroller_bot in Telegram

  2. Click Start on the bot’s page.

  3. Within a few moments, the bot sends a confirmation message and begins forwarding alerts from your MKController account.

    MKController Telegram bot sending device alert notifications

You are now set up to receive device alerts on Telegram 24 hours a day, 7 days a week.

Alert Configuration Tips

Set the alert frequency to match your SLA. A 5-minute interval is a good starting point for most ISPs — long enough to avoid alert fatigue from brief outages, short enough to meet a 15-minute response SLA. If you have mission-critical links, consider a 1-minute interval.

Use per-Site bots for larger teams. If you have multiple Sites with different technician teams, each team member only needs to link their Telegram ID to the Sites they are responsible for. Alerts are automatically scoped to the Site they came from, so a technician for Site A does not receive alerts for Site B.

Test the integration immediately after setup. The easiest way to verify the integration is working is to take a test device offline (or disable its WAN interface for 30 seconds) and confirm the alert arrives on Telegram before the configured frequency elapses.

Troubleshooting Telegram Alerts

The bot sent a confirmation but I am not receiving device alerts. Verify that the alert type is configured in Sites → Settings → Alerts and that the frequency is not set to a very long interval. Also confirm the Telegram user ID entered in the Users section is the correct numeric ID (not a username).

@userinfobot did not respond. Make sure you started the bot by clicking Start after finding it in the search results. Telegram bots require an explicit Start command before they can send messages.

I stopped receiving alerts after a few days. Telegram occasionally requires bots to re-authenticate if the user has not interacted with them recently. Open @mkcontroller_bot in Telegram and click Start again. The bot will resume forwarding alerts.

I want to receive alerts only during working hours. MKController sends alerts based on the Site’s alert configuration, which currently fires for all online/offline events. If you want to suppress overnight alerts, consider adjusting the alert frequency to a longer interval for after-hours periods, or discuss advanced filtering with the MKController support team.

Questions about Telegram alerts or notification configuration? Talk to our team on WhatsApp or visit app.mkcontroller.com.