Creatium + Recca

Настройка интеграции: 3 шага

Важно: приём заявок из Creatium временно недоступен. Recca принимает токен интеграции только в заголовке запроса — X-Recca-Token или Authorization: Bearer. Передача токена в адресе (?token=…) больше не поддерживается: адрес целиком попадает в журналы серверов, а с ним и токен. У webhook Creatium, по нашим данным, нет поля для заголовков, поэтому подключить форму Creatium к Recca сейчас нельзя. Мы не предлагаем обходных путей: рабочего способа пока нет. Если вы настраивали Creatium по прежней инструкции, заявки с адресом ?token= Recca отклоняет с ошибкой MISSING_TOKEN.

Шаги ниже описывают порядок настройки на случай, когда способ передачи токена в заголовке для Creatium появится.

---

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

1. Откройте app.recca.ru и войдите в аккаунт
2. Перейдите в Профиль → Интеграции
3. Нажмите «Добавить интеграцию»
4. Выберите провайдер Creatium
5. Сохраните токен интеграции — он передаётся только в заголовке

Адрес приёма заявок один:

https://api.recca.ru/hooks/leads

Токен передаётся заголовком X-Recca-Token: ВАШ_ТОКЕН (или Authorization: Bearer ВАШ_ТОКЕН). Добавлять токен к адресу нельзя.

---

Шаг 2. Настройте webhook в Creatium

1. Войдите в панель управления Creatium
2. Откройте свой сайт → Настройки сайта → Интеграции
3. Найдите раздел Webhooks (или «Уведомления на URL»)
4. Укажите адрес приёма заявок из Шага 1 и заголовок с токеном — если ваша версия Creatium позволяет задать заголовок запроса
5. Убедитесь, что webhook настроен на событие «Новая заявка»
6. Сохраните настройки

Если в вашей версии Creatium поля для заголовка нет, подключить форму не получится: токен в адресе Recca не принимает.

---

Шаг 3. Добавьте скрипт отслеживания реферала

Чтобы заявки корректно привязывались к партнёру-рекомендателю, добавьте JavaScript-сниппет в head вашего сайта.

Зачем это нужно: когда пользователь переходит на ваш сайт по реферальной ссылке (например, https://ваш-сайт.ru/?recca=ABC123), код партнёра находится в URL. Но при переходе на другую страницу сайта этот параметр теряется. Скрипт сохраняет код и автоматически добавляет его в форму.

Как добавить:

1. В панели Creatium откройте Настройки сайта → Код в head
2. Вставьте этот скрипт:

<script>
(function(){
  var p = new URLSearchParams(location.search);
  var c = p.get('recca');
  if(c) localStorage.setItem('recca_code', c);
  document.addEventListener('submit', function(e){
    var code = localStorage.getItem('recca_code');
    if(!code) return;
    var f = e.target;
    if(!f.querySelector('[name="recca"]')){
      var h = document.createElement('input');
      h.type='hidden'; h.name='recca'; h.value=code;
      f.appendChild(h);
    }
  }, true);
})();
</script>

3. Сохраните изменения

---

Как это работает

1. Партнёр делится ссылкой на ваш сайт: https://ваш-сайт.ru/?recca=ABC123
2. Посетитель переходит по ссылке — скрипт сохраняет код ABC123
3. Посетитель заполняет форму на любой странице сайта
4. Creatium отправляет webhook в Recca с данными формы + кодом партнёра
5. Recca создаёт заявку, привязывает к партнёру, отправляет уведомления

---

Поддерживаемые поля форм

Recca автоматически распознаёт стандартные поля Creatium:

Поле формы	Варианты имён
Имя	name, Имя, Представьтесь, ФИО
Телефон	phone, Номер телефона, Телефон
Email	email, Электронная почта, Почта, E-mail
Комментарий	comment, Комментарий, Сообщение

Названия полей на русском и английском поддерживаются автоматически — специальная настройка не нужна.

---

Проверка интеграции

После настройки отправьте тестовую заявку через форму на сайте:

1. Откройте сайт по НАСТОЯЩЕЙ ссылке участника программы — своей или любого партнёра из раздела «Рефералы» (придуманный код Recca не узнает, и заявка придёт без партнёра)
2. Перейдите на страницу с формой
3. Заполните и отправьте форму
4. Проверьте раздел «Заявки» в Recca — новая заявка должна появиться с пометкой источника