BonusPro программа бонусной лояльности
BonusPro — это виджет для OkoCRM, который добавляет в систему полноценную программу бонусной лояльности. С его помощью вы начисляете и списываете баллы клиентам, выдаёте промокоды, ведёте уровни кэшбэка и автоматически сжигаете старые бонусы.
Эта инструкция расскажет, как настроить программу с нуля, начать работать с клиентами и где смотреть историю.
Что внутри
1. Установка и первый запуск
2. Настройки программы
3. Уровни лояльности и кэшбэк
4. Промокоды
5. Подключение клиента к программе
6. Начисление, списание и корректировка баллов
7. Применение промокода к сделке
8. История операций контакта
9. Список всех участников
10. Сгорание бонусов и письма-предупреждения
1. Установка и первый запуск
BonusPro устанавливается из магазина приложений OkoCRM, как любой другой виджет. После установки в левом сайдбаре появляется фиолетовая иконка со звёздочкой — это вход на страницу управления программой. Иконка также появится в карточке каждой сделки и каждого контакта.

Перейдите по иконке в сайдбаре — откроется страница с четырьмя вкладками: Программа, Уровни, Промокоды, Участники. С них и начинается настройка.
2. Настройки программы
Откройте вкладку Программа. Здесь хранятся базовые параметры всей бонусной системы. Без них программа работать не начнёт.

Программа активна — главный переключатель. Если выключен, бонусы не начисляются и не списываются, письма не отправляются.
Название валюты — слово, которым в письмах клиентам называются ваши бонусы: «начислено 100 баллов», «у вас 500 спасибок». По умолчанию — баллов.
Макс. оплата бонусами (%) — какую долю заказа клиент может закрыть бонусами. Например, 30% означает, что при заказе на 1000 ₽ можно списать максимум 300 баллов.
Приветственные бонусы — сколько баллов получит клиент сразу после подключения к программе. Если поле пустое или 0 — приветственного начисления не будет.
Срок действия бонусов (дней) — через сколько дней начисленные баллы сгорают. Если оставить пустым, бонусы не сгорают никогда.
Предупреждать о сгорании за (дней) — за сколько дней до сгорания клиенту уйдёт письмо-напоминание. Полезно, если хотите подтолкнуть клиента к покупке.
Ниже идёт блок Уведомления клиентам — пять переключателей. Каждый отвечает за свой тип письма: при подключении, при начислении, при списании, при предупреждении о сгорании, при повышении уровня. Выключенный переключатель не отменяет операцию, а только не отправляет соответствующее письмо.
После любых изменений нажмите Сохранить настройки.
3. Уровни лояльности и кэшбэк
Уровни — это ступени программы, которые клиент проходит по мере покупок. У каждого уровня свой кэшбэк (процент от покупки, который клиент получит баллами) и порог оборота (сколько денег нужно потратить, чтобы получить этот уровень).
Перейдите на вкладку Уровни. Слева — форма создания, справа — список уже существующих уровней.

Чтобы добавить уровень, заполните Название (например Серебро), Порог оборота в рублях и Кэшбэк в процентах. Нажмите Добавить уровень.
Важно про стартовый уровень. Чтобы у клиентов сразу после подключения был кэшбэк (например, базовые 1%), создайте уровень с порогом 0. Все новые участники программы автоматически получат его при регистрации.
Уровень можно редактировать (карандаш) или удалить (корзина). При удалении уровня участники не теряют его — они остаются на нём, пока не повысятся естественным путём.
Уровень не понижается. Если клиент дошёл до Золота, он останется в Золоте, даже если перестанет покупать.
4. Промокоды
Вкладка Промокоды устроена так же, как Уровни: слева форма, справа список.

Промокоды бывают трёх типов:
Скидка % — снижает сумму заказа на указанный процент. Например, промокод SUMMER10 с типом Скидка % и значением 10 применит к заказу скидку 10%.
Скидка ₽ — снижает сумму заказа на фиксированную сумму. Например, минус 500 рублей.
Бонусы — начисляет клиенту фиксированное количество баллов на счёт. Используется для приветственных акций и подарков.
Поля формы:
Код — уникальная строка, которую клиент вводит при заказе. Лучше латиницей и капсом: WELCOME2026, BLACKFRIDAY.
Тип — один из трёх описанных выше.
Размер скидки / Сумма бонусов — числовое значение, зависит от типа.
Макс. использований — сколько раз промокод можно применить в сумме всеми клиентами. Если оставить пустым — без ограничений.
Действует до — дата, после которой промокод становится неактивным. Можно оставить пустым, тогда срока нет.
В списке справа у каждого промокода виден его статус: Активен (зелёный) или Неактивен (серый). Промокод становится неактивным, когда у него истёк срок или закончились использования.
5. Подключение клиента к программе
Откройте карточку любого контакта или сделки. В правом сайдбаре среди иконок виджетов будет иконка BonusPro — нажмите.
Если контакт ещё не подключён к программе, откроется небольшое окно с кнопкой Подключить к программе.

