Уведомления, бонусы и воронка

Полный перечень полей — в глоссарии. Когда аренда меняет статус (переход из одного состояния жизненного цикла в другое) или просто пересохраняется, система не ограничивается записью в базу. В самом конце сохранения аренды срабатывает цепочка побочных эффектов: клиенту уходит уведомление в мессенджер, в отдел продаж создаются или переносятся лиды, клиенту начисляются бонусы за завершённую аренду, он повышается по «отметкам» лояльности, а реферальному агенту фиксируется вознаграждение. Эта страница описывает, что именно и в какой момент срабатывает, какие есть точки принятия решений и как это использовать.

​

Общая картина

Все автоматические эффекты запускаются в одной точке — сразу после того, как аренда сохранена в базе. Порядок такой:

1. пересчитывается график занятости инвентаря — в том же запросе, потому что от доступности зависит бронирование;
2. в очередь ставится одна фоновая задача, которая рассылает уведомления клиенту (сторона мессенджера) и создаёт либо переносит лиды в воронке продаж.

Дополнительно, уже как реакция на факт сохранения, отдельно отрабатывают:

• начисление бонусов клиенту (только для завершённой и полностью оплаченной аренды);
• продвижение клиента по «отметкам» лояльности (только для завершённой аренды).

​

Уведомления клиенту при смене статуса

​

Когда формируется уведомление

Подготовка уведомления происходит при каждом сохранении аренды, но реально что-то отправляется только если выполнены все условия:

• статус действительно изменился — если новый статус совпадает с прежним, уведомление не готовится вообще;
• аренда не удалена;
• у аренды есть клиент (иначе слать некому — уведомление не готовится).

Если условия выполнены, система собирает «контекст шаблона» — набор подстановок, из которых потом строится текст сообщения, и ставит фоновую задачу отправки.

​

Что попадает в контекст сообщения

​

Как выбираются сообщения к отправке

Задача отправки работает в контексте конкретной компании и по её интеграции с мессенджером Wazzup:

• если запрос выполняется вне контекста компании — задача сразу завершается, ничего не делая;
• если у компании нет подключения к Wazzup или оно неактивно — рассылки не будет.

Дальше подбираются триггеры сообщений: берутся только те, что настроены на переход из прежнего статуса в новый для сущности «аренда». Здесь есть важное правило по срочности:

• если задаче передан конкретный триггер, отправляется именно он;
• если конкретный триггер не задан (обычный путь при смене статуса), берутся только мгновенные триггеры — те, у которых задержка отправки не больше одной минуты.

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

​

Отдельный сценарий: уведомление о просрочке

Для перехода аренды в статус «просрочка» есть выделенная задача. Она отличается от обычного пути:

• на вход получает идентификатор аренды и конкретный триггер сообщения;
• если аренда не найдена или у неё нет клиента — завершается без отправки;
• переход статуса всегда трактуется как «в просрочку» (целевой статус жёстко зафиксирован);
• менеджером считается создатель аренды, а если его нет — сотрудник из последнего действия по аренде;
• собирает такой же контекст (без остатка бонусов) и вызывает общую отправку уже с указанием конкретного триггера — то есть здесь отправка не ограничена «мгновенными» триггерами.

​

Лиды в воронке продаж

При смене статуса аренда дёргает воронку продаж. Здесь описана только точка вызова со стороны аренды; вся механика триггеров этапов, создания и переноса лидов живёт на стороне продаж. Условия и поведение точки вызова:

• если аренда удалена — ничего не происходит;
• если у компании не подключена интеграция с воронкой — ничего не происходит;
• если статус не изменился (пересохранение без перехода) — у уже существующих лидов этой аренды только обновляются сумма и клиент, новые лиды не создаются;
• если статус изменился — по настроенным триггерам «источник заявки» лиды переносятся между этапами/воронками и при необходимости создаются новые (по одному на подходящий этап), после чего по каждому лиду выполняются триггеры его нового этапа.

Подробнее про правила воронки: «Триггеры этапов».

​

Бонусы: автоматическое начисление за завершённую аренду

Как реакция на сохранение аренды бонусы начисляются клиенту автоматически, но при строгих условиях. Начисление происходит только если одновременно:

• аренда не удалена;
• у аренды есть клиент;
• статус аренды — «завершена»;
• статус оплаты — «оплачено».

Если хоть одно условие не выполнено, начисления нет.

​

Как считается сумма начисления

Процент начисления берётся из персональной программы лояльности клиента (если она у него привязана), иначе — из процента начисления по умолчанию в настройках компании. Сумма к начислению = итоговая сумма аренды со скидкой × процент ÷ 100. Дальше система защищается от двойного и неверного начисления:

• если по этой аренде клиент уже списывал бонусы — начисление за завершение не производится;
• если начисление по этой аренде уже было и его сумма не совпадает с пересчитанной — сумма приводится к правильной;
• если начисления ещё не было — создаётся новое.

Полное описание жизненного цикла бонусов, включая приветственный бонус и значения в карточке аренды: «Бонусы».

