Создание События уведомлений

Перед созданием События уведомлений необходимо:

Создать SMS-шлюз для СМС-уведомлений (см. Управление SMS-шлюзами);
Создать Шаблон уведомлений, на базе которого будет формироваться текст Уведомления для данного События уведомления (см. Управление Шаблонами уведомлений).

Созданное Событие уведомлений автоматически создается у всех нижестоящих Реселлеров (подробнее см. Делегирование Шаблонов интерфейса, Шаблонов уведомлений, Событий уведомлений и Категорий уведомлений).

Чтобы создать Событие уведомлений, необходимо:

Войти в Панель управления Оператора.
На Панели навигации перейти в раздел Настройки > Уведомления > События уведомлений. В рабочей области отобразится Список событий уведомлений (см. Просмотр списка Событий уведомлений).
На Панели инструментов страницы Событий уведомлений нажать кнопку Создать. В рабочей области появится страница Добавить обработчик.

Так как Событие уведомлений делегируется всем нижестоящим Реселлерам, то оно должно быть уникальным. Набор параметров Событие, Тип Шаблона уведомлений, Шаблон уведомлений и Правило не должен совпадать с соответствующим набором параметров существующих Событий уведомлений у текущего Реселлера (Оператора) и всех его нижестоящих Реселлеров.
На странице Добавить обработчик в открывающемся списке Событие выбрать тип события, при наступлении которого должно срабатывать Событие уведомлений. Список Событий уведомлений включает в себя следующие События:
- Приближается кредитный лимит - происходит если Баланс Клиента становится равным либо меньше заданной доли (от 1% до 99% включительно) от Кредитного лимита, но не меньше Кредитного лимита. Для корректной работы требует обязательной настройки Правила обработки События.
  Например, при следующем Правиле обработки события, Событие произойдет когда Баланс Аккаунта будет составлять менее 35% от Кредитного лимита:
  account.credit_limit % 35 < -account.balance
- Клиент изменён - происходит при блокировке Клиента (финансовой или административной, см. Переход Клиента в финансовую блокировку и Перевод Клиента в административную блокировку) и при активации Клиента после блокировки (см. Выход Клиента из финансовой блокировки и Активация Клиента после административной блокировки);
- Клиент создан - происходит при создании нового Клиента (см. Создание Клиента);
- Кредитный лимит изменен - происходит при изменении значения Кредитного лимита в Правиле обслуживания (см. Создание Правила обслуживания) или при изменении значения индивидуального Кредитного лимита для Клиента (см. Просмотр и обновление информации о Клиенте). Событие происходит также и при создании нового Клиента. Если Клиенту назначается другое Правило обслуживания, а Кредитный лимит не изменяется, то Событие не происходит.
- Менеджер клиента изменен - происходит при изменении или назначении менеджера Клиента (см. Просмотр и обновление информации о Клиенте);
- Закрытие Акта - происходит в Финансовый день при выставлении Акта за потребленную Услугу (подробнее см. Управление Актами);
- Недостаточно средств на балансе - происходит если Баланс аккаунта меньше либо равен нулю;
- Ручная операция происходит при:
  - создании Ручной операции (подробнее см. Просмотр Списка ручных операций и Создание Правила обслуживания);
  - утверждении или отклонении Ручной операции (подробнее см. Просмотр и управление Ручными операциями).
- Платеж получен происходит при смене статуса Платежа:
  - с любого статуса на статус Отменен (подробнее см. Отмена Платежа);
  - c Ожидает оплаты на Завершен;
  - c Ожидает оплаты на Счет формируется (подробнее см. Обработка Платежа с ручным методом выставления Счета);
  - cо Счет формируется на Счет отправлен;
  - со Счет отправлен на Завершен.
- Запрос сброса пароля - происходит при запросе письма с инструкциями по сбросу пароля к Панели управления Клиента (подробнее см. Reset password);
- Запрос сброса пароля менеджера - происходит при запросе письма с инструкциями по сбросу пароля к Панели управления Оператора (подробнее см. Сброс пароля к Панели управления Оператора);
- До окончания периода подписки - происходит ежедневно для всех Подписок. Для корректной работы требует обязательной настройки Правила обработки События;
- После окончания периода подписки - происходит ежедневно для всех Подписок. Для корректной работы требует обязательной настройки Правила обработки События;
- Подписка переведена из пробного статуса в платный - происходит при переходе Подписки из пробного в тарифицируемый период;
- Подписка изменена происходит при:
  - смене статуса Подписки на:
    Активная;
    Удалена, кроме перехода в статус Удалена из статуса Новый заказ;
    Остановлена, кроме случая административной блокировки Аккаунта;
    Просрочена оплата;
    Требуется ручное подтверждение.
  - при переходе Подписки из пробного в тарифицируемый период;
  - продлении активной подписки в Панели управления Оператора (см. Ручное продление Подписки) или в Панели управления Клиента (см. Renew subscription);
  - при автопродлении Подписки (см. Автоматическое продление Подписки);
  - изменении Ресурсов Подписки.
