Подключение сайта к 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: его описание в разделе разработчика.