Recca Поддержка
Меню

Подключение сайта к Recca: Tilda, webhook и SDK

Как подключить сайт к партнёрской программе Recca: заявки с форм Tilda через webhook, партнёрский код и приём конверсий постбэком.

Подключить сайт к партнёрской программе — значит, чтобы Recca узнавала о заявках и продажах, которые привели партнёры, и могла связать их с партнёром. Есть два пути: приём заявок с форм сайта на конструкторе (в этой статье подробно разобрана Tilda, webhook и партнёрский код на сайте) и приём результатов от вашего сервера постбэком.

Какой путь выбрать

Ваша ситуацияПуть
Сайт на Tilda, нужны заявки с формwebhook формы (эта статья)
Есть CRM или сервер, нужны подтверждённые продажипостбэк, раздел разработчика
Нужно управлять сетью программноSDK и API, раздел для разработчиков

Если в кабинете «Подключение сайта» показано с замком, эта функция для вашей организации сейчас недоступна.

Подключение формы на Tilda

Человек заполняет форму на вашем сайте, и заявка появляется в Recca в разделе «Заявки». Если он пришёл по ссылке партнёра, к заявке прикрепляется код партнёра. Часть работы идёт в Recca, часть в панели Tilda: держите обе вкладки открытыми.

Порядок в Tilda важен: приёмник заводится в настройках сайта, и только потом его можно отметить у формы.

Шаг 1. Создайте интеграцию в Recca

В кабинете откройте «Интеграции» → «Подключение сайта» и нажмите «Создать интеграцию». В поле «Платформа» выберите Tilda, в «URL вебсайта» укажите адрес сайта, в «Название» — любое имя. Оба поля помечены «опционально», но адрес сайта лучше заполнить: из него Recca берёт, куда вести людей по реферальным ссылкам. Если интеграции с сайтом нет или её адрес пуст, ссылки партнёров ведут на витрину в Recca, а не на ваш сайт.

После сохранения Recca один раз покажет токен вида rec_tilda_…. Скопируйте его сразу: в карточке интеграции остаётся только его окончание, а потерянный токен перевыпускается кнопкой «Сменить токен» (старый после этого перестаёт работать). В карточке рядом с токеном виден и «Адрес для заявок».

Шаг 2. Заведите приёмник в настройках сайта

В 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). В адресе его передавать нельзя, потому что адрес попадает в журналы серверов: такой запрос получит MISSING_TOKEN.

Шаг 3. Включите Webhook у формы

Откройте страницу с формой, кликните по блоку формы, перейдите в «Контент» и отметьте Webhook среди сервисов приёма данных. Сохраните и опубликуйте страницу. Пройдите так по каждой странице с формой: если не отметить, заявки с неё не придут, и Recca об этом не узнает.

Шаг 4. Добавьте скрытые поля

В блоке формы добавьте два поля типа «Скрытое поле»: recca (код партнёра) и Promo (промокод, если вы их используете). Имена важны: Recca ищет именно эти. Остальные поля формы, такие как Name, Phone, Email и Comment, Recca понимает сама.

Шаг 5. Поставьте скрипт на все страницы

Скрипт переносит код партнёра из адреса в скрытое поле и запоминает его в cookie на 30 дней, пока человек ходит по сайту. Без него код потеряется на первом же переходе с лендинга на страницу с формой.

Готовый текст скрипта и все шаги — в разделе разработчика. Вставьте его в «Настройки сайта» → «Вставка кода», в блок для HEAD, сохраните и переопубликуйте страницы. Менять в нём ничего не нужно: токена в нём нет.

Шаг 6. Проверьте

Откройте сайт по настоящей ссылке участника программы и отправьте форму. Придуманный код не подойдёт: Recca не найдёт такого партнёра, и заявка придёт без него. Всё сошлось, если заявка появилась в разделе «Заявки», в карточке интеграции обновилось «Последнее использование», а у заявки видно партнёра (иначе в строке стоит «Без партнёра»). Последний пункт главный: он показывает, что код партнёра доехал.

Если заявки не приходят

Recca отвечает Tilda кодом ошибки (при ошибке токена — HTTP 401), и по нему видно, где порвалось.

КодЧто значитЧто делать
MISSING_TOKENтокен не дошёлпроверьте, что имя ключа ровно X-Recca-Token
INVALID_TOKENтокен не тотвозможно, скопирован с пробелом или от другой интеграции
TOKEN_REVOKEDинтеграцию отозвалисоздайте новую и замените токен в Tilda
PARSE_ERRORне удалось разобрать присланные данныечаще всего webhook повешен не на форму

Если заявка приходит, а партнёр в ней не виден, дело в коде партнёра. Проверьте, что скрытое поле называется ровно recca и скрипт из шага 5 стоит на всех страницах, включая ту, где форма. Если клиента привёл участник программы, но код не доехал, укажите привёдшего руками: в строке заявки нажмите «Указать, кто привёл». Кнопка есть у владельца и только у заявок без партнёра, пока заявка не подтверждена и не отклонена.

Если у вас не Tilda

Результаты продаж принимаются постбэком: ваш сервер или CRM сообщает сети о подтверждённом заказе. Подробнее — в разделе разработчика. Тем, кто управляет сетью программно, подойдёт Go SDK: его описание в разделе разработчика.