Своя форма записи на Тильде

Пять экранов на вашей странице: формат встречи, дата, время, контакты и подтверждение. Посетитель записывается, не уходя с сайта.

15 минутХватит публичного ключа

Это тот самый блок, который вы вставите себе. Он работает прямо здесь: выберите формат, дату и время — запись уйдёт в Планёрку.

Нужен публичный ключ

Форма ходит в Планёрку напрямую из браузера, поэтому ключ вписывается прямо в код блока. Заведите ключ со скоупом «публичный для сайта» — он умеет только показывать типы встреч, отдавать свободное время и создавать записи, и работает лишь с адресов, которые вы ему разрешили. Что это за скоуп и почему такой ключ не страшно держать на странице, разобрано в рецепте «Ключи API и их права».

01Форматсписок встреч
02Дататри недели
03Времячасы на день
04Контактыимя и почта
05Готовопечать с датой
Экраны сменяют друг друга внутри одного блока. Полоски сверху показывают, сколько шагов осталось, кнопка «назад» возвращает на предыдущий.
1

Добавить блок в Тильду

В нужном месте страницы: «Добавить блок» → раздел «Другое» → блок T123 «HTML-код» → «Контент».

2

Вставить код

Скопируйте готовый блок и вставьте его в поле целиком. Это разметка, стили и скрипт формы — 554 строки, править в них ничего не нужно.

Скачать файлом
3

Подставить свой ключ

В начале вставленного кода найдите data-api-key и замените плейсхолдер на свой публичный ключ.

<div id="plnbook"
     data-api-key="ВАШ_КЛЮЧ">
Единственное место, которое нужно менять.

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

Что здесь происходит

Форматспрашивает у Планёрки открытые типы встреч
Датасвободное время приходит волнами, полоса дат заполняется слева направо
Времячаще всего не спрашивает ничего — день уже в памяти
Контактыничего не спрашивает
Готовоотправляет запись

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

Почему волнами, а не одним запросом на весь горизонт и не двадцатью запросами по дню — разобрано в рецепте «Как ускорить загрузку слотов».

Если посетитель выбрал время, а его успели занять, пока он заполнял поля, форма вернёт его на экран времени с обновлённым списком, а не покажет ошибку.

Если что-то не так

«Не удалось получить типы встреч»Ключ не принят. Чаще всего он скопирован не полностью, попал с пробелом по краям или создан на другом аккаунте.
В предпросмотре Тильды пусто, а на опубликованной странице работаетКлюч пускает только адреса из своего списка. Впишите в разрешённые origin'ы и домен предпросмотра, и рабочий домен сайта.
Локально не работает, на сайте работаетТо же самое: localhost в списке разрешённых адресов нет. Либо добавьте его к ключу, либо проверяйте сразу на опубликованной странице.
На первом экране крутятся серые полосыФорма не дождалась ответа. Откройте консоль браузера — там будет код ошибки от API: по нему видно, дело в ключе, в правах или в адресе.
Форма выглядит не так, как в предпросмотреТильда добавляет свои отступы и выравнивание. Проверяйте только на опубликованной странице, а не в редакторе.
Шрифты не теПервая строка блока подгружает Literata и Golos Text. Если её удалить, форма возьмёт шрифты вашей страницы — работать будет, выглядеть иначе.
Следующий рецептСтраница записи с котомПример кастомизации, где за посетителем следит кот: смотрит в поле, которое заполняют, и радуется удачной записи.