​

Бонусы: ручное списание на аренду

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

​

Списание бонусов на аренду

При списании:

1. проверяется, что у аренды выбран клиент (иначе — ошибка «не выбран клиент»);
2. находится или создаётся бонусный счёт клиента;
3. если счёт создаётся впервые и в настройках задан ненулевой приветственный бонус — на счёт зачисляется приветственная сумма;
4. вычисляется максимально допустимая сумма списания;
5. создаётся списание на эту сумму (бонусная транзакция с отрицательным знаком), привязанное к аренде;
6. запускается пересчёт дочерних сумм аренды.

Максимально допустимая сумма списания — это минимум из трёх величин:

​

Отмена списания

Отмена удаляет по аренде все бонусные списания (транзакции с отрицательной суммой) и запускает пересчёт дочерних сумм аренды. Приветственный или иной начисленный бонус (положительные транзакции) при этом не трогается — отменяется только то, что было списано на оплату.

​

Продвижение клиента по «отметкам» лояльности

Ещё один автоматический эффект сохранения — пересмотр «отметок» клиента (уровней/меток, привязанных к порогам по числу и сумме аренд). Он срабатывает только для завершённой аренды (и только если аренда не удалена и у неё есть клиент). Логика:

1. по клиенту считаются все его завершённые активные аренды — их количество и суммарная итоговая стоимость со скидкой;
2. подбираются все отметки, у которых задан порог по количеству аренд или по сумме, и чей порог уже достигнут клиентом (по количеству или по сумме);
3. эти отметки добавляются клиенту.

​

Реферальные вознаграждения агентам

За конкретную аренду можно зафиксировать вознаграждение реферальному агенту. Здесь описан только API-контур со стороны модуля аренды; полное определение сущности «Реферальное вознаграждение по аренде» и её жизненный цикл — на отдельной странице. Доступные операции: Ключевые правила создания и изменения (проверяются при валидации):

• новое вознаграждение всегда привязывается к аренде из адреса запроса; агент может быть не указан;
• если аренда уже завершена или отменена, создавать/менять вознаграждение нельзя — кроме случая, когда у пользователя есть право работать с завершёнными арендами (или он суперпользователь компании);
• текущий статус связанной аренды доступен в ответе только для чтения;
• перевод в статус «Выплачено» фиксирует время и пользователя, отметившего выплату.

Подробнее про сущность и её двойной учёт (по агентам и денежная строка аренды): «Рефералы».

​

Как это используется

• Настройте триггеры сообщений в мессенджере на нужные переходы статусов — тогда клиент будет получать уведомления автоматически при смене статуса аренды. Для мгновенных сообщений держите задержку до одной минуты.
• Держите у аренды заполненного клиента: без клиента не уйдут ни уведомления, ни автоматические бонусы, ни отметки лояльности.
• Автоматическое начисление бонусов «за аренду» происходит только в момент, когда аренда становится одновременно завершённой и полностью оплаченной. Ручное списание бонусов на оплату — отдельная операция и делается заранее, до завершения.
• Реферальные вознаграждения удобнее заводить до завершения/отмены аренды; после — потребуется специальное право.

​

Особенности поведения

• Приветственный бонус зачисляется только в момент первого создания бонусного счёта клиента при ручном списании; для уже существующего счёта приветственный бонус повторно не начисляется.
• Отмена списания бонусов удаляет все списывающие транзакции по аренде, но не трогает положительные начисления — то есть возвращает списанное, но не убирает начисленный приветственный/бонус.
• Автоматическое начисление бонусов за аренду происходит только когда статус одновременно «завершена» и оплата «оплачено»; если по аренде уже было ручное списание бонусов, автоматическое начисление за завершение пропускается.
• Отметки лояльности только добавляются клиенту по достижении порога (по количеству или сумме завершённых активных аренд) и никогда не снимаются автоматически.
• Реферальное вознаграждение нельзя создать или изменить по завершённой или отменённой аренде без права на работу с завершёнными арендами (или прав суперпользователя компании).
• Для реферальных операций просмотр списка и карточки требует лишь подключённой интеграции «аренда», а создание, изменение, удаление и отметка «Выплачено» — активной (не истёкшей) интеграции.
• В контекст уведомления и в перечень позиций попадают только «настоящие» позиции инвентаря; позиции, заменённые при обмене, из перечня исключаются.
• Уведомление о просрочке вызывает общую отправку с конкретным триггером, поэтому на него ограничение «только мгновенные триггеры» не распространяется.
• При пересохранении аренды без смены статуса лиды не создаются и не переносятся — у существующих лидов только обновляются сумма и клиент.
• Уведомления и воронка выполняются одной фоновой задачей, которая ставится в очередь после успешной фиксации изменений аренды; её сбой виден как упавшая задача, а не теряется в логе.
• Каждое сохранение аренды ставит свою задачу триггеров, поэтому сценарии, в которых аренда пересохраняется несколько раз за одну операцию (например, автопродление), могут приводить к повторным уведомлениям.

​

Связанные страницы