Создание События уведомлений
В этой статье:
Создание События уведомлений
Перед созданием События уведомлений необходимо:
- Создать SMS-шлюз для СМС-уведомлений (см. Управление SMS-шлюзами).
- Создать Шаблон уведомлений, на базе которого будет формироваться текст Уведомления для этого События уведомления (см. Управление Шаблонами уведомлений).
Созданное Событие уведомлений автоматически создается у всех нижестоящих Реселлеров (подробнее см. Делегирование Шаблонов интерфейса, Шаблонов уведомлений, Событий уведомлений и Категорий уведомлений).
Чтобы создать Событие уведомлений, необходимо:
- Войти в Панель управления Оператора.
- На Панели навигации перейти в раздел События уведомлений (см. Навигация по Панели управления Оператора). Отобразится страница События уведомлений (см. Просмотр списка Событий уведомлений).
На Панели инструментов страницы События уведомлений нажать кнопку Создать. Отобразится страница Добавить обработчик.
Так как Событие уведомлений делегируется всем нижестоящим Реселлерам, то оно должно быть уникальным. Набор параметров Событие, Тип Шаблона уведомлений, Шаблон уведомлений и Правило не должен совпадать с соответствующим набором параметров существующих Событий уведомлений у текущего Реселлера (Оператора) и всех его нижестоящих Реселлеров.В списке Событие выбрать событие, при наступлении которого должно срабатывать Событие уведомлений. Список событий см. в таблице.
- В списке Тип шаблона уведомлений выбрать один из способов отправки уведомлений: Email, СМС или Панель управления Клиента.
- В списке Шаблон уведомлений выбрать ранее созданный Шаблон уведомлений (см. Управление Шаблонами уведомлений).
- Чтобы настроить рассылку уведомлений в определенное время, необходимо:
- Сбросить флажок Добавить в очередь на отправку сразу, поле Добавить в очередь на отправку в определенное время (час суток) станет доступным.
- В поле Добавить в очередь на отправку в определенное время (час суток) ввести час суток, в который задачи на отправку уведомлений по этому событию должны быть поставлены в Очередь на отправку.
В поле Правило ввести запрос и условия обработки события, используя Плейсхолдеры (см. Плейсхолдеры для описания Правила обработки события).
При описании Правила обработки события возможны следующие операции с Плейсхолдерами:
>
<
>=
<=
=
!=
include? (например,
order.type = "SalesOrder" and (order.plans_ids include? 2000030)
) — обработчик события сработает, если в заказ на покупку включен тарифный план с id =2000030)- exclude? (исключить определенные сущности (по id, ключу, имени) из выбранного массива сущностей, например, для исключения отправки уведомления о создании заказа на подписку по тарифному плану с id = 2000, необходимо использовать следующее правило:
order.plans_ids exclude? 2000
) and (например, для исключения нескольких сущностей из массива необходимо использовать
(product_ids exclude? 34650) and (product_ids exclude? 34702))
- or. Для нескольких
or
послеand
следует использовать дополнительные скобки:order.type = "RenewalOrder" and order.renewal_is_positive = true and subscription.payment_model = "prepay" and ((order.plans_ids include? 293827) or (order.plans_ids include? 293824) or (order.plans_ids include? 294340))
- % (например, 30% от Порога срабатывания финансовой блокировки:
account.financial_blocking_threshold % 30
)
При создании Шаблонов уведомлений доступна возможность использовать открытый язык шаблонов Liquid, который позволяет создавать сложные Уведомления. Подробнее https://shopify.github.io/liquid/basics/introduction/.
subscription.days_left = 10 AND subscription.status = "active" Этот запрос означает, что обработчик будет работать для всех активных подписок, которые истекают через 10 дней.
Нажать кнопку Создать. Новое Событие будет создано и отображено в Списке событий уведомлений (см. Просмотр списка Событий уведомлений) у текущего Реселлера и его нижестоящих Реселлеров.
Список событий
Событие | Описание |
---|---|
Приближается финансовая блокировка клиента | Происходит если Баланс Клиента становится равным либо меньше заданной доли (от 1% до 99% включительно) от Порога срабатывания финансовой блокировки, но не меньше Порога срабатывания финансовой блокировки. Для корректной работы требует обязательной настройки Правила обработки События. |
Клиент изменен | Происходит при блокировке Клиента (финансовой или административной, см. Переход Клиента в финансовую блокировку и Перевод Клиента в административную блокировку) и при активации Клиента после блокировки (см. Выход Клиента из финансовой блокировки и Активация Клиента после административной блокировки). |
Клиент создан | Происходит при создании нового Клиента (см. Создание Клиента). |
Порог срабатывания финансовой блокировки изменен | Происходит при изменении значения Порога срабатывания финансовой блокировки в Правиле обслуживания (см. Создание Правила обслуживания) или при изменении индивидуального значения для Клиента (см. Просмотр и обновление информации о Клиенте). Событие происходит также и при создании нового Клиента. Если Клиенту назначается другое Правило обслуживания, а Порог срабатывания финансовой блокировки не изменяется, то Событие не происходит. |
Менеджер клиента изменен | Происходит при изменении или назначении менеджера Клиента (см. Просмотр и обновление информации о Клиенте). |
Закрытие Акта | Происходит в Финансовый день при выставлении Акта за потребленную Услугу (подробнее см. Управление Актами). |
Счет был подтвержден | Событие наступает при вызове сторонней ERP-системой API-метода (см. Approve postpaid invoice) для Акта по модели Постоплата с внешним управлением (см. Управление Актами по модели Постоплата сторонней ERP-системой). Чтобы определить, был ли прикреплен к связанному Платежу Счет на оплату, в Правиле обработки события используется Плейсхолдер invoice.has_attached. |
Недостаточно средств на балансе | Происходит если Баланс аккаунта меньше либо равен нулю. |
Сотрудник создан | Происходит при создании Сотрудника через Панель управления Оператора (см. Добавление Сотрудника) или по API (см. Create manager). Используется для отправки Сотруднику учетных данных для входа (см. Плейсхолдеры в Шаблонах уведомлений для отдельных Событий уведомлений). Не требует настройки Правила обработки События. |
Ручная операция | Происходит при:
|
Платеж получен | Происходит при смене статуса Платежа:
|
Срок оплаты платежа приближается | Происходит только для Подписок по модели Постоплата. В зависимости от условий в Правиле происходит либо за заданное в Правиле количество дней до истечения Периода отсрочки Платежа (см. Плейсхолдеры для описания Правила обработки события), либо при переходе Платежа в статус Просрочен и блокировке связанных Подписок (см. Просмотр Акта для модели Постоплата). При отсутствии условий в поле Правило Событие произойдет в дату истечения Периода отсрочки Платежа. Email-уведомление включает счет в формате PDF. PDF-счет формируется для Платежа, связанного с Актом по модели Постоплата. PDF-счет формируется только для Клиентов, у которых задан Способ оплаты по умолчанию на основе модуля CheckCash (см. Просмотр и обновление Типа клиентов). |
Платеж по постоплате создан | Происходит на следующий день после Финансового дня, когда платформа закрывает Акт по модели Постоплата и создает связанный Платеж. Email-уведомление включает PDF-счет для Платежа. PDF-счет формируется только для Клиентов, у которых задан Способ оплаты по умолчанию на основе модуля CheckCash (см. Просмотр и обновление Типа клиентов). |
Запрос сброса пароля | Происходит при запросе письма с инструкциями по сбросу пароля к Панели управления Клиента (подробнее см. Reset password) |
Запрос сброса пароля менеджера | Происходит при запросе письма с инструкциями по сбросу пароля к Панели управления Оператора (подробнее см. Сброс пароля к учетной записи Сотрудника). |
До окончания периода подписки | Происходит ежедневно для всех Подписок, у которых нет связи с Заказом на продление в статусе Ожидает предоставления или Предоставляется. Для корректной работы требует обязательной настройки Правила обработки События. |
После окончания периода подписки | Происходит ежедневно для всех Подписок. Для корректной работы требует обязательной настройки Правила обработки События. |
Подписка переведена из пробного статуса в платный | Происходит при переходе Подписки из пробного в тарифицируемый период. |
Подписка изменена | Происходит при:
|
Подтверждение email | Происходит при регистрации нового пользователя в Панели управления Клиента, после нажатия кнопки Зарегистрироваться (подробнее см. Quick registration). |
Приглашение пользователя | Происходит при приглашении внешнего пользователя Владельцем или Администратором Аккаунта (подробнее см. Приглашение Внешнего пользователя). |
Заказ изменён | Происходит при смене статуса Заказа на:
Счет к Уведомлению не прикрепляется. |
Заказ создан | Происходит при создании нового Заказа (Создание Заказа). В том числе, срабатывает как при ручном, так и при автоматическом создании Заказа на продление. Чтобы исключить отправку Клиентам счетов на оплату по Заказам на пролонгацию, создаваемым в Финансовый день для автоматической оплаты с Баланса клиента (см. Пролонгация Подписки), необходимо чтобы для Подписок, у которых установлена Точка автоматического продления (в днях) = 0, События Заказ создан и Заказ изменён не срабатывали. Для этого в Правиле обработки этих Событий необходимо задать условие |
Обещанный платеж создан | Происходит при:
|
Обещанный платёж изменён | Происходит при автоматическом или ручном отзыве Обещанного платежа. Подробнее см. Отзыв Обещанного платежа. |
Обещанный платёж истекает | Происходит за указанное количество дней до наступления даты истечения Обещанного платежа. |
Осталось дней до оплаты | Происходит ежедневно для всех Подписок. Для корректной работы требует обязательной настройки Правила обработки События. |
Телефонная верификация | Происходит при нажатии кнопки Получить код на шаге SMS верификация при проведении полной регистрации Аккаунта (см. Full registration). |
Финансовый день наступает | Происходит ежедневно для каждого уникального Финансового дня. Пользователю Клиента с ролью Владелец отправляется email сообщение о дате Финансового дня и о сумме предстоящего списания средств с Баланса Клиента. В случае, если у Клиента есть Подписки с типом биллинга Pay as you go, в письме будет указано, что сумма, на которую нужно пополнить Баланс, может измениться. В сообщении также будет размещена ссылка на страницу пополнения Баланса Клиента (см. Пополнение Баланса Клиента). Пользователи, авторизованные в Панели управления Оператора с ролью Системный администратор и Менеджер по продажам (см. Роли Сотрудников), также могут перейти по этой ссылке в Панель управления Клиента в рамках одного Реселлера, если у них в браузере нет сессии с авторизацией в Панели управления Клиента. Учитываются только Подписки в следующих статусах (см. Просмотр списка Подписок):
Для корректной работы требует обязательной настройки Правила обработки События. Чтобы сформировать таблицу с перечнем Подписок, которые истекают в ближайший Финансовый период, можно использовать следующие Плейсхолдеры:
|
Финансовый день наступил | Событие вызывается после прохождения биллинг-процесса и закрытия Списаний для каждого Менеджера Реселлера, при выполнении следующего условия:
В поле Получатель на странице создания и редактирования Шаблона уведомлений необходимо указать Плейсхолдер {{manager.email}} — email Менеджера, для которого вызвано Событие уведомлений. |
Себестоимость изменена | Происходит при изменении себестоимости Тарифного плана на уровне текущего Реселлера (см. Просмотр Прайс-листа). При создании этого События уведомления следует оставить поле Правило пустым. Платформа собирает данные об изменении себестоимости раз в сутки ночью. При этом в выборку Тарифных планов включаются только те планы, чья себестоимость изменилась с 00:00:00 до 23:59:59 предыдущих суток. Если себестоимость Тарифного плана изменилась, например, в 00:01 текущих суток, то этот Тарифный план попадет в выборку только на следующие сутки. |
Кредитный лимит для постоплатной подписки изменен | Событие наступает для Клиентов, у которых есть Подписка по Постоплате в статусе отличном от Удалена, в случае:
Событие наступает если перечисленные выше действия выполняются:
|
Приближение к кредитному лимиту постоплатной подписки | Событие наступает в случае если величина Текущей задолженности по Подписке пересекла установленный % Кредитного лимита для этой Подписки, но не вышла за этот Кредитный лимит, то есть выполнилось условие заданное в поле Правило. Уведомление отправляется 1 раз. |
Закрывающие документы сформированы | Событие наступает при вызове API-метода (см. Send notifications on closing documents) для рассылки уведомлений Клиентам Реселлера о том, что Закрывающие документы за указанный период получены из сторонней ERP-системы и доступны для скачивания по ссылкам и через Панель управления Клиента в разделе Закрывающие документы (см. Closing documents). Раздел Закрывающие документы отображается в Панели управления Клиента, если включена соответствующая системная настройка (см. Задание общих системных настроек). Уведомление отправляется только для документов в статусе Новый. После отправки уведомления статус этих документов меняется на Отправлен. |
Создан объединенный платеж | Событие наступает при автоматическом или ручном объединении Платежей (см. Объединение Платежей по модели Предоплата). |
Повторная отправка заказа | Происходит через указанное количество дней после создания Заказа для Заказов в статусе Ожидает оплаты, у которых Платеж связан только с одним Заказом (то есть Заказ не связан с объединенным Платежом — см. Объединение Платежей по модели Предоплата). |
Повторная отправка объединенного платежа | Происходит через указанное количество дней после создания объединенного Платежа для Платежей в статусе Ожидает оплаты. |
Запрос на сброс пароля при создании пользователя | Происходит при сбросе пароля Пользователя, в случае если Пользователь был создан в Панели управления Оператора (Создание Пользователя). |
Обновление себестоимости CSP | Происходит ежедневно для всех Подписок. Для корректной работы требует обязательной настройки Правила обработки События. |
Загрузка себестоимости CSP | Происходит:
|
Заявка на создание счёта отправлена | Сформирована Ручная операция на создание счета на оплату. |
Счёт на пополнение баланса готов | Счет на оплату для пополнения баланса Клиента сформирован вручную. |
Отчётный период закрыт | Уведомление о закрытии отчетного периода при получении от 1С запроса для сверки баланса Клиентов отправляется в случае совпадения балансов в 1С и ActivePlatform. |
VSP ресурсы изменились | Происходит при смене статуса Подписки на Тарифный план, переданный из Vendor Portal, с Обновление на Активная при изменении количества Ресурсов Подписки. |
VSP подписка создана | Происходит при смене статуса Подписки на Тарифный план, переданный из Vendor Portal, с Устанавливается на Активная (см. Синхронизация Продуктов и Тарифных планов между Vendor Portal и ActivePlatform). |
Создание сервера | Происходит при создании нового сервера CloudServer (см. Создание Сервера). |
Сброс пароля сервера | Происходит при сбросе пароля сервера CloudServer. Сброс пароля возможен через пользовательский веб-интерфейс управления услугой CloudServer (Сброс пароля администратора сервера через раздел Серверы и Сброс пароля администратора сервера через раздел раздел Дата-центры). |