Интеграции: Tilda, Bazium и МойСклад

Раздел: Интеграции

В этом разделе настраиваются интеграции программы лояльности с внешними сервисами.

Интеграция с Tilda

Раздел: Интеграции → Tilda

1. Включение интеграции

1. Включите переключатель «Интеграционный API»
2. Выполните базовые настройки, предложенные на странице

2. Авторизация через email

Переключатель «Включить авторизацию через email в Tilda» добавляет дополнительный способ входа — по email.

По умолчанию в Tilda используется авторизация по номеру телефона (код подтверждения приходит в мессенджер).

После включения опции:

• авторизация по номеру телефона сохраняется
• дополнительно появляется возможность входа по email

⚠️ Работает только если у вас настроена почта
(см. настройка почты)

3. Визуальные настройки

Настройте:

• шрифты
• цвета
• внешний вид элементов

Важно:

• включите «Промокоды», если на сайте используются и бонусы, и промокоды
• при этом к одному заказу можно применить либо бонусы, либо промокод — одновременно использовать оба варианта нельзя

4. Настройка корзины

Выберите, как будет происходить начисление бонусов:

• Только списание (начисление вручную)
  Бонусы при заказе списываются автоматически, если клиент выбрал «Списать».
  Начисление бонусов за покупку выполняется вручную — например, во время обработки заказа менеджером.

• Списание и начисление автоматически
  И списание, и начисление бонусов происходят автоматически.

Как это работает:

Если клиент выбрал «Списать»:

• бонусы автоматически списываются с его счёта
• на оставшуюся сумму заказа также могут начисляться бонусы:
  • автоматически — если включено автоначисление
  • вручную — если автоначисление отключено

Если клиент выбрал «Копить»:

• бонусы не списываются
• бонусы за покупку:
  • начисляются автоматически
  • или вручную — в зависимости от выбранной настройки

⚠️ Блок «Webhook Tilda» пока пропустите — к нему вернёмся позже

5. Подключение скрипта

1. После настройки параметров нажмите «Сохранить»
2. Нажмите «Показать скрипт» → «Скопировать»
3. Перейдите в Tilda → страница, где расположена корзина (обычно это шапка или подвал сайта)
4. Добавьте блок «T123»
5. Вставьте скрипт и сохраните изменения

6. Настройка полей в корзине

В блоке корзины → «Контент» добавьте новое поле с типом «Скрытое поле», в имени переменной укажите слово "id" (без кавычек). Аналогичным образом добавьте скрытые поля: "balls", "type_operation", "sms_code".

Итоговый набор:

• id
• balls
• type_operation
• sms_code

Также добавьте поле «ПРОМОКОД», если его нет.

⚠️ Обратите внимание: поле «ПРОМОКОД» требуется в любом случае —
независимо от того, используются на сайте только бонусы или бонусы вместе с промокодами.

Сохраните изменения.

7. Настройка Webhook

1. Вернитесь на платформу b.bonus-bot.ru
2. Раздел: «Интеграции» → «Tilda» → «Webhook Tilda» нажмите «Перевыпустить токен»
3. Скопируйте токен

8. Настройка Webhook в Tilda

1. В Tilda перейдите в «Настройки сайта» → «Формы»
2. Найдите и откройте пункт «Webhook»

Укажите:

• Webhook URL:
  https://b.bonus-bot.ru/api/v1/integration/apply

• Параметры:

  • API method: HEADER
  • API name: X-Integration-Secret
  • API key: вставьте скопированный ранее токен

• Отметьте галочки:

  • передавать данные по товарам (массивом)
  • передавать externalid в товарах
  • отправлять данные в формате application/json
  • если в корзине используется онлайн-оплата, дополнительно включите опцию «Отправлять только после оплаты»

Нажмите «Добавить».

9. Подключение Webhook к корзине

1. Перейдите на страницу, где расположена корзина
2. Выделите блок корзины и откройте «Контент»
3. В разделе «Подключённые сервисы» включите webhook b.bonus-bot.ru/api/v1/integration/apply
4. Сохраните

10. Настройка промокодов

1. Перейдите в «Настройки сайта» → «Платежные системы»
2. Выберите «Промокоды»
3. Создайте промокод:
   • имя: BONUS
   • значение: 1
     (без процентов просто цифра)

⚠️ Обратите внимание: графа «Окончание» должна быть пустой

11. Отключение проверки скидок

