Telegram
Уведомления администраторам через Telegram-бота. Выбор получателя производится по ID чата.
Откройте Интеграции → Добавить интеграцию → Telegram. Для уже установленного подключения используйте Настроить.
Подготовка
- Откройте @BotFather в Telegram, отправьте /newbot, задайте имя и скопируйте выданный токен.
- Добавьте бота в целевой чат или канал и дайте право отправлять сообщения; для личного чата сначала напишите боту.
- Получите chat ID из update объекта Bot API или используйте допустимый идентификатор канала, затем укажите его в форме.
- Для стандартного подключения оставьте адрес API пустым: будет использован https://api.telegram.org. Затем сохраните настройки и проверьте подключение.
Параметры
| Поле | Вид | Назначение и правила заполнения |
|---|---|---|
| ID чата | Настройка | Идентификатор получателя из message.chat.id в Bot API; для канала допустимый формат определяет Bot API. |
| Адрес API Telegram | Настройка | Адрес сервиса Telegram Bot API. Обычно поле оставляют пустым; адрес прокси указывают только по инструкции администратора. |
| Токен бота | Секрет | Секретный token, выданный @BotFather. Не публикуйте и отзовите через BotFather при утечке. |
Сохранение и изменение
Заполните параметры и нажмите «Сохранить». При повторном открытии секреты не показываются: индикатор наличия секрета не является его значением. Пустое поле существующего секрета сохраняет прежнее значение; новое значение заменяет его. После изменения проверьте подключение заново.
Тип Telegram доступен в полном каталоге интеграций.
Проверка результата
- Убедитесь, что бот имеет доступ к выбранному чату и право отправлять сообщения.
- Выполните проверку подключения в MDM.
- Проверьте разрешённое тестовое уведомление именно в нужном чате, затем свяжите канал с правилом уведомлений.
Статус «Настроено» означает сохранённые настройки. Результат проверки соединения и результат целевой операции оценивайте отдельно. Подробности проверки доступны в карточке подключения.
Ограничения и зависимости
В личном чате пользователь должен начать общение с ботом. Успех авторизации бота не подтверждает доступ к выбранному чату. Endpoint оставляйте пустым для стандартного Bot API; адрес прокси должен быть согласован с администратором.
Если не работает
| Симптом | Что проверить |
|---|---|
| Бот авторизуется, сообщения нет | Проверьте chatId, участие бота в группе или канале и права на отправку. |
| Unauthorized | Проверьте токен и его отзыв в BotFather. |
| Ошибка доступа к API | Проверьте сетевой доступ сервера MDM и необязательный endpoint. |