Создание события уведомлений
Перед созданием события уведомлений необходимо создать шаблон уведомлений, на основе которого будет формироваться текст уведомления для этого события уведомления (см. Управление шаблонами уведомлений). Для СМС-уведомлений также требуется создать SMS-шлюз (см. Управление SMS-шлюзами). Созданное событие уведомлений автоматически создается у всех нижестоящих реселлеров (подробнее см. Делегирование шаблонов интерфейса, шаблонов уведомлений, событий уведомлений и категорий уведомлений).
В этой статье:
Создание события уведомлений
Чтобы создать событие уведомлений:
- Перейдите в раздел События уведомлений (см. Навигация по Панели управления Оператора). Отобразится список событий уведомлений (см. Просмотр списка событий уведомлений).
Нажмите Создать. Отобразится страница Добавить обработчик.
Так как событие уведомлений делегируется всем нижестоящим реселлерам, то оно должно быть уникальным. Набор параметров Событие, Тип Шаблона уведомлений, Шаблон уведомлений и Правило не должен совпадать с соответствующим набором параметров существующих событий уведомлений у текущего реселлера и всех его нижестоящих реселлеров.В списке Событие выберите событие, при наступлении которого должно срабатывать событие уведомлений. Список событий см. в таблице ниже.
- В списке Тип шаблона уведомлений выберите один из способов отправки уведомлений: Email, СМС или Панель управления Клиента.
- В списке Шаблон уведомлений выберите ранее созданный шаблон уведомлений выбранного типа (см. Просмотр списка шаблонов уведомлений). Доступен поиск по части ID и названия шаблонов уведомлений.
- Если требуется настроить рассылку уведомлений в определенное время:
- Снимите флажок Добавить в очередь на отправку сразу. Поле Добавить в очередь на отправку в определенное время (час суток) станет доступным.
- В поле Добавить в очередь на отправку в определенное время (час суток) введите час суток, в который задачи на отправку уведомлений по этому событию должны быть поставлены в очередь на отправку.
В поле Правило введите условия обработки события, используя плейсхолдеры (см. Плейсхолдеры для описания правила обработки события).
При описании правила обработки события возможны следующие операции с плейсхолдерами:
>
<
>=
<=
=
!=
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
)
Нажмите Создать. Новое событие будет создано и появится в списке событий уведомлений текущего реселлера и его нижестоящих реселлеров.
Список событий
Событие | Описание |
---|---|
Приближается финансовая блокировка клиента (Account credit hold is coming) | Происходит если баланс клиента становится равным либо меньше заданной доли (от 1% до 99% включительно) от порога срабатывания финансовой блокировки, но не меньше порога срабатывания финансовой блокировки. Для корректной работы требует обязательной настройки правила обработки события. |
Клиент изменен (Account changed) | Происходит при блокировке клиента (финансовой или административной, см. Переход клиента в финансовую блокировку и Перевод клиента в административную блокировку) и при активации клиента после блокировки (см. Выход клиента из финансовой блокировки и Активация клиента после административной блокировки). |
Клиент создан (Account created) | Происходит при создании нового клиента (см. Создание клиента). |
Порог срабатывания финансовой блокировки изменен (Financial blocking threshold was changed) | Происходит при изменении значения порога срабатывания финансовой блокировки в правиле обслуживания (см. Создание правила обслуживания) или при изменении индивидуального значения для клиента (см. Просмотр и обновление информации о клиенте). Событие происходит также и при создании нового клиента. Если клиенту назначается другое правило обслуживания, а порог срабатывания финансовой блокировки не изменяется, то событие не происходит. |
Менеджер клиента изменен (Account manager changed) | Происходит при изменении или назначении менеджера для уже существующего клиента (см. Просмотр и обновление информации о клиенте). |
Корректировка баланса подтверждена (Correction approved) | Происходит при подтверждении корректировки в Панели управления Оператора (см. Подтверждение корректировки) или по API (см. Update correction status). В поле Правило можно указать ID менеджера, подтвердившего корректировку. Уведомление отправляется на email Владельца клиента. |
Закрытие Акта (Invoice closed) | Происходит в финансовый день при выставлении акта за потребленную услугу (подробнее см. Управление актами). Также используется для ручной отправки акта на email (см. Пересылка акта по email) |
Счет был подтвержден (The Invoice was approved) | Событие наступает при подтверждении акта по модели Постоплата с внешним управлением (см. Управление актами по модели Постоплата сторонней ERP-системой). Чтобы определить, был ли прикреплен к связанному платежу счет на оплату, в правиле обработки события используется плейсхолдер invoice.has_attached . |
Недостаточно средств на балансе (Low balance) | Происходит если баланс клиента меньше либо равен нулю. |
Сотрудник создан (Manager created) | Происходит при создании менеджера через Панель управления Оператора (см. Добавление сотрудника) или по API (см. Create manager). Используется для отправки менеджеру учетных данных для входа (см. Плейсхолдеры в шаблонах уведомлений для отдельных событий уведомлений). Не требует настройки правила обработки события. |
Ручная операция (Manual operation) | Происходит при:
|
Платеж получен (Payment has been received) | Происходит при смене статуса платежа:
|
Срок оплаты платежа приближается (Payment due date is coming) | Происходит только для подписок по модели Постоплата. В зависимости от условий в правиле происходит либо за заданное в правиле количество дней до истечения периода отсрочки платежа (см. Плейсхолдеры для описания правила обработки события), либо при переходе платежа в статус Просрочен и блокировке связанных подписок (см. Просмотр акта для модели Постоплата). При отсутствии условий в правиле событие произойдет в дату истечения периода отсрочки платежа. Email-уведомление включает счет в формате PDF. PDF-счет формируется для платежа, связанного с актом по модели Постоплата. PDF-счет формируется только для клиентов, у которых в качестве способа оплаты по умолчанию задан активный способ оплаты на основе модуля CheckCash (см. Просмотр и обновление типа клиентов). |
Платеж по постоплате создан (Postpay payment created) | Происходит на следующий день после финансового дня, когда платформа закрывает акт по модели Постоплата и создает связанный платеж. Email-уведомление включает PDF-счет для платежа. PDF-счет формируется только для клиентов, у которых в качестве способа оплаты по умолчанию задан активный способ оплаты на основе модуля CheckCash (см. Просмотр и обновление типа клиентов). |
Запрос сброса пароля (Password reset request) | Происходит при запросе письма с инструкциями по сбросу пароля к Панели управления Клиента (подробнее см. Reset password). |
Запрос сброса пароля менеджера (Manager password reset request) | Происходит при запросе письма с инструкциями по сбросу пароля к Панели управления Оператора (подробнее см. Сброс пароля к учетной записи сотрудника). |
До окончания периода подписки (Before subscription expiration) | Происходит ежедневно для всех подписок, у которых нет связи с заказом на продление в статусе Ожидает предоставления или Предоставляется. Для корректной работы требует обязательной настройки правила обработки события. |
После окончания периода подписки (After subscription expiration) | Происходит ежедневно для всех подписок. Для корректной работы требует обязательной настройки правила обработки события. |
Подписка переведена из пробного статуса в платный (After subscription switched from trial to no-trial) | Происходит при переходе подписки из пробного на платный период как для модели Предоплата, так и Постоплата. |
Подписка изменена (Subscription changed) | Происходит при:
|
Подтверждение email (Verify email) | Происходит при регистрации нового пользователя в Панели управления Клиента, после нажатия кнопки Зарегистрироваться (подробнее см. Quick registration). |
Приглашение пользователя (User invitation) | Происходит при приглашении внешнего пользователя Владельцем или Администратором клиента (подробнее см. Приглашение Внешнего пользователя). |
Заказ изменён (Order changed) | Происходит при смене статуса заказа на:
Счет к уведомлению не прикрепляется. |
Заказ создан (Order created) | Происходит при создании нового заказа (Создание заказа). В том числе, срабатывает как при ручном, так и при автоматическом создании заказа на продление. Чтобы исключить отправку клиентам счетов на оплату по заказам на пролонгацию, создаваемым в финансовый день для автоматической оплаты с баланса клиента (см. Пролонгация подписки), необходимо чтобы для подписок, у которых установлена Точка автоматического продления (в днях) = 0, события Заказ создан и Заказ изменён не срабатывали. Для этого в правиле обработки этих событий задайте условие |
Обещанный платёж создан (Guaranteed payment created) | Происходит при:
Подробнее см. Управление обещанными платежами. |
Обещанный платёж изменён (Guaranteed payment changed) | Происходит при автоматическом или ручном отзыве обещанного платежа. Подробнее см. Управление обещанными платежами. |
Обещанный платёж истекает (Guaranteed payment will expire) | Происходит за указанное количество дней до наступления даты истечения обещанного платежа. Подробнее см. Управление обещанными платежами. |
Осталось дней до оплаты (Days left to pay) | Происходит ежедневно для всех подписок. Для корректной работы требует обязательной настройки правила обработки события. |
Телефонная верификация (Phone verification) | Происходит при нажатии кнопки Получить код на шаге SMS верификация в процессе полной регистрации клиента (см. Full registration). |
Финансовый день наступает (Billing day is coming) | Происходит ежедневно для каждого уникального финансового дня. Пользователю клиента с ролью Владелец отправляется email-сообщение о дате финансового дня и о сумме предстоящего списания средств с баланса клиента. Если у клиента есть подписки с типом биллинга Pay as you go, в тексте уведомления укажите, что сумма, на которую нужно пополнить баланс, может измениться. В сообщении также может быть размещена ссылка на страницу пополнения баланса клиента (см. Пополнение Баланса Клиента). Пользователи, авторизованные в Панели управления Оператора с ролью Системный администратор и Менеджер по продажам (см. Роли сотрудников), также могут перейти по этой ссылке в Панель управления Клиента в рамках одного реселлера, если у них в браузере нет сессии с авторизацией в Панели управления Клиента. Учитываются только подписки в следующих статусах (см. Просмотр списка подписок):
Для корректной работы требует обязательной настройки правила обработки события. Чтобы сформировать таблицу с перечнем подписок, которые истекают в ближайший финансовый период, можно использовать следующие плейсхолдеры:
|
Финансовый день по подпискам менеджера наступил (Billing day for manager's subscriptions has come) (ранее — Финансовый день наступил (Billing day has come)) | Событие происходит после прохождения биллинг-процесса и закрытия списаний для каждого менеджера при выполнении следующего условия:
В поле Получатель на странице создания и редактирования шаблона уведомлений укажите плейсхолдер |
Финансовый день по подписке клиента наступил (Billing day for account's subscription has come) | Событие происходит после прохождения биллинг-процесса и закрытия списаний для каждого клиента при выполнении всех следующих условий:
Если у клиента несколько подписок с одним финансовым днем, то событие срабатывает для каждой подписки в отдельности. В поле Получатель на странице создания и редактирования шаблона уведомлений можно указать плейсхолдер По подпискам Microsoft Azure Plan и Microsoft Azure для события может использоваться специально подготовленный шаблон уведомления с разбивкой данных по категориям ресурсов: |
Себестоимость изменена (Net cost has been changed) | Происходит при изменении себестоимости тарифного плана на уровне текущего реселлера (см. Просмотр прайс-листа). При создании этого события уведомления оставьте поле Правило пустым. Платформа собирает данные об изменении себестоимости раз в сутки ночью. При этом в выборку тарифных планов включаются только те планы, себестоимость которых изменилась с 00:00:00 до 23:59:59 предыдущих суток. Если себестоимость тарифного плана изменилась, например, в 00:01 текущих суток, то этот тарифный план попадет в выборку только на следующие сутки. |
Кредитный лимит для постоплатной подписки изменен (Credit limit for postpaid subscription was changed) | Событие происходит для клиентов, у которых есть подписка по модели Постоплата в статусе отличном от Удалена, в случае:
Событие происходит, если перечисленные выше действия выполняются как через Панель управления Оператора, так и по API. |
Приближение к кредитному лимиту постоплатной подписки (Credit limit for postpaid subscription is approaching) | Событие происходит, если величина текущей задолженности по подписке пересекла установленный % (1...99) кредитного лимита для этой подписки, вне зависимости от статуса подписки. Уведомление отправляется 1 раз. |
Закрывающие документы сформированы (Closing documents generated) | Событие происходит при вызове API-метода (см. Send notifications on closing documents) для рассылки уведомлений клиентам реселлера о том, что закрывающие документы за указанный период получены из сторонней ERP-системы и доступны для скачивания по ссылкам и через Панель управления Клиента в разделе Закрывающие документы (см. Closing documents). Уведомление отправляется только для документов в статусе Новый. После отправки уведомления статус этих документов меняется на Отправлен. |
Создан объединенный платеж (Joined payment created) | Событие происходит при автоматическом или ручном объединении платежей (см. Объединение платежей по модели Предоплата). |
Повторная отправка заказа (Resend the order) | Происходит через указанное количество дней после создания заказа для заказов в статусе Ожидает оплаты, у которых платеж связан только с одним заказом (то есть заказ не связан с объединенным платежом — см. Объединение платежей по модели Предоплата). |
Повторная отправка объединенного платежа (Resend the joined payment) | Происходит через указанное количество дней после создания объединенного платежа для платежей в статусе Ожидает оплаты. |
Расходы по подписке приближаются к установленному бюджету расходов на период (Spending budget for a period is approaching) | Если в подписке с типом биллинга Pay as you go клиент установил процент от бюджета расходов для отправки уведомления, событие срабатывает, когда потребление по подписке (сумма списаний в статусе Заблокировано) за выбранный период достигло или превысило порог, но при этом остается меньше бюджета расходов. Указывать правило обработки для события не требуется. Установка бюджета расходов и процента от бюджета расходов для отправки уведомления доступна только в новой Панели управления Клиента. |
Расходы по подписке достигли установленного бюджета расходов на период (Spending budget has been reached) | Если в подписке с типом биллинга Pay as you go клиент установил бюджет расходов за выбранный период, событие срабатывает, когда потребление по подписке (сумма списаний в статусе Заблокировано) за выбранный период достигло или превысило бюджет. Указывать правило обработки для события не требуется. Установка бюджета расходов и процента от бюджета расходов для отправки уведомления доступна только в новой Панели управления Клиента. |
Обнаружение неожиданного увеличения потребления (Unexpected consumption increase detection) | Происходит, если разность потребления день-ко-дню по подписке с типом биллинга Pay as you go достигла или превысила установленный порог. Если указаны два порога, событие происходит, когда изменение потребления достигло или превысило оба порога. Пороги задаются в системных настройках как общие для всех подписок (см. Мониторинг увеличения расходов по PAYG подпискам в Задание общих системных настроек). |
Запрос на сброс пароля при создании пользователя (Request to reset the password after the user creation) | Происходит при сбросе пароля пользователя, если пользователь был создан в Панели управления Оператора (Создание пользователя). |
Обновление себестоимости CSP (Update CSP net costs) | Происходит ежедневно для всех подписок. Для корректной работы требует обязательной настройки правила обработки события. |
Загрузка себестоимости CSP (Upload CSP net costs) | Происходит:
|
Заявка на создание счёта отправлена (Request for creating bill was sent) | Сформирована ручная операция на создание счета на оплату. |
Счёт на пополнение баланса готов (Bill on balance replenishment is ready) | Счет на оплату для пополнения баланса клиента сформирован вручную. |
Отчётный период закрыт (The accounting period was closed) | Уведомление о закрытии отчетного периода при получении от 1С запроса для сверки баланса клиентов отправляется в случае совпадения балансов в 1С и ActivePlatform. |
Создание сервера (Create instance) | Происходит при создании нового сервера CloudServer (см. Создание Сервера). |
Сброс пароля сервера (Reset instance password) | Происходит при сбросе пароля сервера CloudServer. Сброс пароля возможен через пользовательский веб-интерфейс управления услугой CloudServer (Сброс пароля администратора сервера через раздел Серверы и Сброс пароля администратора сервера через раздел раздел Дата-центры). |
Обработка данных по подпискам Azure Plan завершена (Data processing for Azure Plan subscriptions completed) | Происходит на уровне того реселлера, для которого созданы настройки модуля Office365 и шаблон услуги на основе модуля Microsoft CSP Products. Происходит после завершения обработки детализированных данных о потреблении по всем подпискам Microsoft Azure Plan реселлера через 2 дня после закрытия актов. Правило обработки для события не настраивается. В качестве получателя уведомления можно указать только конкретный email менеджера без использования плейсхолдеров. См. Настройка уведомлений для Подписок Microsoft Azure Plan в руководстве Services. Operator Guide. |
AppSource ссылка для активации сгенерирована (AppSource Activation Link Generated) | Новая подписка на услугу Microsoft AppSource перешла в статус Установка и ожидает активации на стороне вендора. Для активации клиенту нужно перейти по ссылке в уведомлении (см. Microsoft AppSource. Operator Guide). |
VSP ресурсы изменились (VSP resources changed) | Происходит при смене статуса подписки на тарифный план, переданный из Vendor Portal, с Обновление на Активная при изменении количества ресурсов подписки. |
VSP подписка создана (VSP subscription created) | Происходит при смене статуса подписки на тарифный план, переданный из Vendor Portal, с Устанавливается на Активная (см. Синхронизация продуктов и тарифных планов между Vendor Portal и ActivePlatform). |