Перейти к содержимому
MKController

MikroTik Telegram Уведомления с MKController

Кратко Интеграция MKController с Telegram отправляет уведомления о событиях с устройств — например, об уходе в офлайн — напрямую в ваш аккаунт Telegram через бота @mkcontroller_bot. Настройка состоит из двух шагов: получите свой Telegram user ID с помощью @userinfobot, а затем привяжите его к вашей учётной записи MKController в разделе Sites → Settings → Users. После активации уведомления приходят круглосуточно, без необходимости проверять панель управления.

Что такое интеграция MKController с уведомлениями Telegram?

Интеграция MKController с Telegram — это канал уведомлений, который доставляет сообщения о событиях устройств — уходе в офлайн, восстановлении подключения и пользовательских предупреждениях — напрямую в ваш аккаунт Telegram через официального бота @mkcontroller_bot. После настройки вы получаете push-уведомления на телефон в режиме реального времени, не открывая панель управления MKController.

Telegram стал предпочтительным каналом уведомлений для многих интернет-провайдеров и WISP, поскольку он бесплатен, работает на всех мобильных ОС и надёжно доставляет сообщения даже при ограниченной полосе пропускания — идеальный вариант для сетевых операторов, которые часто работают на выезде.

В этом руководстве в качестве примера используются уведомления об уходе устройства в офлайн, но те же шаги применимы к любому типу предупреждений в MKController.

Шаг 1: получите свой Telegram user ID

Чтобы привязать аккаунт, вам понадобится числовой Telegram user ID. Быстрее всего получить его через @userinfobot.

  1. Откройте Telegram на телефоне или зайдите на web.telegram.org.

  2. В строке поиска введите @userinfobot.

    Поиск @userinfobot в Telegram

  3. Выберите @userinfobot из результатов и нажмите Start.

  4. Бот ответит сведениями о вашей учётной записи. Скопируйте число, указанное в поле Id — это и есть ваш Telegram user ID.

    Telegram-бот userinfobot показывает ваш числовой user ID

Шаг 2: настройте уведомление в MKController

  1. Войдите в app.mkcontroller.com.

  2. В левом меню перейдите в Sites и откройте Settings того Site, для которого нужно включить уведомления.

    Sites → Settings в меню MKController

  3. В разделе Alerts нажмите значок карандаша рядом с типом уведомления, который хотите настроить (в нашем примере: устройство офлайн).

    Опция редактирования уведомления в настройках Sites MKController

  4. Задайте частоту уведомлений. Например, 5 minutes означает, что MKController будет отправлять одно уведомление каждые 5 минут, пока устройство остаётся офлайн. Выберите интервал, соответствующий требованиям вашего SLA.

  5. Нажмите Save.

    Настройка частоты уведомлений в MKController

Шаг 3: привяжите свой Telegram ID к учётной записи MKController

  1. Оставаясь в настройках Site, перейдите в раздел Users и нажмите значок карандаша рядом с вашим пользователем.

    Редактирование пользователя в настройках Site MKController

  2. В поле Telegram вставьте свой Telegram user ID (число, полученное на Шаге 1).

  3. Нажмите Save, а затем OK во всплывающем окне подтверждения.

    Ввод Telegram user ID в настройках пользователя MKController

Шаг 4: активируйте Telegram-бота MKController

  1. Вернитесь в Telegram и найдите @mkcontroller_bot.

    Поиск @mkcontroller_bot в Telegram

  2. На странице бота нажмите Start.

  3. Через несколько секунд бот пришлёт сообщение-подтверждение и начнёт пересылать уведомления из вашего аккаунта MKController.

    Telegram-бот MKController отправляет уведомления о событиях устройства

Теперь вы настроены на получение уведомлений о событиях устройств в Telegram 24 часа в сутки, 7 дней в неделю.

Советы по настройке уведомлений

Выбирайте частоту уведомлений в соответствии с вашим SLA. Интервал 5 минут — хорошая отправная точка для большинства интернет-провайдеров: достаточно длинный, чтобы избежать утомления от уведомлений при кратковременных сбоях, и достаточно короткий, чтобы укладываться в 15-минутный SLA на реагирование. Для критически важных каналов имеет смысл выставить интервал 1 минута.

Используйте отдельных ботов на каждый Site для крупных команд. Если у вас несколько Site с разными командами техников, каждому участнику достаточно привязать свой Telegram ID только к тем Site, за которые он отвечает. Уведомления автоматически привязаны к тому Site, из которого они поступили, поэтому техник, отвечающий за Site A, не будет получать уведомления для Site B.

Сразу после настройки проверьте интеграцию. Самый простой способ убедиться, что интеграция работает — отправить тестовое устройство в офлайн (или на 30 секунд отключить его WAN-интерфейс) и убедиться, что уведомление приходит в Telegram до истечения заданного интервала.

Устранение неполадок с уведомлениями Telegram

Бот прислал подтверждение, но уведомления об устройствах не приходят. Убедитесь, что нужный тип уведомления настроен в Sites → Settings → Alerts и что для частоты не задан слишком длинный интервал. Также проверьте, что в разделе Users указан правильный числовой Telegram user ID (а не имя пользователя).

@userinfobot не ответил. Убедитесь, что вы запустили бота, нажав Start после того, как нашли его в результатах поиска. Telegram-боты требуют явной команды Start, прежде чем смогут отправлять сообщения.

Через несколько дней уведомления перестали приходить. Telegram иногда требует от ботов повторной аутентификации, если пользователь давно с ними не взаимодействовал. Откройте @mkcontroller_bot в Telegram и снова нажмите Start. Бот возобновит пересылку уведомлений.

Я хочу получать уведомления только в рабочее время. MKController отправляет уведомления на основе настроек предупреждений Site, которые в текущей версии срабатывают на все события online/offline. Если вы хотите подавлять ночные уведомления, рассмотрите вариант с увеличением интервала уведомлений для нерабочего времени или обсудите расширенные фильтры со службой поддержки MKController.

Остались вопросы об уведомлениях Telegram или настройке оповещений? Свяжитесь с нашей командой в WhatsApp или зайдите на app.mkcontroller.com.