Настройка модуля «Уведомления в MAX»

Модуль «Уведомления в MAX» отвечает за сервисные уведомления. Его используют для кодов подтверждения, оповещений пользователей или сообщений администраторам о важных событиях площадки.

Когда стоит подключать модуль

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

Что изменится на сайте

• ADWOS CMS отправляет сервисные уведомления через «Уведомления в MAX».
• Можно проверить доставку кода, сообщения или админского оповещения на тестовом получателе.
• Владелец контролирует отправителя, токены, лимиты и стоимость сообщений.
• Пользователи получают важные уведомления в привычном канале.

Что подготовить заранее

Подготовьте доступы и тестовые данные до включения модуля. Так вы проверите сценарий спокойно и не затронете реальные заказы, пользователей или публичные страницы.

• Создайте кабинет, бота, отправителя или канал у провайдера «Уведомления в MAX».
• Подготовьте токен, идентификатор отправителя, chat_id, номер или другой реквизит, который требует модуль.
• Проверьте баланс, лимиты, правила шаблонов и разрешения на отправку сервисных сообщений.
• Выберите тестового получателя и не запускайте массовую отправку до успешной проверки.

Установка в ADWOS CMS

• Откройте административную панель ADWOS CMS под учетной записью администратора.
• В меню выберите раздел «Каталог», затем откройте «Маркетплейс».
• Найдите модуль «Уведомления в MAX» по названию или через список модулей.
• Если модуль еще не установлен, нажмите «Установить» и дождитесь завершения установки.
• Откройте карточку установленного модуля, выберите «Управлять», затем перейдите в «Настройки».
• Заполните обязательные поля, сохраните настройки и включите модуль переключателем.

Настройка модуля

В настройках модуля заполняйте только те значения, которые относятся к вашему проекту. Секретные ключи храните в защищенных полях и не переносите их в открытые тексты, письма или инструкции для пользователей.

• «Bot Token (от dev.max.ru)». Обязательное секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. Токен бота, выданный платформой MAX (Чат-боты , затем Интеграция , затем Получить токен).
• «Username бота (например: MySuperBot)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Поле обязательное. Юзернейм бота без символа @. Используется для генерации ссылки на бота max.ru/
• «Бронирование отменено». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять об отмене бронирования (требует модуль booking)
• «Бронирование подтверждено». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять о подтверждении бронирования (требует модуль booking)
• «Новая заявка на бронирование». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять о новых заявках на бронирование (требует модуль booking)
• «Напоминание о бронировании». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Напоминание о бронировании за 24 часа до заезда (требует модуль booking)
• «Сделка создана». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять о создании безопасной сделки (требует модуль safe-deal)
• «Спор по сделке». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять об открытии спора по сделке (требует модуль safe-deal)
• «Добавление в избранное». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: false. Уведомлять когда пользователь добавил ваше объявление в избранное
• «Объявление одобрено». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять пользователя о прохождении модерации объявления
• «Объявление скоро истечёт». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять когда объявление скоро истечёт (за 3 дня до снятия с публикации)
• «Объявление отклонено». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять пользователя об отклонении объявления модератором
• «Объявление продано». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять когда покупатель отметил объявление как купленное
• «Новые объявления по подписке». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять о новых объявлениях по вашим поисковым подпискам
• «Новое сообщение». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять о новых личных сообщениях в чате
• «Новый отзыв». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять о новых отзывах о вас или ваших объявлениях
• «Заказ отменён». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять об отмене заказа покупателем или продавцом
• «Заказ завершён». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять о завершении заказа (получение покупателем)
• «Заказ создан». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять о новых заказах через корзину (для продавца) и подтверждениях (для покупателя)
• «Заказ оплачен». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять об оплате заказа
• «Заказ отправлен». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять об отправке заказа и присвоении трек-номера
• «Снижение цены». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять о снижении цены в объявлениях из вашего избранного / подписок
• «Промо-акции и скидки». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: false. Уведомлять о промо-акциях, скидках и спецпредложениях платформы. Рекомендуется держать отключённым по умолчанию
• «Ответ на отзыв». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять когда продавец/покупатель ответил на ваш отзыв
• «Ответ техподдержки». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять об ответах техподдержки на ваш тикет
• «Секрет для Webhook (любая случайная строка)». Обязательное секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. Произвольная строка для защиты Webhook от стороннего доступа. Используется при /start привязке аккаунта.

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

Проверка перед запуском

• Отправьте тестовое уведомление на свой номер, аккаунт или канал.
• Проверьте статус доставки в ADWOS CMS и в кабинете провайдера.
• Убедитесь, что текст сообщения не содержит тестовых данных и понятен пользователю.
• Проверьте ошибку при неверном получателе или пустом токене.

Частые ошибки

• Сообщение не доставлено. Проверьте токен, баланс, лимиты и формат получателя.
• Провайдер блокирует отправку. Проверьте регистрацию отправителя и правила шаблонов.
• Администратор не получает уведомление. Проверьте chat_id, username, номер или привязку аккаунта.
• Коды приходят с задержкой. Проверьте очередь, лимиты провайдера и повторные попытки.

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