Recca Разработчикам
Меню

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 стоит на всех страницах, включая ту, где форма.

Если клиента привёл участник программы, а код не доехал (скажем, клиент позвонил), укажите привёдшего руками: в строке заявки нажмите «Указать, кто привёл». Это можно сделать до подтверждения покупки.

Что видно в заявке с сайта

Имя, телефон и почта с формы стоят в строке заявки. Всё остальное, что прислала форма (комментарий, дополнительные поля, адрес страницы), открывается по ссылке «Данные формы» под контактом.

Если при подключении в списке была заявка без имени и телефона — это проверочная отправка конструктора, а не клиент. Такие отправки больше не становятся заявками; старую можно перевести в «Отказ».