Заказчику

Эта инструкция — для бизнес-владельца проекта. Если вы тот, кто рисует карту в редакторе и решает, как будет выглядеть форма заявки — вы попали по адресу.

Что вы делаете и что отдаёте дальше

Ваша зона ответственности заканчивается там, где начинается сайт. Внутри редактора вы готовите проект и форму, после публикации получаете два готовых сниппета — и передаёте их вашему верстальщику. На самом сайте вы ничего не настраиваете.

flowchart LR
    A[Редактор SmartGenPlan] --> B[Опубликованный проект]
    B --> C[Slug + 2 сниппета]
    C --> D[Передать верстальщику]

Шаг 1. Подготовить проект

Откройте редактор (app.smartgenplan.ru), создайте проект, нарисуйте участки, проставьте статусы и цены. Сохраните и опубликуйте.

После публикации появляется slug — короткий идентификатор вида 87e641fd. Запишите его, он понадобится для обоих сниппетов.

Шаг 2. Настроить форму заявки

В редакторе откройте раздел настройки формы для проекта. Здесь вы решаете, как форма будет выглядеть на сайте посетителя и какие данные собирать.

Выбор режима работы

В форме есть два режима — простой и полный. Главное отличие — что происходит с данными посетителя.

Простой режимПолный режим

Когда выбрать: если вам не нужно собирать персональные данные на стороне платформы и вы хотите минимум юридической нагрузки.

Что собираем: имя, телефон, опционально комментарий.

Как отправляется: при клике на «Отправить» открывается почтовый клиент посетителя (Gmail, Яндекс.Почта, Outlook, или системный mailto). Посетитель сам отправляет письмо вам. Платформа SmartGenPlan ничего не сохраняет.

Что нужно от вас: - Указать email доставки (куда придут заявки) - Опционально — выбрать поля и брендинг (название проекта, цвет)

Юридика: персональные данные не собираются, согласие на обработку ПД не требуется. Регистрация в НЦЗПД (Беларусь) или Роскомнадзоре (Россия) не нужна.

Когда выбрать: если вы хотите собирать email посетителей, рассылать им предложения, и готовы оформить юридическую сторону работы с персональными данными.

Что собираем: имя, телефон, опционально email, опционально комментарий — плюс согласия на обработку ПД и (опционально) на маркетинговые рассылки.

Как отправляется: так же через почтовый клиент посетителя (платформа не хранит данные на серверах). Согласия фиксируются как обязательные чекбоксы перед отправкой.

Что нужно от вас: - Указать email доставки - Заполнить «Разрешённые домены» — список адресов, где форма имеет право работать (например, mysite.ru) - Указать ссылку на Политику обработки ПД на одном из разрешённых доменов - Опционально — текст согласия на маркетинг и ссылку на правила рассылок

Юридика: на сайте должна быть опубликована Политика обработки ПД. По законодательству нужно уведомить регулятора (НЦЗПД в Беларуси, Роскомнадзор в России) о сборе ПД.

Если вы выбрали «полный», но не заполнили разрешённые домены или политику — форма автоматически откатится в простой режим

Защита от ошибок: если требования полного режима не выполнены, форма работает как простая, без сбора согласий. Это безопаснее, чем показывать неполную юридическую обвязку.

Разрешённые домены — самое важное поле

«Разрешённые домены» — это список сайтов, на которых форма имеет право показываться. Платформа проверяет адресную строку браузера посетителя.

Состояние списка	Что произойдёт
Список пустой	Форма работает на любом сайте, куда её встроят
Список не пустой	Форма работает только на этих доменах. На остальных — заглушка с предложением перейти на сайт владельца

Когда заполнять список

Заполняйте, если хотите чтобы форма не работала на чужих сайтах (если кто-то скопирует ваш сниппет себе).

Не заполняйте, если хотите дать партнёрам возможность размещать карту с формой у себя без согласования.

В список вписывайте домен без https:// и без слэша в конце. Например: mysite.ru, kp-sosny.by. Поддомены пишите явно: pages.mysite.ru — это отдельная запись.

Поля и брендинг

В builder UI можно включить или выключить поля (email, комментарий, согласие на маркетинг), задать акцентный цвет и название проекта в шапке формы. Это влияет только на внешний вид — логика не меняется.

Шаг 3. Скопировать два сниппета

После публикации редактор показывает два готовых блока кода:

Сниппет карты:

<link rel="preconnect" href="https://embed.smartgenplan.ru">
<script src="https://embed.smartgenplan.ru/embed.js" data-slug="ВАШ_SLUG" async fetchpriority="high"></script>

Сниппет формы:

<div id="sgp-booking-form" data-slug="ВАШ_SLUG"></div>
<script src="https://forms.smartgenplan.ru/loader.js" async></script>

Где ВАШ_SLUG — идентификатор вашего проекта.

Шаг 4. Передать верстальщику

Отправьте верстальщику:

Оба сниппета (один блок текста)
Slug проекта (он уже зашит в сниппетах, но скажите явно — для проверки)
Если выбрали полный режим формы — список разрешённых доменов и URL Политики обработки ПД

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

Что вы НЕ настраиваете

Задача	К кому
Где на странице будет карта и форма	Верстальщик
Растягивание карты на всю ширину экрана	Верстальщик
Ширина iframe, высота, отступы	Верстальщик
Публикация Политики обработки ПД на сайте	Верстальщик
Если форма вообще не грузится (404, ошибки сервера)	Поддержка SGP

Частые случаи

Я добавил домен в разрешённые, но форма всё равно показывает заглушку

Проверьте: домен указан без https:// и без слэша в конце. Также: если ваш сайт открывается по www.mysite.ru, а в списке указано mysite.ru — добавьте в список ещё одну запись www.mysite.ru. Поддомены — отдельные записи.

Я переключил режим с простого на полный — а на сайте всё по-старому

После любого изменения настроек переопубликуйте проект. Сайты тянут кэш — при следующем открытии страницы посетитель увидит новую версию.

Хочу чтобы заявки приходили на несколько email

В простом режиме это решается на уровне почтового сервера: создаёте группу-рассылку (например, sales@mysite.ru пересылает на всех нужных). В настройках формы указываете групповой адрес.

Что если я хочу собрать заявки в CRM, а не получать на email?

Сейчас платформа поддерживает только отправку через почтового клиента посетителя. Интеграция с CRM (через webhook или API) на стороне платформы не реализована — это другой вид интеграции, обсудите с поддержкой SGP отдельно.