- Подтверждение email - происходит при регистрации нового пользователя в Панели управления Клиента, после нажатия кнопки Зарегистрироваться (подробнее см. Quick registration);
- Приглашения пользователя - происходит при приглашении внешнего пользователя Владельцем или Администратором Аккаунта (подробнее см. Приглашение Внешнего пользователя);
- Заказ изменён - происходит при смене статуса Заказа на:
  - Отменен (при ручной отмене Заказа или при отмене Платежа за Заказ в Панели управления Клиента и Панели управления Оператора см. Панель управления Оператора. Отмена заказа перед оплатой, Панель управления Клиента. Просмотр Списка заказов, Панель управления Оператора. Отмена Платежа, Панель управления Клиента. Отмена Платежа);
  - Предоставляется;
  - Завершен (см. Просмотр Списка заказов).
- Заказ создан - происходит при создании нового Заказа (Создание Заказа);
- Обещанный платеж создан - происходит при:
  - ручном создании Обещанного платежа через Панель управления Оператора или через Панель управления Клиента (подробнее см. Панель управления Оператора. Создание Обещанного платежа и Панель управления Клиента. Создание Обещанного платежа);
  - автоматическом создании Обещанного платежа имеющего статус Предоставлен в связи с пополнением.
- Обещанный платеж изменен - происходит при автоматическом или ручном отзыве Обещанного платежа. Подробнее см. Отзыв Обещанного платежа;
- Осталось дней до оплаты - происходит ежедневно для всех Подписок. Для корректной работы требует обязательной настройки Правила обработки События;
- Телефонная верификация - происходит при нажатии кнопки Получить код на шаге SMS верификация при проведении полной регистрации Аккаунта (см. Full registration);
- Обновление цен CSP - происходит ежедневно для всех Подписок. Для корректной работы требует обязательной настройки Правила обработки События;
- Загрузка цен CSP происходит:
  - после загрузки нового файла с ценами (см. Обновление цен Ресурсов тарифных планов);
  - после утверждения нового файла с ценами, в случае когда файл с ценами из статуса Требуется подтверждение переходит в статус Будущий или Текущий;
  - после перехода файла из статуса Будущий в статус Текущий.
- Заявка на создание счета отправлена - сформирована ручная операция на создание счета на оплату;
- Счёт на пополнение баланса готов - счет на оплату для пополнения баланса Клиента сформирован вручную;
- Отчётный период закрыт - финансовый период завершен;
- Запрос на сброс пароля при создании пользователя происходит при сбросе пароля Пользователя, в случае если Пользователь был создан в Панели управления Оператора (Создание Пользователя);
- VSP ресурсы изменились - происходит при смене статуса Подписки на Тарифный план, переданный из Vendor Portal, с Обновление на Активная при изменении количества Ресурсов Подписки;
- VSP подписка создана - происходит при смене статуса Подписки на Тарифный план, переданный из Vendor Portal, с Устанавливается на Активная (см. Синхронизация Продуктов и Тарифных планов между Vendor Portal и ActivePlatform);
- Создание сервера - происходит при создании нового сервера CloudServer (см. Создание Сервера);
- Сброс пароля сервера - происходит при сбросе пароля сервера CloudServer. Сброс пароля возможен через пользовательский веб-интерфейс управления услугой CloudServer (Сброс пароля администратора сервера через раздел Серверы и Сброс пароля администратора сервера через раздел раздел Дата-центры);
- Себестоимость изменена - происходит при изменении себестоимости Тарифного плана на уровне текущего Реселлера (см. Просмотр Прайс-листа).
  При создании этого События уведомления следует оставить поле Правило пустым.
  Платформа собирает данные об изменении себестоимости раз в сутки ночью. При этом в выборку Тарифных планов включаются только те планы, чья себестоимость изменилась с 00:00:00 до 23:59:59 предыдущих суток. Если себестоимость Тарифного плана изменилась, например, в 00:01 текущих суток, то этот Тарифный план попадет в выборку только на следующие сутки.
