Решение проблем

Диагностика типичных проблем — карта, форма, источники данных, ошибки доступа. Симптомы сгруппированы по разделам, для каждого описано что проверить и где починить.

Карта на сайте

Карта не загружается / белый прямоугольник

Откройте DevTools → Network на странице с картой.
Найдите запрос iframe на embed.smartgenplan.ru/p/<slug> (этот хост — стабильный фасад для embed-сниппета).
Если 404 — slug в коде не совпадает с тем что выдал редактор. Уточните у заказчика свежий slug, замените в data-slug=.
Если 200, но карта не появляется — проверьте консоль на ошибки CSP/CORS. Может конфликтовать политика безопасности сайта (например, Tilda с строгим CSP).

Карта обрезана с боков

В Tilda Zero Block с картой откройте «Параметры блока» → «Ширина» → выберите «All width» (вся ширина окна браузера). Стандартный «1200px» обрезает карту по бокам на широких экранах. Подробнее — Tilda.

Кнопка «развернуть на весь экран» не работает

Ваш сайт использует Lenis или другую smooth-scroll библиотеку, которая конфликтует с фуллскрин-режимом карты. Решение — добавить атрибут data-fullwidth="false" к контейнеру карты, фуллскрин отключится но базовая навигация (zoom, перетаскивание, клик по участку) сохранится. См. Tilda → smooth-scroll.

Меняю CSS на сайте, но внутри карты ничего не меняется

Карта живёт внутри <iframe> — её внутренние стили недоступны снаружи. Влиять можно только на размер и положение самого iframe (через атрибуты embed-скрипта или CSS родительского контейнера). Это особенность iframe-изоляции, не баг.

Форма бронирования

Форма пишет «Бронирование принимается на сайте владельца проекта»

Текущий домен сайта не входит в список разрешённых. Сравните window.location.hostname (адрес в браузере) со списком, который дал заказчик. Если домен правильный — попросите заказчика проверить запись в редакторе → Интеграции → Форма заявок → Разрешённые домены (с www или без, регистр, опечатки).

Форма пишет «Форма не настроена»

Заказчик не включил публикацию формы для этого проекта. Передайте симптом — нужно зайти в редактор → Интеграции → Форма заявок → активировать публикацию + указать email доставки → переопубликовать.

Заявки не доходят на email

Проверьте папки «Спам» / «Промоакции» / «Уведомления» — особенно для Gmail и Яндекс.Почты.
Проверьте email в настройках — редактор → Интеграции → Форма заявок → поле email доставки. Опечатка в адресе = заявки уходят в никуда.
Отправьте тестовую заявку через свою же опубликованную форму. Если приходит — основной поток работает, проблема была в конкретной заявке (возможно её отвергли спам-фильтры из-за подозрительного содержимого от посетителя).

Кнопка действия на участке

Кнопка «Забронировать» не появляется в попапе

Откройте редактор → Публикация → Кнопка действия — включена ли она вообще.
Проверьте режим:
«Открыть страницу» — должен быть указан URL. Без URL кнопка не показывается.
«Telegram-бот / чат / канал» — должен быть указан @username. Без него кнопка не показывается.
WhatsApp / Viber / Звонок — должен быть указан номер телефона.
Проверьте галку «Скрыть при недоступном статусе» — если она включена и участок имеет статус «Продан» / «Забронирован» / «Недоступен» — кнопка корректно прячется. Это не баг.

URL в кнопке открывается без подстановленных параметров

В URL должны быть placeholder'ы вида {number}, {area}, {price} — они подставляются runtime'ом. Если в URL стоят буквальные {number} (без замены) на стороне получателя — значит фрагмент URL вставлен до того как он прошёл через embed.js. Проверьте что URL берётся через placeholder, не по-копирован вручную.

См. Кнопка действия → переменные.

Источники данных

Google Sheets / Яндекс.Диск — таблица не подгружается

Проверьте формат ссылки. Для Яндекс.Диска нужна публичная ссылка (/i/...) из меню «Поделиться», не сессионная (/edit/d/... из адресной строки браузера).
Проверьте права доступа. Google Sheets → «Все, у кого есть ссылка» → «Редактор». Яндекс.Диск → «Просмотр» (минимум).
Yandex.Disk — задержка до 5 минут. После сохранения правок в онлайн-редакторе данные могут подтягиваться с задержкой — это особенность их CDN. Если открыли SmartGenPlan-редактор сразу после правки — подождите минуту, обновите страницу.
«Доступ закрыли» — в редакторе → Интеграции появится предупреждение, если ссылка перестала работать.

AmoCRM — статус не обновляется на карте после перетаскивания сделки

Поле «Номер участка» в сделке заполнено? Без него webhook игнорируется. Это самая частая причина.
Уже открытая вкладка с картой — мгновенное обновление работает для новых посетителей, на уже открытых вкладках статус подтянется только после перезагрузки страницы.
Webhook отвергается — возможно ключ доступа отозван. Перегенерируйте: редактор → Интеграции → Для разработчиков → отзовите старый ключ, сгенерируйте новый, обновите URL в AmoCRM.

REST API — webhook возвращает ошибку

Код	Что это значит	Что делать
401 Unauthorized	Ключ доступа неверный или отозван	Перегенерируйте ключ в редакторе → Для разработчиков. Старый ключ перестаёт работать сразу после генерации нового.
403 Forbidden	URL соответствует другому проекту или ключ от другого проекта	Проверьте что адрес и ключ — оба от одного и того же проекта. Адрес индивидуален для проекта.
400 Bad Request	Формат тела запроса неверный	Тело должно быть JSON со списком `updates`, каждое — `{plotNumber, status}`. См. API.
404 Not Found	Неверный URL или slug	Скопируйте «Адрес для обновлений» из редактора заново.

Иконки инфраструктуры

При наведении на иконку (школа / парк) — подсказка не показывается

В редакторе → Публикация → Инфраструктура: Метка и Окно проверьте галку «Показать метку при наведении». Если выключена — на иконках при наведении ничего не показывается, только при клике появляется попап.

При клике на иконку — попап не открывается

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

Где взять помощь дальше

Если симптом не описан здесь — напишите через форму обратной связи на главной smartgenplan.ru или email info@smartgenplan.by.
В сообщении укажите: ID проекта (виден в адресной строке редактора), URL опубликованной карты, симптом, и что вы уже проверили.
Для разработчиков с API-интеграцией — приложите тело запроса, который не работает, плюс код ответа.