Tilda: подключение сайта и приём заявок
Подключение сайта на Tilda: форма заявки и подтверждение оплаты.
Человек заполняет форму на вашем сайте — заявка появляется в Recca во вкладке «Лиды». Если он пришёл по ссылке партнёра, к заявке прицепится код партнёра, и вознаграждение посчитается само.
Работа идёт в двух местах: часть в Recca, часть в панели Tilda. Держите обе вкладки открытыми — на втором шаге они понадобятся одновременно.
Порядок в панели Tilda важен: приёмник заводится в настройках сайта, и только потом его можно отметить у формы. В обратную сторону не выйдет — в блоке формы он появится лишь после того, как создан.
«Подключение сайта» входит в продукт «Витрина Pro» и выше. На бесплатном уровне раздел виден с замком.
Шаг 1. Создайте интеграцию в Recca
В кабинете своей ноды откройте «Интеграции» → «Подключение сайта» и нажмите «Создать интеграцию».
- Платформа — Tilda
- URL вебсайта — адрес вашего сайта, например
https://example.ru - Название — любое, чтобы отличать интеграции друг от друга
- Маппинг форм → предложений — если форм несколько и каждая про своё предложение
Адрес сайта заполните обязательно, хотя поле и помечено как необязательное. Из него Recca берёт, куда вести людей по реферальным ссылкам: оставите пустым — ссылки ваших партнёров поведут на витрину в Recca, а не на ваш сайт.
После сохранения Recca один раз покажет токен вида rec_tilda_….
Скопируйте его сразу: второй раз посмотреть его нельзя — потерянный токен
только перевыпускается.
Шаг 2. Заведите приёмник в настройках САЙТА
Сервис приёма данных создаётся один раз на весь сайт — и только после этого появляется у формы. Пока он не создан, в блоке формы отмечать нечего: списка с Webhook там просто нет. Поэтому сначала настройки сайта, а форма — следующим шагом.
В панели Tilda откройте «Настройки сайта» → «Формы» и выберите в списке сервисов приёма данных Webhook.
- Адрес скрипта (Webhook URL) —
https://api.recca.ru/hooks/leads - Метод передачи ключа (API Method) — в заголовках,
HEADER - Имя ключа (API Name) —
X-Recca-Token - Значение ключа (API Key) — токен из шага 1
Английские подписи в скобках — на случай, если панель у вас на английском: поля те же самые.
Нажмите «Добавить» — сервис появится в списке. Ничего больше на этом шаге не происходит: заявки пойдут после того, как вебхук будет отмечен у формы.
Токен принимается только в заголовке (X-Recca-Token или
Authorization: Bearer). Передать его в адресе нельзя: адрес целиком попадает
в журналы серверов, а с ним и токен, поэтому Recca такие запросы отклоняет. Если
полей для ключа в вашей версии панели нет, напишите в поддержку — подскажем, как
подключить форму.
Шаг 3. Включите Webhook у формы
Теперь он есть в списке. Откройте страницу с формой, кликните по блоку формы, перейдите в «Контент» и отметьте Webhook среди сервисов приёма данных. Сохраните и опубликуйте страницу.
Пройдите так по каждой странице с формой. Не отметили — заявки с неё просто не придут, и Recca об этом не узнает. Если панель предложит добавить сервис сразу ко всем формам сайта — соглашайтесь, это то же самое одним движением.
Шаг 4. Добавьте скрытые поля в форму
В блоке формы добавьте два поля типа «Скрытое поле»:
recca— сюда попадёт код партнёра из ссылкиPromo— сюда попадёт промокод, если вы их используете
Имена полей важны: Recca ищет именно эти. Заполнять их руками не нужно — это сделает скрипт из следующего шага.
Остальные поля формы Recca понимает сама: Name, Phone, Email,
Comment, а также русские «Имя», «ФИО», «Телефон», «Номер телефона».
Шаг 5. Поставьте скрипт на все страницы
Скрипт переносит код из адреса в скрытое поле и помнит его в cookie, пока человек ходит по сайту. Без него код потеряется на первом же переходе с лендинга на страницу с формой.
Вставьте его один раз в «Настройки сайта» → «Вставка кода» → блок «HTML-код для вставки внутрь HEAD» → кнопка «Редактировать код». Оттуда он действует сразу на всех страницах сайта. Не забудьте «Сохранить изменения» вверху справа и переопубликовать страницы.
<script>
function getUrlParameter(name) {
var regex = new RegExp('[\\?&]' + name + '=([^&#]*)');
var results = regex.exec(location.search);
return results === null ? '' : decodeURIComponent(results[1].replace(/\+/g, ' '));
}
function setCookie(name, value, days) {
var date = new Date();
date.setTime(date.getTime() + days * 24 * 60 * 60 * 1000);
document.cookie = name + '=' + encodeURIComponent(value) + '; expires=' + date.toUTCString() + '; path=/; SameSite=Lax';
}
function getCookie(name) {
var match = document.cookie.match(new RegExp('(^| )' + name + '=([^;]+)'));
return match ? decodeURIComponent(match[2]) : '';
}
window.addEventListener('DOMContentLoaded', function() {
var promo = getUrlParameter('promo');
var recca = getUrlParameter('recca');
if (promo) setCookie('recca_promo', promo, 30);
if (recca) setCookie('recca_ref', recca, 30);
promo = promo || getCookie('recca_promo');
recca = recca || getCookie('recca_ref');
function fillFields() {
if (promo) {
var f = document.querySelector('input[name="promo"]') || document.querySelector('input[name="Promo"]');
if (f) f.value = promo;
}
if (recca) {
var f = document.querySelector('input[name="recca"]');
if (f) f.value = recca;
}
}
fillFields();
new MutationObserver(function() { fillFields(); }).observe(document.body, { childList: true, subtree: true });
});
</script>
Менять в нём ничего не нужно: токена он не содержит и наружу ничего не отправляет — только запоминает код партнёра из адреса и подставляет его в скрытое поле перед отправкой формы.
Шаг 6. Проверьте, что всё сошлось
Возьмите НАСТОЯЩУЮ ссылку участника программы — свою или любого партнёра из раздела «Рефералы» — откройте по ней сайт и отправьте форму.
Придуманный код в адресе проверку не пройдёт: Recca не найдёт такого партнёра, и заявка придёт без партнёра — ровно так, будто связка не работает, хотя она исправна.
Сошлось, если:
- заявка появилась в Recca во вкладке «Лиды»;
- в карточке интеграции обновилось «Последнее использование»;
- у заявки видно, кто привёл клиента.
Последний пункт — главный: первые два значат лишь, что заявка доехала, и только третий — что доехал свидетель, ради которого всё и делалось.
Если заявки не приходят
Recca отвечает Tilda кодом ошибки, и по нему видно, где порвалось:
- MISSING_TOKEN — токен не дошёл. Проверьте
API Name: должно быть ровноX-Recca-Token. - INVALID_TOKEN — токен не тот. Скорее всего скопирован с пробелом по краям либо от другой интеграции.
- TOKEN_REVOKED — интеграцию отозвали в Recca. Создайте новую и замените токен в Tilda.
- INVALID_PAYLOAD — Tilda прислала не то, что ожидалось. Чаще всего это значит, что webhook повешен не на форму.
- OFFER_NOT_FOUND — заявка пришла, но непонятно, к какому предложению её отнести. Проверьте маппинг форм на шаге 1.
Заявка приходит, а партнёр в ней не виден — дело не в webhook, а в коде:
проверьте, что скрытое поле называется ровно recca и что скрипт из шага 5
стоит на всех страницах, включая ту, где форма.
Если клиента привёл участник программы, а код не доехал (скажем, клиент позвонил), укажите привёдшего руками: в строке заявки нажмите «Указать, кто привёл». Это можно сделать до подтверждения покупки.
Что видно в заявке с сайта
Имя, телефон и почта с формы стоят в строке заявки. Всё остальное, что прислала форма (комментарий, дополнительные поля, адрес страницы), открывается по ссылке «Данные формы» под контактом.
Если при подключении в списке была заявка без имени и телефона — это проверочная отправка конструктора, а не клиент. Такие отправки больше не становятся заявками; старую можно перевести в «Отказ».