- Финансовый день наступает - происходит ежедневно для каждого уникального Финансового дня, если Клиент работает по модели Предоплата (см. Создание Правила обслуживания). Пользователю Клиента с ролью Владелец отправляется email сообщение о дате Финансового дня и о сумме предстоящего списания средств с Баланса Клиента. В случае, если у Клиента есть Подписки с типом биллинга По факту потребления, в письме будет указано, что сумма, на которую нужно пополнить Баланс, может измениться. В сообщении также будет размещена ссылка на страницу пополнения Баланса Клиента (см. Пополнение Баланса Клиента).
  Для корректной работы требует обязательной настройки Правила обработки События.
  Если не задать Правило обработки, то Событие уведомления будет срабатывать во всех возможных ситуациях: ежедневно для каждого уникального Финансового дня, независимо от типа биллинга Подписки. Например, если у Клиента есть три Подписки с типами биллинга Предзаказ, CSP годовой, По факту потребления и тремя разными Финансовыми днями, то в течение всего месяца ему будет приходить по три Уведомления в день.
  Чтобы этого избежать, необходимо задать следующие параметры (см. Плейсхолдеры для описания Правила обработки события):
  наличие Подписок с определенным типом биллинга у Клиента. Задается при помощи Плейсхолдера monthly_billing. Чтобы Уведомления приходили только Клиентам, у которых есть Подписки с типами биллинга CSP месячный, G Suite, Оплата в полном объеме и Без возврата, в поле Правило нужно добавить следующее условие:
  monthly_billing = "true"
  количество дней, которые остались до даты Финансового дня: задается при помощи Плейсхолдера billing_day_left. Чтобы Уведомления приходили только за определенное количество дней до наступления уникального Финансового дня, в поле Правило нужно добавить следующее условие:
  billing_day_left = {количество дней до Финансового дня, за которое нужно отправить Уведомление}
  Дополнительно можно задать следующие параметры:
  Число месяца, на которое установлен Финансовый день. Задается при помощи Плейсхолдера billing_day.
  Сумма Cписаний со статусом Открыто для неудаленных Подписок, которые будут закрыты или заблокированы в Финансовый день, для которого было вызвано событие. Задается при помощи Плейсхолдера billing_day_open_charges_amount.
  ID Планов активных Подписок Клиента. Задается при помощи Плейсхолдера plan_ids.
  ID Продуктов активных Подписок Клиента. Задается при помощи Плейсхолдера product_ids.
  Ключ Типа Клиента. Задается при помощи Плейсхолдера account.type_key.
  Ключ Правила обслуживания Клиента. Задается при помощи Плейсхолдера account.class_key.
  Доступный Баланс Клиента. Задается при помощи Плейсхолдера account.balance.
  Кредитный лимит, доступный Клиенту. Задается при помощи Плейсхолдера account.credit_limit.
  
  Например:
  billing_day = 1 and billing_day_left = 28 and account.type_key = "personal" and account.class_key = "default" and account.credit_limit = 0 and monthly_billing = true and (plan_ids include? 1420) and (product_ids include? 498)
  Если нужно добавить несколько условий, которые должны выполняться одновременно, то следует использовать оператор and: billing_day = 1 and billing_day_left = 28. В данном примере Уведомление будет отправлено для Подписок, Финансовый день которых установлен 1-го числа каждого месяца, за 28 дней до наступления Финансового дня. Всего будет отправлено одно Уведомление.
  Если нужно добавить несколько условий, одно из которых должно выполняться обязательно, то следует использовать оператор or: billing_day = 1 or billing_day = 5. В данном примере по одному Уведомлению будет отправляться каждый день Финансового периода для Подписок, Финансовый день которых установлен как 1-го, так и 5-го числа каждого месяца.
  Для группировки и объединения условий можно использовать скобки (): (billing_day = 1 or billing_day = 2) and (billing_day_left = 3 or billing_day_left = 4) . В данном примере Уведомления будут отправлены для Подписок, Финансовый день которых установлен как 1-го, так и 1-го числа каждого месяца за 23 и за 24 дня до до наступления Финансового дня. Всего будет отправлено четыре Уведомления.
  Также для формирования Правила можно использовать арифметические операторы + и -, операторы сравнения значений Плейсхолдеров > <, менять порядок значений (1 = billing_day).
В открывающемся списке Тип шаблона уведомлений выбрать один из способов отправки уведомлений: Email, СМС или Панель управления Клиента.
В списке Шаблон уведомлений выбрать ранее созданный Шаблон уведомлений (см. Управление Шаблонами уведомлений).
Чтобы настроить рассылку уведомлений в определенное время, необходимо:
- снять флажок Добавить в очередь на отправку сразу, поле Добавить в очередь на отправку в определенное время (час суток) станет доступным;
- в поле Добавить в очередь на отправку в определенное время (час суток) ввести час суток, в который задачи на отправку уведомлений по данному событию должны быть поставлены в Очередь на отправку.
В поле Правило ввести запрос и условия обработки события, используя Плейсхолдеры (см. Плейсхолдеры для описания Правила обработки события).
При описании Правила обработки события возможны следующие операции с переменными (Плейсхолдерами):
- >
- <
- >=
- <=
- =
- !=
- include? (например, order.type = "SalesOrder" and (order.plans_ids include? 2000030)) - обработчик события сработает, если в заказ на покупку включен тарифный план с id =2000030)
- exclude? (исключить определенные сущности (по id, ключу, имени) из выбранного массива сущностей, например, для исключения отправки уведомления о создании заказа на подписку по тарифному плану с id = 2000000, необходимо использовать следующее правило: order.plans_ids exclude? 2000000)
- and
- or
- % (например, account.credit_limit % 30 - 30% от Кредитного лимита)
При создании Шаблонов уведомлений доступна возможность использовать открытый язык шаблонов Liquid, который позволяет создавать сложные Уведомления. Подробнее https://shopify.github.io/liquid/basics/introduction/.
```
subscription.days_left = 10 AND subscription.status = "active" 
Данный запрос означает, что обработчик будет работать для всех активных подписок, которые истекают через 10 дней.
```

5. Нажать кнопку Создать. Новое Событие будет создано и отображено в Списке событий уведомлений (см. Просмотр списка Событий уведомлений) у текущего Реселлера и его нижестоящих Реселлеров.