Как настроить интеграцию с Tilda

Что настроим

Заказы из форм и корзины Тильды будут попадать в Рефсейлс сами — с составом, контактами покупателя и реферальным кодом партнёра, который привёл клиента.

Что нужно заранее

• Опубликованный сайт на Тильде с формой или корзиной.

• Платный тариф Тильды — Personal или выше. На бесплатном раздел «Часто используемые», где лежит Webhook, закрыт.

• Хотя бы один товар в Рефсейлс — иначе состав заказа не с чем сопоставить.

• Домен сайта в общих настройках магазина, если планируете проверять реферальные ссылки: без него тестовая ссылка не появится.

Получите адрес вебхука

Откройте раздел «Настройки», перейдите на вкладку «Интеграции» и выберите карточку «Tilda».

Карточка Tilda в разделе «Интеграции».

В блоке «Настройка интеграции» откройте шаг 1 «Webhook URL» и нажмите «Сгенерировать ключ». Адрес появится в поле «URL» — скопируйте его кнопкой справа. Секретный ключ уже встроен в адрес, отдельно его копировать не нужно.

Шаг 1: пока ключ не сгенерирован, адреса нет.

Вставьте адрес в Тильде

1. Откройте «Настройки сайта» и в блоке «Интеграции» выберите «Формы».

2. В разделе «Часто используемые» нажмите «Webhook».

Тильда: «Настройки сайта» → «Формы» → «Часто используемые».

1. Вставьте скопированный адрес в поле «WEBHOOK URL».

2. В поле «API name» впишите refsales.ru — под этим именем подключение будет видно в списке сервисов приёма данных.

3. Оставьте «API METHOD» в значении «Off» — ключ передаётся в самом адресе.

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

5. Нажмите «Подключить сервис ко всем формам на сайте».

6. Сохраните и опубликуйте страницу.

Последний шаг пропустить нельзя. Webhook подключается к сайту, но каждый блок формы сам решает, куда отправлять данные. Пока сервис не подключён к формам, Тильда будет отвечать покупателю «Данные успешно отправлены», а в Рефсейлс ничего не придёт. Если формы добавите позже, подключите сервис к ним тем же способом.

Диалог подключения Webhook. Галочки в «Дополнительных настройках» разберём ниже.

В «Дополнительных настройках» включите три галочки:

• Посылать Cookies

• Передавать данные по товарам в заказе — массивом

• Отправлять данные в виде application/json

А вот «Отправлять только после оплаты» оставьте выключенной, если хотите видеть заказ сразу при оформлении. С этой галочкой заказ придёт в Рефсейлс только после оплаты.

Подключите реферальный код

Этот шаг нужен, чтобы Рефсейлс понимал, какой партнёр привёл покупателя. Без него заказы будут приходить, но без привязки к партнёру.

Скопируйте скрипт из шага 2 «Реферальный код» кнопкой «Скопировать код». В Тильде откройте «Настройки сайта» → «Вставка кода», найдите блок «HTML-код для вставки внутрь HEAD» и нажмите «Редактировать код».

Тильда: «Вставка кода» → «HTML-код для вставки внутрь HEAD».

Скрипт подгружается с наших серверов — вставьте его один раз, обновления применятся сами.

Затем добавьте скрытое поле в корзину:

1. Откройте страницу с корзиной и наведите курсор на блок ST100 — он подписан «Корзина с формой заказа». Панель блока появляется только при наведении.

2. Нажмите «Контент».

3. Перейдите в «Поля для ввода».

4. Нажмите «Добавить поле для ввода».

5. В типе поля выберите «Скрытое поле».

6. В имени переменной укажите refcode.

7. Нажмите «Сохранить и закрыть».

8. Переопубликуйте страницу.

Панель блока ST100: кнопка «Контент» появляется при наведении на блок.

Имя поля можно скопировать в Рефсейлсе кнопкой «Скопировать имя» — в сопоставлении полей оно уже предзаполнено.

Отправьте тестовый заказ

1. Оформите тестовый заказ на сайте.

2. Вернитесь на страницу интеграции и раскройте шаг 3 «Тестовый заказ».

3. Нажмите «Проверить получение данных».

