Настройка MAX
Пошагово: создать бота в мессенджере MAX, узнать идентификатор чата, подключить к ZEROALERT и проверить уведомления.
Что понадобится
- Профиль организации, ИП или самозанятого, прошедший верификацию на платформе MAX для партнёров (business.max.ru). Сервис доступен резидентам РФ.
- Программа ZEROALERT и аккаунт в MAX.
- Около 15 минут плюс время модерации бота.
1. Создание бота
- Войдите на business.max.ru (платформа MAX для партнёров) и откройте раздел «Чат-боты».
- Нажмите создание бота, укажите название (например,
ZEROALERT Мониторинг) и описание. - Дождитесь модерации: статус виден рядом с названием бота. После неё бот доступен пользователям.
- В карточке бота получите токен — длинную строку вроде
f9LHodD0cOKexampleTokenForDocsOnly-abcdefghij. Скопируйте её целиком.
2. Разрешите группы
Если тревоги должны приходить в групповой чат, разрешите боту добавляться в группы:
- В разделе «Чат-боты» откройте меню бота (⋮) → Настройки → Приватность.
- Разрешите добавление в групповые чаты. Это можно изменить только после модерации.
Для личных сообщений себе ничего менять не нужно.
3. Добавьте бота в чат
Личные сообщения (проще всего)
- Найдите своего бота в MAX и откройте диалог.
- Нажмите «Начать» (или отправьте любое сообщение). Пока вы не написали боту, он не может написать первым.
Группа дежурных
- Откройте группу и нажмите на её название → Участники → Добавить участников, выберите бота.
- Назначьте бота администратором с правами:
read_all_messages(«чтение сообщений») иwrite(«отправка сообщений»).
Бота нельзя «добавить» в личный диалог: пользователь сам начинает его. В группе без прав администратора бот не получает события и не сможет работать.
4. Узнайте user_id или chat_id
Программе нужен user_id (для личного чата) или chat_id (для группы). Проще всего узнать его запросом к API MAX.
- Сначала напишите боту (нажмите «Начать») или любое сообщение в группе, где бот администратор.
- Сразу после этого откройте PowerShell и выполните (подставьте свой токен):
curl.exe -s -H "Authorization: ВАШ_ТОКЕН" "https://platform-api2.max.ru/updates?types=bot_started,message_created&timeout=0"
- В ответе найдите числа
user_id(личный чат) илиchat_id(у группы он отрицательный):{ "updates": [ { "update_type": "bot_started", "chat_id": 98765432, "user_id": 98765432 } ], "marker": 12347 }
platform-api2.max.ru — тот, который использует программа.5. Ввод в программе
В ZEROALERT откройте Настройки → MAX, поставьте галочку «Отправлять тревоги в MAX» и заполните поля. Примерные значения:
| Поле | Пример | Откуда взять |
|---|---|---|
| Токен бота | f9LHodD0cOKexampleTokenForDocsOnly-abcdefghij | Шаг 1 |
| user_id личного чата | 98765432 | Шаг 4 (если пишете себе в личку) |
| chat_id группы | -70012345678 | Шаг 4 (если шлёте в группу) |
| Серверы | @Офис Москва | Пусто — все; имена или @группа |
| Отправлять при важности | внимание и выше | или «только критично» |
| Слать, если тревогу не взяли за, мин | 0 | 0 — сразу; 10–15 — как «второй рубеж» |


Нажмите «Сохранить». Заполните либо user_id, либо chat_id. Поле «Токен» после сохранения остаётся пустым: токен хранится зашифрованно, пусто — «не менять». На снимках токен раскрыт только для примера.
6. Проверка
Нажмите «✉ Отправить тест в MAX» (внизу вкладки «MAX»). В чат придёт сообщение, а программа покажет «MAX: сообщение отправлено» или причину ошибки.
7. Как выглядят уведомления
В MAX тревоги приходят обычным текстом: несколько событий подряд объединяются в одно сообщение. Кнопки «Беру в работу» и команды управления работают в Telegram, поэтому MAX удобно использовать как второй канал.
Чтобы MAX срабатывал, только если тревогу никто не взял в Telegram, поставьте в поле «Слать, если тревогу не взяли за, мин» значение 10–15.
8. Если не работает
| Симптом | Причина | Что делать |
|---|---|---|
| 401 / invalid token | Токен неверный или бот отключён. | Скопируйте токен из кабинета заново, без пробелов; проверьте, что бот прошёл модерацию. |
| Нет сообщений в личке | Вы не нажали «Начать» у бота. | Откройте диалог с ботом, нажмите «Начать» и повторите тест. |
| Нет сообщений в группе | Бот не администратор или нет прав на запись. | Назначьте бота администратором с правами read_all_messages и write; проверьте chat_id (с минусом). |
| Ошибка SSL / сертификат | Windows не доверяет сертификату сервера MAX (корневой сертификат Минцифры). | Установите корневой сертификат Минцифры в «Доверенные корневые центры сертификации» (по данным MAX, нужен для platform-api2.max.ru). |
| Бот не находится в поиске | Бот ещё на модерации. | Дождитесь окончания модерации, статус виден в кабинете. |
| «MAX: укажите chat_id или user_id» | Не заполнено ни одно поле получателя. | Заполните одно из полей, не оба. |
Не помогло? Напишите нам со страницы «Поддержка» и приложите текст ошибки из окна теста (без токена).
9. Безопасность
- Токен хранится в настройках программы в зашифрованном виде (шифрование Windows) и на экране скрыт.
- Не отправляйте токен и скриншоты, где он виден.
- При подозрении на утечку перевыпустите токен в кабинете MAX для партнёров и введите новый в программе.