ZEROALERT

Настройка MAX

Пошагово: создать бота в мессенджере MAX, узнать идентификатор чата, подключить к ZEROALERT и проверить уведомления.

Что понадобится

  • Профиль организации, ИП или самозанятого, прошедший верификацию на платформе MAX для партнёров (business.max.ru). Сервис доступен резидентам РФ.
  • Программа ZEROALERT и аккаунт в MAX.
  • Около 15 минут плюс время модерации бота.
Тариф. Канал MAX входит в тариф «Бизнес» (как ВКонтакте, SMS и звонок). В бесплатном тарифе уведомления идут в Telegram: инструкция по Telegram.

1. Создание бота

  1. Войдите на business.max.ru (платформа MAX для партнёров) и откройте раздел «Чат-боты».
  2. Нажмите создание бота, укажите название (например, ZEROALERT Мониторинг) и описание.
  3. Дождитесь модерации: статус виден рядом с названием бота. После неё бот доступен пользователям.
  4. В карточке бота получите токен — длинную строку вроде f9LHodD0cOKexampleTokenForDocsOnly-abcdefghij. Скопируйте её целиком.
Если в вашем кабинете бота создают иным способом (например, через служебного бота в самом MAX), действуйте по подсказкам MAX: нужен именно токен бота. Актуальные правила смотрите в документации MAX.
Токен — как пароль. Кто его знает, пишет от имени вашего бота. Никому его не отправляйте и не публикуйте.

2. Разрешите группы

Если тревоги должны приходить в групповой чат, разрешите боту добавляться в группы:

  1. В разделе «Чат-боты» откройте меню бота (⋮) → Настройки → Приватность.
  2. Разрешите добавление в групповые чаты. Это можно изменить только после модерации.

Для личных сообщений себе ничего менять не нужно.

3. Добавьте бота в чат

Личные сообщения (проще всего)

  1. Найдите своего бота в MAX и откройте диалог.
  2. Нажмите «Начать» (или отправьте любое сообщение). Пока вы не написали боту, он не может написать первым.

Группа дежурных

  1. Откройте группу и нажмите на её название → Участники → Добавить участников, выберите бота.
  2. Назначьте бота администратором с правами: read_all_messages («чтение сообщений») и write («отправка сообщений»).

Бота нельзя «добавить» в личный диалог: пользователь сам начинает его. В группе без прав администратора бот не получает события и не сможет работать.

4. Узнайте user_id или chat_id

Программе нужен user_id (для личного чата) или chat_id (для группы). Проще всего узнать его запросом к API MAX.

  1. Сначала напишите боту (нажмите «Начать») или любое сообщение в группе, где бот администратор.
  2. Сразу после этого откройте PowerShell и выполните (подставьте свой токен):
    curl.exe -s -H "Authorization: ВАШ_ТОКЕН" "https://platform-api2.max.ru/updates?types=bot_started,message_created&timeout=0"
  3. В ответе найдите числа 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 (если шлёте в группу)
Серверы@Офис МоскваПусто — все; имена или @группа
Отправлять при важностивнимание и вышеили «только критично»
Слать, если тревогу не взяли за, мин00 — сразу; 10–15 — как «второй рубеж»
Личный чат: заполняем токен и user_id. Данные тестовые.
Личный чат: заполняем токен и user_id. Данные тестовые.
Группа: chat_id с минусом и ограничение по группе серверов.
Группа: chat_id с минусом и ограничение по группе серверов.

Нажмите «Сохранить». Заполните либо user_id, либо chat_id. Поле «Токен» после сохранения остаётся пустым: токен хранится зашифрованно, пусто — «не менять». На снимках токен раскрыт только для примера.

6. Проверка

Нажмите «✉ Отправить тест в MAX» (внизу вкладки «MAX»). В чат придёт сообщение, а программа покажет «MAX: сообщение отправлено» или причину ошибки.

Так выглядит тестовое сообщение (макет).

7. Как выглядят уведомления

В MAX тревоги приходят обычным текстом: несколько событий подряд объединяются в одно сообщение. Кнопки «Беру в работу» и команды управления работают в Telegram, поэтому MAX удобно использовать как второй канал.

Тревоги и сообщение о восстановлении в 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 для партнёров и введите новый в программе.

← Все документы · Настройка Telegram