Telegram интеграция
INFRAX поддерживает интеграцию с Telegram для отправки уведомлений пользователям о важных событиях в системе. Каждый пользователь может подключить свой Telegram-аккаунт и настроить, какие уведомления он хочет получать.
Настройка Telegram бота
Перед тем как пользователи смогут подключить Telegram, администратор должен настроить бота в системе.
Создание бота в Telegram
Шаги создания бота через @BotFather
- Откройте Telegram и найдите бота @BotFather
- Отправьте команду
/newbot - Следуйте инструкциям: укажите имя бота и его username
- После создания вы получите токен бота — сохраните его
Настройка бота в INFRAX
Конфигурация в настройках приложения
- Перейдите в раздел настроек приложения
- Найдите секцию Telegram
- Вставьте токен бота в поле Токен бота
- Включите опцию Включить Telegram бота
- Нажмите кнопку сохранения настроек
После сохранения токена система автоматически проверит подключение и отобразит информацию о боте: имя, ID и username. Это подтверждает, что токен указан правильно и бот готов к работе.
INFRAX использует технологию Long Polling для получения сообщений от Telegram. Это означает, что система не требует публичного IP-адреса или настройки webhook — бот работает автоматически после включения.
Подключение пользователей
После настройки бота каждый пользователь может подключить свой Telegram-аккаунт для получения уведомлений.
Доступ к настройкам Telegram
Как открыть настройки
- Перейдите в раздел Мои предпочтения
- Откройте вкладку Telegram
Быстрое подключение (рекомендуется)
Самый простой способ подключения — использование кнопок быстрого доступа.
Подключение через приложение
- В разделе "Быстрое подключение" нажмите кнопку Открыть в приложении Telegram
- Система сгенерирует уникальную ссылку и автоматически откроет приложение Telegram
- В Telegram нажмите кнопку START или НАЧАТЬ
- Вернитесь в INFRAX — подключение будет установлено автоматически
Подключение через браузер
Если у вас не установлено приложение Telegram или вы предпочитаете использовать веб-версию:
- Нажмите кнопку Открыть в браузере
- Откроется веб-версия Telegram с вашим ботом
- Нажмите кнопку START
- Вернитесь в INFRAX и нажмите Обновить статус
Альтернативный способ: код подключения
Если автоматическое подключение не работает, используйте метод с кодом.
Подключение по коду
- В разделе "Альтернативный способ" нажмите Создать код подключения
- Скопируйте сгенерированный код
- Откройте бота в Telegram (используйте ссылку на странице)
- Отправьте скопированный код боту
- Вернитесь в INFRAX и нажмите Обновить статус
Подтверждение подключения
После успешного подключения на странице отобразится информация о вашем Telegram-аккаунте:
- Пользователь — ваш username в Telegram
- Имя — ваше имя и фамилия
- Подключен — дата и время подключения
Если после выполнения действий в Telegram статус подключения не обновился, нажмите кнопку Обновить статус. Система проверит подключение и обновит информацию.
Настройка уведомлений
После подключения Telegram вы можете выбрать, какие уведомления хотите получать.
Доступ к настройкам уведомлений
Настройки уведомлений отображаются на той же странице после успешного подключения Telegram, в разделе Настройки уведомлений.
Настройка типов уведомлений
Включение и отключение уведомлений
- Найдите раздел Настройки уведомлений
- Отметьте чекбоксы для уведомлений, которые хотите получать
- Снимите отметки с уведомлений, которые не хотите получать
- Нажмите кнопку Сохранить настройки
Уведомления разделены на тематические группы для удобства настройки. Каждый тип уведомления имеет название и описание, поясняющее, когда оно отправляется.
Каждый пользователь настраивает уведомления независимо. Вы можете выбрать только те уведомления, которые важны именно для вас, не влияя на настройки других пользователей.
Типы уведомлений
INFRAX поддерживает отправку различных типов уведомлений через Telegram.
Уведомления о тикетах
| Тип уведомления | Когда отправляется |
|---|---|
| Новый тикет | Когда создается новый тикет |
| Новое сообщение | При добавлении нового сообщения в тикет |
| Назначение тикета | Когда тикет назначается пользователю |
| Снятие назначения | Когда пользователь удаляется из исполнителей тикета |
| Переназначение | Когда тикет переназначается на другого исполнителя |
| Изменение статуса | При изменении статуса тикета |
| Изменение приоритета | При изменении приоритета тикета |
| Изменение срока | При изменении срока выполнения тикета |
| Закрытие тикета | Когда тикет закрывается |
| Закрытие пользователем | Когда тикет закрывается пользователем (клиентом) |
| Автоматическое закрытие | Когда тикет закрывается автоматически |
| Истечение срока | Когда истекает срок выполнения тикета |
Уведомления о мониторинге
| Тип уведомления | Когда отправляется |
|---|---|
| Создание инцидента | При возникновении проблемы с узлом (недоступность, перегрузка ресурсов) |
| Критический инцидент | При возникновении критической проблемы с узлом |
| Критический запрос | При создании тикета с критическим приоритетом |
Технические уведомления
| Тип уведомления | Когда отправляется |
|---|---|
| Ошибка доставки email | Когда система не смогла отправить email-уведомление |
| Тестовое уведомление | При проверке работы уведомлений |
Вы можете включить только те уведомления, которые необходимы для вашей работы. Например, администратор helpdesk может включить все уведомления о тикетах, а специалист мониторинга — только уведомления об инцидентах.
Проверка уведомлений
INFRAX позволяет проверить работу уведомлений без ожидания реальных событий.
Отправка тестового уведомления
Как проверить уведомления
- Убедитесь, что Telegram подключен
- На странице настроек Telegram нажмите кнопку Проверить уведомления
- Система отправит тестовое сообщение в ваш Telegram
- Проверьте, что сообщение пришло
Тестовое уведомление подтверждает, что:
- Токен бота настроен правильно
- Ваш Telegram-аккаунт подключен корректно
- Система может отправлять сообщения
Отключение Telegram
Если вы хотите отключить Telegram-уведомления:
Отвязка аккаунта
- Перейдите на страницу настроек Telegram
- Нажмите кнопку Отключить Telegram
- Подтвердите действие
После отключения вы перестанете получать уведомления. При необходимости можно снова подключить Telegram в любой момент.
Рекомендации
Рекомендации по настройке уведомлений
- Выбирайте важные уведомления — включайте только те уведомления, которые требуют вашего внимания, чтобы избежать информационной перегрузки
- Критические события — обязательно включите уведомления о критических инцидентах и запросах, если вы работаете с мониторингом или helpdesk
- Используйте быстрое подключение — метод с кнопками "Открыть в приложении" или "Открыть в браузере" работает надежнее, чем ручной ввод кода
- Проверяйте подключение — после первого подключения отправьте тестовое уведомление, чтобы убедиться, что все работает
- Обновляйте статус — если подключение не установилось сразу, используйте кнопку "Обновить статус"
Рекомендации для администраторов
- Создайте понятное имя бота — используйте имя, связанное с вашей организацией или системой, чтобы пользователи легко его узнали
- Защитите токен — токен бота дает полный доступ к управлению ботом, храните его в безопасности
- Информируйте пользователей — объясните сотрудникам, как подключить Telegram и какие уведомления им стоит включить для эффективной работы
- Проверьте работу Long Polling — убедитесь, что служба получения сообщений от Telegram запущена и работает корректно
Telegram-уведомления позволяют оперативно реагировать на важные события в системе, даже когда вы не находитесь за компьютером. Это особенно важно для критических инцидентов мониторинга и срочных тикетов в helpdesk.