1. «Настройки сайта» → «Платежные системы»
2. Найдите и нажмите «Настройки» под заголовком «Общие настройки для платежных систем»
3. Найдите «Уровень проверки скидки» → выбрать «Не проверять»
4. Сохранить

12. Подключение jQuery

1. «Настройки сайта» → «Вставка кода»
2. Включите «Подключить jQuery на страницах сайта»
3. Сохраните

13. Завершение настройки

1. Переопубликуйте все страницы сайта
2. Выполните тестовый заказ

Проверьте:

• корректность расчёта скидки
• списание бонусов
• начисление бонусов

Интеграция с Bazium

Раздел: Интеграции → Базиум

⚠️ Перед началом настройки убедитесь, что ваш тариф Базиум поддерживает использование промокодов.

1. Включение интеграции

1. Включите переключатель «Включить интеграционный API»
2. Укажите адрес админки проекта, его можно взять в Базиум в разделе «Профиль». Например myshop.bazium.ru

3. Укажите Email сотрудника Базиума и пароль. Рекомендуется создать отдельную учетную запись для подключения системы лояльности.
4. Нажмите кнопку «Сохранить»
5. Нажмите кнопку «Проверить подключение». Если подключение выполнено успешно, вы увидите подтверждающее сообщение.

6. Выполните базовые настройки, предложенные на странице.

2. Авторизация через email

Переключатель «Включить авторизацию через email в Базиуме» добавляет дополнительный способ входа — по email.

По умолчанию в Базиуме используется авторизация по номеру телефона (код подтверждения приходит в мессенджер).

После включения опции:

• авторизация по номеру телефона сохраняется
• дополнительно появляется возможность входа по email

⚠️ Работает только если у вас настроена почта
(см. настройка почты)

3. Визуальные настройки

Настройте:

• шрифты
• цвета
• внешний вид элементов

Важно:

• включите «Промокоды», если на сайте используются и бонусы, и промокоды
• при этом к одному заказу можно применить либо бонусы, либо промокод — одновременно использовать оба варианта нельзя

4. Настройка корзины

Выберите, как будет происходить начисление бонусов:

• Только списание (начисление вручную)
  Бонусы при заказе списываются автоматически, если клиент выбрал «Списать».
  За заказ со списанием бонусы не начисляются. За заказ с кнопкой «Копить» — начисляются автоматически.

• Списание и начисление автоматически
  В автоматическом режиме бонусы списываются, а на сумму, оплаченную деньгами, начисляются новые.

Как это работает:

Если клиент выбрал «Списать»:

• бонусы автоматически списываются с его счёта
• на оставшуюся сумму заказа также могут начисляться бонусы:
  • автоматически — если включено автоначисление
  • вручную — если автоначисление отключено

Если клиент выбрал «Копить»:

• бонусы не списываются
• бонусы за покупку начисляются автоматически

⚠️ Внимание: начисление и списание бонусов отображаются на балансе клиента только после подтверждения получения оплаты. Отображение операции может занять до 5 минут после подтверждения.

5. Подключение скрипта

1. После настройки параметров нажмите «Сохранить»
2. Вернитесь в начало страницы и нажмите «Код для сайта» → «Скопировать»

3. Перейдите в Базиум → «Настройки» → «Аналитика и интеграции»
4. В блоке «Дополнительные коды» вставьте скопированный код в поле «Body»
5. Нажмите кнопку «Сохранить»

6. Выполните тестовый заказ

Проверьте:

• корректность расчёта скидки
• списание бонусов
• начисление бонусов

Интеграция с МойСклад

Раздел: Интеграции → МойСклад

1. Откройте Bonus-Bot в МойСклад

Войдите в веб-интерфейс МойСклад и перейдите в раздел с решениями / приложениями. Найдите Bonus-Bot (или перейдите по ссылке: открыть в каталоге МойСклад) и нажмите «Установить» (или «Попробовать бесплатно»).

2. Привяжите магазин

В МойСклад нажмите «Перейти в решение» — откроется окно Bonus-Bot.

Выполните следующие действия:

• войдите, используя тот же email и пароль, что и в личном кабинете b.bonus-bot.ru
• выберите свой магазин
• нажмите «Сохранить и активировать»

3. Проверьте подключение

Вернитесь в личный кабинет b.bonus-bot.ru, перейдите в раздел «Интеграции» → «МойСклад». Если сообщение об успешном подключении не появилось, нажмите кнопку «Проверить снова».

💡 Подробная инструкция по настройке и работе с кассой МойСклад доступна по ссылке