Нажмите кнопку. Контакт регистрируется, ему создаётся бонусный счёт, начисляются приветственные баллы (если они настроены) и присваивается стартовый уровень. На email клиента уйдёт письмо-приветствие.
После подключения окно сразу превращается в полноценную карточку участника программы.
6. Начисление, списание и корректировка баллов
В карточке участника сверху виден текущий баланс баллов, уровень, статистика «заработано / списано / оборот покупок». Под балансом — четыре кнопки действий: Начислить, Списать, Корректировка, Промокод.

Начислить открывает форму с двумя полями: Сумма бонусов и Сумма покупки.
Когда виджет открыт из карточки сделки, оба поля заполняются автоматически: сумма покупки = бюджет сделки, сумма бонусов = бюджет × кэшбэк уровня. Можно сразу нажать Начислить.
Когда виджет открыт из карточки контакта (без сделки), поля пустые — заполните вручную. Сумма покупки важна для пересчёта уровня: только она увеличивает суммарный оборот клиента и поднимает его на следующую ступень.
Списать — клиент тратит баллы. Форма принимает только сумму. Списание идёт по правилу FIFO: сначала уходят самые старые баллы, чтобы они не сгорели.
Корректировка — ручное изменение баланса со знаком + или −. Используйте, если нужно скомпенсировать ошибку или подарить баллы вне обычной логики. Корректировка не меняет статистику заработано/списано/оборот.
После каждого действия модалка обновляется: вы сразу видите новый баланс и операцию в истории внизу.
7. Применение промокода к сделке
Кнопка Промокод открывает форму с полями Промокод и Сумма заказа.

Введите код промокода (например WELCOME2026) и сумму заказа. Сумма заказа нужна, чтобы виджет посчитал размер скидки в процентах. Для типа Бонусы сумма заказа не используется.
После применения вы увидите уведомление с фактической суммой скидки или начисления. Использование промокода запишется в историю.
Промокод нельзя применить, если:
— он неактивен или просрочен;
— у него закончились использования;
— клиент уже использовал его максимальное количество раз;
— сумма заказа меньше минимальной для этого промокода.
8. История операций контакта
Под кнопками действий в карточке участника есть две вкладки: Операции и Промокоды.

Во вкладке Операции видны все начисления, списания, сгорания и корректировки. Каждая операция показывает тип, сумму, дату и комментарий, если он был.
Во вкладке Промокоды видны все применённые этим клиентом промокоды: код, тип скидки, фактическая сумма и дата.
Если операций или промокодов много, история разбивается по страницам — внизу появляются кнопки Назад и Вперёд.
9. Список всех участников
Вкладка Участники на главной странице виджета показывает всех клиентов, подключённых к программе.

Сверху два фильтра:
Уровень — показать только участников выбранного уровня.
Баланс — показать только тех, у кого есть баллы (или, наоборот, у кого баланс пустой).
В каждой строке: имя контакта, его уровень и текущий баланс. Клик по строке открывает карточку контакта — оттуда можно совершать любые операции.
10. Сгорание бонусов и письма-предупреждения
Если в настройках программы задан Срок действия бонусов, то каждое начисление имеет дату сгорания. Например, 180 дней с момента начисления.
Каждый день в 04:30 утра запускается фоновый процесс. Он находит все начисления, у которых истёк срок, и автоматически сгорает остаток. В истории клиента появляется операция типа Сгорание.
Если в настройках указано Предупреждать о сгорании за N дней, в это же утро уходит письмо тем клиентам, у которых через ровно N дней что-то сгорит. Письмо мотивирует потратить бонусы до даты сгорания.
Сгорание идёт FIFO: уходят самые старые бонусы первыми. Это значит, что активные клиенты, которые часто тратят, скорее всего ничего не теряют — у них старые баллы успеют уйти на покупки.
Подсказки и частые ошибки
«Уровень не присваивается» — проверьте, что при начислении заполняете поле Сумма покупки. Уровень рассчитывается по обороту покупок, а не по количеству начисленных баллов.
«У клиентов нет уровня после подключения» — создайте уровень с порогом 0. Он автоматически достанется всем новым участникам.
«Письма не приходят» — проверьте, что у контакта указан email и в настройках программы включён соответствующий тип уведомления.
«Промокод не применяется» — посмотрите статус промокода во вкладке Промокоды. Серая плашка Неактивен значит, что закончился срок или использования.
«Удалил уровень — а что с участниками?» — они остаются на нём как есть. Просто новые клиенты на этот уровень уже не попадут.