Общая логика интеграции

Контакт клиента не должен зависеть от генерации подборки. Марквиз или форма на Тильде сначала сохраняют заявку, а сервис подборок создаёт ссылку уже на странице результата.

1. Клиент проходит квиз и оставляет контакты.
2. Марквиз/Тильда сохраняет лид у себя и в CRM/Роистат, если они подключены.
3. Клиента переадресует на страницу /podborka-result.
4. Виджет результата обращается к нашему API и создаёт подборку из фидов/API.
5. Клиента автоматически переводит на брендированную страницу подборки.

Скрипт на посадку с Марквизом

Добавьте HTML-блок на страницу Тильды, где открыт квиз Марквиза. Скрипт создаёт служебный podborka_session_id и запоминает страницу, с которой пришёл клиент.

<script src="https://podborka.vercel.app/tilda-integration/marquiz-session.js"></script>

Этот скрипт лучше ставить в самый низ страницы перед закрытием </body> или в HTML-блок ниже квиза.

Webhook в Марквизе

В настройках квиза откройте Интеграции → Webhooks и добавьте адрес:

https://podborka.vercel.app/api/marquiz

Сейчас webhook работает как безопасное подтверждение: он всегда отдаёт успех и не может сломать отправку заявки. Подборка создаётся не в webhook, а на странице результата.

Редирект после отправки контактов

В Марквизе укажите редирект после успешной отправки заявки:

https://sozdateli-tmn.ru/podborka-result

Если Марквиз позволяет подставить поля формы в ссылку, используйте расширенный вариант:

https://sozdateli-tmn.ru/podborka-result?name={name}&phone={phone}&project=kedr&rooms=2&budget=9000000

Поддерживаемые параметры: name, phone, email, project, rooms, budget, payment. Комнатность можно передавать как rooms=2, двухкомнатная, двушка или евро-2.

Страница результата на Тильде

Создайте страницу https://sozdateli-tmn.ru/podborka-result и добавьте на неё HTML-блок:

<div data-podborka-marquiz-result></div>
<script src="https://podborka.vercel.app/tilda-integration/marquiz-result-widget.js"></script>

Виджет покажет “Формируем подборку”, создаст автоподборку на 3 планировки и переведёт клиента на страницу подборки.

Квиз или форма на Тильде без Марквиза

Если используется обычная форма или Zero Block-квиз на Тильде, после отправки ведите клиента на страницу результата с параметрами:

https://sozdateli-tmn.ru/podborka-result?name=Анна&phone=79990000000&project=kedr&rooms=2&budget=9000000

Если параметры не передать, сервис попробует определить ЖК по URL посадки, но имя клиента и точная комнатность могут не попасть в подборку.

Проверка после подключения

1. Откройте посадку в режиме инкогнито.
2. Пройдите квиз и оставьте тестовые контакты.
3. Убедитесь, что заявка ушла в Марквиз/CRM.
4. Проверьте, что открылась страница /podborka-result.
5. Через несколько секунд должна открыться подборка на /podborka.
6. В разделе “Аналитика” выберите “Автоподборки после квиза” и проверьте появление клиента после открытия подборки.