Документация /MAX-оповещения

MAX-оповещения

Получайте уведомления от ИИ-агента в MAX-мессенджер через выделенный alert-бот.

Обзор

MAX-оповещения позволяют получать уведомления о работе ИИ-агента в российский мессенджер MAX через выделенный alert-бот. В назначенный MAX-чат дублируются сообщения клиентов и ответы агента — вы контролируете диалоги без захода в Leadarr.

MAX-оповещения и Telegram-оповещения — независимые параллельные каналы. Можно включить оба одновременно: одни события будут дублироваться и в MAX, и в Telegram.

Где найти

НастройкиОповещения, вкладка MAX. Рядом — вкладка Telegram: оба вида оповещений можно включить одновременно.

Страница «Оповещения» с секциями Telegram и MAX
Страница «Оповещения», вкладка MAX: имя alert-бота с кнопкой «Скопировать», статус-карточка и раскрывающийся список «Chat_id для каждого агента».

Как устроено

Устройство простое:

ЧтоКак работает
Alert-ботГотовый бот Leadarr, один на организацию. Его имя показано на странице оповещений, рядом — кнопка «Скопировать». Создавать своего не нужно.
Chat ID по агентамДля каждого агента вы указываете свой MAX-чат — туда будут приходить события именно этого агента.

Статус и бот

В верхней части секции отображается статус-карточка с тремя полями:

ПолеЗначения
Статус«Настроен на сервере» (зелёный) или «Не настроен» (серый)
BotUsername или имя alert-бота (если настроен)
Health«Бот активен» или «Бот недоступен»

Когда статус зелёный, можно привязывать Chat ID к отдельным агентам.


Подготовка чатов в MAX

Для каждого агента создайте отдельный MAX-чат, добавьте туда alert-бота и возьмите Chat ID чата.

1

Создайте отдельный чат для агента

Откройте MAX и создайте чат или канал под конкретного агента. Рекомендуется: один чат = один агент — так уведомления не смешиваются, и команды под разные направления проще разделить.

2

Добавьте alert-бота и дайте ему права администратора

Имя бота показано на странице оповещений в поле «Добавьте этого бота в чат» — нажмите «Скопировать», найдите бота в MAX, добавьте его в чат и выдайте права администратора.

3

Получите Chat ID

Chat ID — числовой идентификатор чата (пример: 257722176). Узнать его можно через настройки чата или пересылку сообщения.


Chat_id для агента

Когда alert-бот настроен, на странице появляется раскрывающаяся секция «Chat_id для каждого агента» со счётчиком N / Всего.

1

Разверните список агентов

Нажмите на заголовок «Chat_id для каждого агента» — появится таблица со всеми вашими агентами. Если агентов ещё нет, отобразится сообщение «Пока нет агентов. Сначала создайте агента.»

2

Впишите Chat ID

В строке нужного агента введите число в поле с плейсхолдером «например, 257722176».

3

Нажмите «Сохранить»

Кнопка с иконкой дискеты справа от поля. При сохранении бэкенд выполняет проверку Chat ID — если бот не добавлен в чат или ID неверный, появится ошибка. При успехе покажется «Сохранено».

4

Удаление привязки

Рядом с сохранённым Chat ID появляется кнопка «Очистить» (крестик). Нажмите — привязка агента к MAX-чату будет удалена, уведомления этого агента в MAX приходить перестанут.


MAX vs Telegram-оповещения

ПараметрMAXTelegram
МессенджерMAX (российский)Telegram
Настройка ботаГотовый alert-бот Leadarr, один на организациюГотовый бот Leadarr, один для всех
Привязка чатаОтдельный Chat ID для каждого агентаОдин Chat ID на организацию
Количество чатовСколько угодно — по одному на агентаОдна супергруппа
Права для настройкиАдмин + пользовательТолько пользователь

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


Устранение проблем

ПроблемаРешение
Статус «Не настроен»Alert-бот ещё не подключён для вашей организации — напишите в поддержку Leadarr.
«Бот недоступен»Alert-бот временно не отвечает — обратитесь в поддержку.
Ошибка при сохранении Chat IDЧаще всего — бот не добавлен в чат. Добавьте бота и повторите сохранение.
Уведомления не приходятПроверьте, что Chat ID сохранён (иконка-галочка), бот находится в чате и агент активен (кнопка ⏻ зелёная).
«Пока нет агентов»Создайте агента в разделе AI Агенты — после этого он появится в списке.

Частые вопросы

Нужно ли создавать своего бота?
Нет. Leadarr предоставляет готового alert-бота на всю организацию. Вам нужно только добавить его в чат и указать Chat ID.
Можно ли направлять уведомления нескольких агентов в один чат?
Да. Укажите один и тот же Chat ID в нескольких строках. Но обычно удобнее разделять — так проще различать диалоги по источнику.
Можно ли включить MAX и Telegram одновременно?
Да. Это независимые системы — каждая срабатывает по своим правилам. События агента будут приходить и туда, и туда.
Что произойдёт, если удалить агента?
Привязка Chat ID исчезнет вместе с агентом. Создав нового — привяжите к нему Chat ID заново.