Бот agavacloud_bot доставляет уведомления о событиях и тревогах проектов AgavaCloud. Через меню можно просмотреть подключённые проекты, включить или отключить их уведомления и открыть помощь.

Быстрое подключение

Быстрое подключение проекта к боту осуществляется по ссылке или QR-коду, отображаемым в проекте AgavaCloud, в разделе Настройки -> Уведомления.

Кроме ссылки в окне настроек инструмента уведомления отображатеся уникальный идентификатор (токен) проекта, который также может быть использован для подключения проекта к боту.

Текстовые команды

Команда /add

В текущей версии поддерживается текстовая команда:

/add <токен проекта>

Токен имеет длину 18 символов: префикс NM и ещё 16 букв или цифр. Используйте выданный токен целиком, без кавычек и дополнительных слов. Регистр команды и токена не важен.

Команда добавляет существующий проект в ваш список и включает его уведомления. Она не создаёт проект в AgavaCloud. Для подключения нескольких проектов отправьте отдельную команду /add для каждого токена.

Повторная команда с тем же токеном:

при активной подписке возвращает «Проект уже подключен.»;
при отключённых уведомлениях снова включает их и возвращает «Проект успешно подключен.».

Команды меню

Где находится	Кнопка	Что делает
Начальное меню	Старт	Показывает сообщение «Бот запущен.» и главное меню. Не подключает проекты и не включает отключённые подписки.
Главное меню	Проекты	Открывает список ваших подключённых проектов, включая проекты с отключёнными уведомлениями. Кнопка появляется после подключения хотя бы одного проекта.
	Помощь	Показывает краткую справку о боте и формате команды /add.
	Отключить уведомления	Отключает уведомления всех ваших активных проектов. Кнопка отображается, пока хотя бы одна подписка активна.
Список проектов	Название проекта	Открывает меню выбранного проекта. Само открытие не меняет подписку.
Меню проекта	Отключить уведомления	Отключает уведомления только выбранного проекта. Эта кнопка означает, что сейчас его уведомления включены.
	Включить уведомления	Включает уведомления только выбранного проекта. Эта кнопка означает, что сейчас его уведомления отключены.
	Назад	Возвращает к списку проектов.
Список проектов	Назад	Возвращает в главное меню.

Кнопка «Старт» появляется в начальном меню при запуске без токена. После нажатия она не выводится в обычном главном меню. Список проектов содержит названия; если имя проекта не задано, вместо него может отображаться идентификатор проекта.

Работа с проектами и подписками

Просмотр проектов

Нажмите в меню кнопку «Проекты». Здесь отображаются только проекты, которые подключены к вашей учётной записи MAX, а не все проекты AgavaCloud. Отключённый проект остаётся в списке.

Чтобы проверить состояние подписки, откройте проект и посмотрите на кнопку: «Отключить уведомления» — сейчас включены; «Включить уведомления» — сейчас отключены.

Отключение одного проекта

Нажмите «Проекты».
Выберите название проекта.
Нажмите «Отключить уведомления».
Бот подтвердит «Уведомления отключены.» и предложит кнопку «Включить уведомления».

Уведомления остальных ваших проектов продолжат поступать.

Отключение всех проектов

В главном меню нажмите «Отключить уведомления». Бот ответит «Уведомления отключены для всех активных проектов.» Проекты сохранятся в списке, но общая кнопка отключения исчезнет, поскольку активных подписок больше нет.

Не путайте эту кнопку с одноимённой кнопкой внутри отдельного проекта: в главном меню действие относится ко всем вашим проектам.

Включение уведомлений от проекта обратно

Откройте «Проекты», выберите нужный проект и нажмите «Включить уведомления». Бот ответит «Уведомления включены.» и заменит кнопку на «Отключить уведомления».

Общей кнопки «Включить всё» нет: включайте нужные проекты по отдельности. Также можно повторно отправить /add с токеном нужного проекта. Кнопка «Старт» не восстанавливает отключённые подписки.

Что меняет отключение уведомлений

Изменяется только ваша подписка в MAX. Проект не удаляется, работа оборудования не останавливается, настройки других получателей и уведомления не меняются.

Какие сообщения присылает бот

Пример уведомления:

Котельная: АКТИВАЦИЯ
06/10/2026 16:30:00
Превышена температура теплоносителя

В сообщении указаны название проекта, тип события, время и текст события. Для тревог используются состояния «АКТИВАЦИЯ» и «Деактивация», для других событий — «Событие». Время учитывает часовой пояс, заданный для проекта.

Если для проекта включены повторы активных тревог, бот может присылать напоминания, пока тревога остаётся активной. Напоминание также отображается как «АКТИВАЦИЯ», но с временем отправки напоминания: это не обязательно новая тревога. Интервал и подавление повторных активаций задаются на стороне проекта, а не через меню бота.

Просмотр истории событий через меню не предусмотрен. Включение подписки не является запросом на выгрузку сообщений, пропущенных за время отключения. При сбоях доставки сообщения могут поступать с задержкой, поэтому обращайте внимание на время в уведомлении.

Помощь и возврат к меню

В главном меню нажмите «Помощь». Из меню отдельного проекта сначала нажмите «Назад» до списка, затем ещё раз «Назад» до главного меню.

Если кнопки меню потерялись в переписке, отправьте боту обычное сообщение, например «меню». В текущей версии это не отдельная команда: бот ответит «Ваша команда не распознана.», но вместе с ответом покажет главное меню с доступными действиями.

Ошибки и частые вопросы

Что произошло	Что делать
«Неверный токен. Используйте /add NMXXXXXXXXXXXXXXXX.»	Проверьте префикс NM, общую длину 18 символов и отсутствие лишних слов. Отправляйте один токен в одном сообщении.
«Токен проекта не найден.»	Формат принят, но сервис не знает такой токен. Проверьте, что открыли нужного бота, и запросите актуальный токен у администратора.
«Проект уже подключен.»	Подписка на этот проект уже активна. Откройте «Проекты», чтобы управлять ею.
«Ваша команда не распознана.»	Используйте /add для подключения и кнопки для остальных действий. Такой ответ возможен и при нажатии старой кнопки проекта, привязка которого уже удалена.
Нет кнопки «Проекты»	К этой учётной записи пока не подключён ни один проект. Выполните /add.
Нет общей кнопки «Отключить уведомления»	У вас нет активных подписок. Проверьте состояния проектов и включите нужные.
Нет сообщений по проекту	Проверьте подписку в меню проекта. Если она включена, уточните у администратора наличие событий и работоспособность сервиса.
Ранее подключённый проект исчез	Убедитесь, что используете тот же аккаунт MAX. Администратор мог удалить регистрацию проекта или сменить токен; при смене токена нужно подключиться заново.
Бот не отвечает ни на команды, ни на кнопки	Обратитесь к администратору: через меню нельзя проверить или перезапустить сервис.

Что нельзя сделать через меню

Создать, удалить или переименовать проект AgavaCloud.
Удалить проект из своего списка: отключение уведомлений сохраняет привязку.

Эти действия не реализованы в меню. При необходимости обращайтесь к администратору проекта или сервиса.

Безопасность токена

Токен проекта позволяет подключиться к его уведомлениям. Не публикуйте его в общих чатах, скриншотах и открытых инструкциях; отправляйте /add лично боту.

В текущей реализации бот не удаляет входящую команду /add автоматически: токен остаётся в переписке. Если токен раскрыт посторонним, сообщите администратору и запросите его замену. После замены всем получателям потребуется подключить проект заново.

Обновлено: 07.10.2026 05:16