Интеграции

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

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

Интеграция с 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. Завершение настройки

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

Проверьте:

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

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

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

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

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

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

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

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

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

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

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

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