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