Когда данные придут, Рефсейлс покажет, сколько полей получено и как они называются.

Полученные поля: по ним дальше собирается сопоставление.

Если структура формы в Тильде потом изменится, нажмите «Сбросить полученные поля» и отправьте тестовый заказ заново.

Сопоставьте поля

Откройте шаг 4 «Настройка полей». Слева — что нужно Рефсейлсу, справа — поля вашей формы. Совпадающие поля подставляются сами: имя, почта, телефон, сумма, refcode. Проверьте их и нажмите «Сохранить настройки полей» — до сохранения сопоставление не действует.

Состав заказа сопоставлять не нужно: он берётся автоматически из payment.products.

В шаге 5 «Обработка нового заказа» выберите, в каком статусе создавать заказы из Тильды. Если не выбирать, используется «Новый».

Как проверить, что работает

1. Оформите заказ на сайте.

2. Откройте раздел «Заказы» — заказ появится в выбранном статусе.

3. Откройте заказ и убедитесь, что состав и контакты на месте.

Если проверяете партнёрскую ссылку, откройте сайт по тестовой ссылке из шага 2 «Реферальный код» и оформите заказ через неё. Ссылка работает только на самом сайте Тильды — на поддомене Рефсейлс скрипт не подключён.

Если не работает

• Заказы не приходят вообще. Страница в Тильде не опубликована: вебхук отправляется только с опубликованной страницы. Опубликуйте её и оформите заказ ещё раз.

• Тильда сообщает об ошибке доступа. В адресе нет секретного ключа или он устарел. Вернитесь в шаг 1, скопируйте адрес заново и вставьте его в Тильде.

• Перегенерировали ключ — заказы перестали приходить. Старый адрес перестаёт работать сразу. Скопируйте новый и замените его в Тильде.

• Покупатель видит «Данные успешно отправлены», а заказа нет. Чаще всего сервис не подключён к формам: одного «Добавить» недостаточно. Откройте подключение Webhook и нажмите «Подключить сервис ко всем формам на сайте».

• Заказа нет, а сервис к формам подключён. Проверьте, что адрес скопирован целиком, вместе с частью после вопросительного знака. При опечатке в адресе магазина Тильда получает успешный ответ, а заказ никуда не сохраняется.

• Заказы шли и прекратились. Проверьте переключатель «Состояние интеграции» на странице Tilda. Когда он выключен, запросы принимаются, но заказы не создаются.

• Часть заказов теряется на распродаже. Приём ограничен 30 запросами в минуту на магазин. Тильда получит отказ и повторит попытку позже.

• Заказ пришёл без товаров. Состав берётся из payment.products, а его присылает корзина. Если заказ пришёл из обычной формы без корзины, товаров в нём не будет. Проверьте также галочку «Передавать данные по товарам в заказе — массивом».

• Заказ есть, партнёр не определился. Скрытое поле refcode не добавлено в корзину или скрипт не вставлен в HEAD. В шаге 2 видно, найдено ли поле в последнем полученном заказе.

• В Тильде нет раздела «Часто используемые». Он доступен на платных тарифах Тильды. Проверьте тариф в разделе «Тарифы и оплата».

Частые вопросы

Тильда пишет «Данные успешно отправлены», а заказа в Рефсейлс нет. Почему?

Сервис не подключён к формам: кнопки «Добавить» недостаточно. Откройте подключение Webhook и нажмите «Подключить сервис ко всем формам на сайте».

Нужно ли включать галочки в диалоге вебхука Тильды?

Включите «Посылать Cookies», «Передавать данные по товарам в заказе — массивом» и «Отправлять данные в виде application/json». «Отправлять только после оплаты» оставьте выключенной, иначе заказ придёт не при оформлении, а после оплаты.

Что произойдёт, если перегенерировать секретный ключ?

Старый адрес вебхука перестанет работать сразу. Скопируйте новый адрес и замените его в настройках Тильды.

Обязательно ли подключать реферальный код?

Нет. Без него заказы будут приходить, но без привязки к партнёру, который привёл покупателя.

Меняется ли адрес вебхука при смене тарифа Рефсейлс?

Нет. Адрес зависит только от поддомена магазина и секретного ключа.