Обзор
MAX-оповещения позволяют получать уведомления о работе ИИ-агента в российский мессенджер MAX через выделенный alert-бот. В назначенный MAX-чат дублируются сообщения клиентов и ответы агента — вы контролируете диалоги без захода в Leadarr.
Где найти
Настройки → Telegram & MAX оповещения. Секция «MAX оповещения» расположена в нижней части страницы.
Как устроено
Архитектура двухуровневая:
| Уровень | Что настраивается | Кто настраивает |
|---|---|---|
| Организация | Токен alert-бота (через переменную окружения MAX_ALERT_BOT_TOKEN) | Администратор Leadarr / DevOps |
| Агент | Chat ID MAX-чата, в который отправлять события этого агента | Пользователь в интерфейсе |
MAX_ALERT_BOT_TOKEN)». Обратитесь к администратору Leadarr, чтобы подключить бота.Статус и бот
В верхней части секции отображается статус-карточка с тремя полями:
| Поле | Значения |
|---|---|
| Статус | «Настроен на сервере» (зелёный) или «Не настроен» (серый) |
| Bot | Username или имя alert-бота (если настроен) |
| Health | «Бот активен» или «Бот недоступен» |
Когда статус зелёный, можно привязывать Chat ID к отдельным агентам.
Создание MAX-бота
Для каждого агента создайте отдельный MAX-чат с ботом и возьмите его Chat ID. Сам бот уже создан администратором Leadarr (через MasterBot) — вам остаётся только добавить его в нужный чат.
Откройте MAX и найдите бота
Посмотрите username alert-бота в строке Bot на странице настроек Leadarr. Найдите этого бота в MAX и начните с ним диалог или добавьте его в групповой чат.
Создайте отдельный чат для агента
Рекомендуется: один чат = один агент. Так уведомления не смешиваются, и команду под каждое направление проще разделить.
Получите Chat ID
Chat ID — числовой идентификатор чата (пример: 257722176). Узнать его можно через сервисные команды MAX или через бота-помощника.
/newbot, получите Access Token и передайте его администратору Leadarr. Он пропишет токен в переменную MAX_ALERT_BOT_TOKEN.Chat_id для агента
Когда alert-бот настроен, на странице появляется раскрывающаяся секция «Chat_id для каждого агента» со счётчиком N / Всего.
Разверните список агентов
Нажмите на заголовок «Chat_id для каждого агента» — появится таблица со всеми вашими агентами. Если агентов ещё нет, отобразится сообщение «Пока нет агентов. Сначала создайте агента.»
Впишите Chat ID
В строке нужного агента введите число в поле с плейсхолдером «например, 257722176».
Нажмите «Сохранить»
Кнопка с иконкой дискеты справа от поля. При сохранении бэкенд выполняет проверку Chat ID — если бот не добавлен в чат или ID неверный, появится ошибка. При успехе покажется «Сохранено».
Удаление привязки
Рядом с сохранённым Chat ID появляется кнопка «Очистить» (крестик). Нажмите — привязка агента к MAX-чату будет удалена, уведомления этого агента в MAX приходить перестанут.
MAX vs Telegram-оповещения
| Параметр | MAX | Telegram |
|---|---|---|
| Мессенджер | MAX (российский) | Telegram |
| Настройка бота | Один alert-бот на всю организацию (токен на сервере) | Один бот Leadarr для всех |
| Привязка чата | Отдельный Chat ID для каждого агента | Один Chat ID на организацию |
| Количество чатов | Сколько угодно — по одному на агента | Одна супергруппа |
| Права для настройки | Админ + пользователь | Только пользователь |
Ключевое отличие — гранулярность. MAX-оповещения удобны, когда несколько команд ведут разных агентов и не хотят видеть чужие уведомления. Telegram-оповещения проще — одна группа для всей организации.
Устранение проблем
| Проблема | Решение |
|---|---|
| Статус «Не настроен» | Токен alert-бота не прописан на сервере. Обратитесь к администратору Leadarr. |
| «Бот недоступен» | Alert-бот временно не отвечает. Проверьте состояние инфраструктуры или обратитесь в поддержку. |
| Ошибка при сохранении Chat ID | Чаще всего — бот не добавлен в чат. Добавьте бота и повторите сохранение. |
| Уведомления не приходят | Проверьте, что Chat ID сохранён (иконка-галочка), бот находится в чате и агент активен (кнопка ⏻ зелёная). |
| «Пока нет агентов» | Создайте агента в разделе AI Агенты — после этого он появится в списке. |
Частые вопросы
Нет. Alert-бот настраивается один раз администратором Leadarr на уровне всей организации. Вам нужно только добавить его в чат и указать Chat ID.
Да. Укажите один и тот же Chat ID в нескольких строках. Но обычно удобнее разделять — так проще различать диалоги по источнику.
Да. Это независимые системы — каждая срабатывает по своим правилам. События агента будут приходить и туда, и туда.
Привязка Chat ID исчезнет вместе с агентом. Создав нового — привяжите к нему Chat ID заново.