Инструкция к модулю Push уведомления

Модуль отправляет браузерные push-уведомления и SMS администраторам и покупателям CS-Cart. Он подходит для автоматических оповещений по заказам, товарам и пользователям, для ручных сообщений из админки и для отложенной отправки через cron.

Что делает модуль

• отправляет push-уведомления в браузер через Firebase;
• отправляет SMS через несколько сервисов;
• реагирует на события магазина, связанные с пользователями, товарами и заказами;
• поддерживает отдельные правила для администратора и покупателя;
• позволяет отправлять сообщения вручную и по расписанию;
• сохраняет историю отправки в журнале уведомлений.

Модуль полезен, если нужно быстро сообщать о новых заказах, изменении статусов, регистрации пользователей и проблемах со складскими остатками.

Где находится модуль

Настройка выполняется в карточке модуля в админке CS-Cart. Внутри есть отдельные разделы для общих параметров, push-уведомлений, SMS, обратной связи и справки.

• Общие — выбор SMS-сервиса, ключи сервисов, параметры Firebase, пароль для cron и иконка уведомлений.
• Push Уведомления Администратора — токены и телефоны админов, а также условия отправки.
• Push Уведомления Покупателя — условия отправки push покупателю и ручная отправка push.
• SMS Уведомления Администратора — телефоны админов и условия SMS-оповещений.
• SMS Уведомления Покупателя — выбор телефона покупателя и условия SMS-отправки.
• Обратная связь и Помощь — служебные блоки модуля.

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

Общие настройки

Сначала выберите канал, через который будете отправлять SMS. После выбора заполните только поля этого сервиса.

• SMS Сервис — SMS.ru, TurboSMS, TargetSMS, OsonSMS, SMS Xabar, Imobis, МТС или SMS Центр Казахстан.
• SMS.ru — API-ключ.
• TurboSMS — логин, пароль и отправитель.
• TargetSMS — логин, пароль и отправитель.
• OsonSMS — логин, hash и отправитель.
• SMS Xabar — логин, пароль и originator.
• Imobis — token и sender.
• МТС — token и sender.
• SMS Центр Казахстан — логин, пароль и sender.
• Firebase — Server Key, Web API Key, Project ID и Sender ID для браузерных push.
• Пароль для Cron — защита команды отложенной отправки.
• Иконка для уведомлений — ссылка на изображение, которое показывается в push.

Для push-уведомлений ключи Firebase должны быть заполнены, иначе браузерные уведомления не будут отправляться.

Настройка push-уведомлений администратора

В этом разделе задаются получатели и условия, при которых уведомление уходит администраторам.

• Токены админов через запятую — Firebase-токены устройств, на которых должны приходить push.
• Телефоны админов через запятую — номера для SMS.
• Зарегистрирован новый пользователь — отправка при регистрации клиента.
• Закончился товар на складе — уведомление при нулевом или отрицательном остатке.
• Размещен новый заказ — уведомление о новом заказе.
• Заказ был обновлен — уведомление при изменении заказа.
• Отправлять только если сумма заказа превышает — порог суммы заказа.
• Отправлять только если выбран один из следующих способов доставки — ограничение по доставке.
• Отправлять только если статус заказа один из следующих — ограничение по статусу.

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

Настройка push-уведомлений покупателя

Этот раздел управляет push-сообщениями, которые получает сам покупатель.

• Заказ был обновлен — отправка push при изменении заказа.
• Отправлять только если выбран один из следующих способов доставки — фильтр по способу доставки.
• Отправлять только если статус заказа один из следующих — фильтр по статусу.
• Отправлять только если сумма заказа превышает — минимальная сумма для отправки.
• Отправлять вручную Push — разрешает ручную отправку push-уведомлений покупателям из раздела сообщений.

Для доставки push покупателю нужен сохранённый token устройства. Он может появляться при работе пользователя с профилем или при обновлении данных клиента.

Настройка SMS-уведомлений администратора

Раздел работает по тем же правилам, что и push-уведомления администратора, но использует SMS вместо браузерных уведомлений.

• Телефоны админов через запятую — список получателей SMS.
• Зарегистрирован новый пользователь — SMS при регистрации.
• Закончился товар на складе — SMS при нулевом остатке.
• Размещен новый заказ — SMS о новом заказе.
• Заказ был обновлен — SMS при изменении заказа.
• Отправлять только если сумма заказа превышает — порог суммы.
• Отправлять только если выбран один из следующих способов доставки — ограничение по доставке.
• Отправлять только если статус заказа один из следующих — ограничение по статусу.

Настройка SMS-уведомлений покупателя

Здесь выбирается телефон покупателя и условия, при которых ему отправляется SMS.

• Поле телефона покупателя — billing или shipping.
• Заказ был обновлен — SMS при изменении заказа.
• Отправлять только если выбран один из следующих способов доставки — фильтр по доставке.
• Отправлять только если статус заказа один из следующих — фильтр по статусу.
• Отправлять только если сумма заказа превышает — минимальная сумма для отправки.
• Отправлять вручную SMS — разрешает ручную SMS-отправку покупателям.

Шаблоны сообщений

Для статусов заказа можно задать текст сообщения, который будет подставляться при событии изменения статуса. В шаблоне доступны подстановки:

• %ORDER_ID% — номер заказа;
• %AMOUNT% — сумма заказа;
• %NAME% — имя покупателя;
• %LAST_NAME% — фамилия покупателя;
• %USER_EMAIL% — e-mail покупателя;
• %COUNTRY% — страна доставки;
• %ADDRESS% — адрес доставки;
• %CITY% — город доставки;
• %STATE% — область или регион доставки;
• %TRACKING% — номер отслеживания, если он уже есть у заказа.

Для ручной отправки вы указываете собственный текст сообщения в форме отправки.

Ручная и отложенная отправка

В админке есть отдельный раздел отправки сообщений. В нём можно выбрать получателей по нескольким признакам:

• группы пользователей;
• отдельных пользователей;
• номера телефонов;
• покупателей по периоду заказов.

Сообщение можно отправить сразу или отложить. Для отложенной отправки укажите дату и время, а затем добавьте cron-команду из подсказки в планировщик сервера. Пароль cron берётся из настроек модуля.

Журнал уведомлений показывает текст сообщения, событие, дату и время отправки, ID заказа и результат доставки.

Как проверить работу

1. Заполните ключи выбранного SMS-сервиса и параметры Firebase.
2. Добавьте токены или телефоны администраторов.
3. Включите хотя бы одно событие для push или SMS.
4. Для теста создайте нового пользователя, оформите заказ или измените его статус.
5. Проверьте, что сообщение пришло на устройство или телефон и появилось в журнале.
6. Проверьте ручную отправку из раздела сообщений.
7. Если используете отложенную отправку, запустите cron и убедитесь, что сообщение попало в обработку.

Если push не приходит, сначала проверьте разрешение на уведомления в браузере и наличие token у пользователя.