Уведомления и сообщения

Переменные в шаблонах сообщений

Переменные BookNow для SMS-напоминаний, писем, вебхуков и страницы «Спасибо»: правила написания, готовые шаблоны и полный список с примерами значений.

В шаблонах сообщений BookNow можно использовать переменные: специальные слова, вместо которых при отправке подставляются данные конкретной записи, например имя клиента, дата визита или название услуги. Так одно сообщение становится персональным для каждого клиента, а вводить данные вручную не нужно.

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

Запись для примеров

Все примеры в статье построены на одной записи, поэтому значения в разных таблицах совпадают между собой.

ЧтоЗначение
КомпанияТвой выбор
ФилиалТвой выбор на Туполева: набережная Академика Туполева 222, 105005 Москва
КлиентАнастасия Сергеевна Соколова, +79150010203, customer@booknow.ru
УслугаСтрижка и укладка, категория «Волосы», 1 час, 2 500 ₽
ИсполнительАнна Иванова
Время визитачетверг, 15 октября 2026 года, с 10:00 до 11:00
Комментарий клиентаХочу обновить форму каре

Где работают переменные

ГдеРаздел в панелиКуда подставляются переменныеНабор
SMS-напоминания клиентамМаркетинг → Напоминания → SMSвесь текст сообщенияполный
Письма клиентамМаркетинг → Напоминания → Emailполе «Важная информация»; тема и основной текст письма стандартные и не редактируютсяполный
ВебхукиНастройки → Разработчикам → Вебхукиадрес, заголовки и параметры запросаосновной
Страница «Спасибо» после записиНастройки → Онлайн-запись → Страница благодарностизаголовок, текст и адрес ссылки в кнопке; надпись на кнопке остаётся как введенаосновной
Уведомления сотрудникам в TelegramИнтеграции → Telegram Группа и Интеграции → Telegramтекст уведомленияосновной

Полный набор — все переменные из этой статьи. Основной набор — те же переменные, кроме отмеченных словами «только в напоминаниях»: это ссылка на отзыв, ссылки на календарь и онлайн-встречу, подтверждение записи, а также имя и фамилия исполнителя по отдельности.

Редактор в панели подсказывает только часть переменных: в напоминаниях кнопка «Переменные» предлагает 11 самых частых, на странице «Спасибо» показаны три, в вебхуках подсказок нет. Остальные переменные из этой статьи тоже работают, их нужно ввести вручную.

Правила написания

  • Переменная начинается с двоеточия и пишется строчными латинскими буквами: :customer_full_name. Пробелов внутри быть не должно.
  • Регистр важен. Переменная :Customer_full_name в напоминаниях не сработает.
  • После переменной ставьте пробел или знак препинания. Если сразу за именем идёт буква, цифра или подчёркивание, подставится более короткая переменная: :dates превратится в «15 октября 2026 г.s».
  • Если данных для переменной нет (например, у клиента не указана почта), вместо неё подставляется пустое значение.
  • Переменная с опечаткой или недоступная в этом месте остаётся в сообщении как набрана: клиент увидит текст :review_ur. Перед включением шаблона сверяйте написание с таблицами ниже.
  • В редакторе напоминаний нет переноса строки. Текст SMS ограничен 355 символами, поле «Важная информация» в письме — 1024 символами.
  • Изменённый текст SMS проходит модерацию; до её завершения напоминание отмечено в списке словами «На модерации».
Длина SMS считается после подстановки. Одно SMS на русском языке вмещает 70 символов, более длинный текст делится на части по 67 символов, и каждая часть оплачивается отдельно. Длинные значения, например :location_address_formatted или :booking_date_start_formatted, заметно увеличивают сообщение.

Готовые шаблоны

Шаблоны можно копировать целиком. В правом столбце показано, что получится для записи из примера.

SMS клиенту

ШаблонЧто получит клиент
Подтверждение записи, стандартный текст: Привет, :customer_name! Ваша запись в :company_name подтверждена на :date в :time. До скорой встречи!Привет, Анастасия! Ваша запись в Твой выбор подтверждена на 15 октября 2026 г. в 10:00. До скорой встречи!
Напоминание перед визитом: :customer_name, напоминаем: :date в :time вас ждёт :manager_first_name, услуга «:service_name». Адрес: :location_address_formatted. Подробности: :booking_pageАнастасия, напоминаем: 15 октября 2026 г. в 10:00 вас ждёт Анна, услуга «Стрижка и укладка». Адрес: набережная Академика Туполева 222, 105005 Москва. Подробности: https://bknw.ru/r/897399598
Перенос записи: :customer_name, ваша запись перенесена. Новое время: :booking_date_start_formatted. Подробности: :booking_pageАнастасия, ваша запись перенесена. Новое время: четверг, 15 октября 2026 г., 10:00. Подробности: https://bknw.ru/r/897399598
Отмена записи: :customer_name, запись на :date в :time отменена. Выбрать другое время: :company_pageАнастасия, запись на 15 октября 2026 г. в 10:00 отменена. Выбрать другое время: https://bknw.ru/tvoy-vybor
Просьба об отзыве: :customer_name, спасибо за визит! Будем рады вашему отзыву: :review_urlАнастасия, спасибо за визит! Будем рады вашему отзыву: https://bknw.ru/f/897399598
Приглашение записаться снова: :customer_name, давно не виделись! Записаться на «:service_name» можно здесь: :company_pageАнастасия, давно не виделись! Записаться на «Стрижка и укладка» можно здесь: https://bknw.ru/tvoy-vybor

Заметка в письме

Письма клиентам отправляются в стандартном оформлении: в них уже есть дата, услуга, адрес, стоимость и кнопки управления записью. Свой текст добавляется в поле «Важная информация».

ШаблонЧто получит клиент
:location_description. Ваш мастер — :user_name, телефон для связи: :user_phoneВход со стороны набережной, 2-й этаж. Ваш мастер — Анна Иванова, телефон для связи: +79009090999

Вебхук

В вебхуке переменные подставляются в адрес, заголовки и параметры. Параметры задаются парами «ключ — значение»: при методе POST они отправляются как поля формы, при методе GET — в строке запроса. Ниже настройки вебхука и то, что отправляется для записи из примера.

Поле вебхукаЗначение в настройкахЧто отправляется
Адресhttps://example.com/hook?booking=:booking_hash_idhttps://example.com/hook?booking=897399598
Заголовок X-Booking-Id:id40566573
Параметр client:customer_full_nameАнастасия Соколова
Параметр phone:customer_phone79150010203
Параметр service:services_descriptionСтрижка и укладка
Параметр master:user_nameАнна Иванова
Параметр start:booking_date_start_tz2026-10-15T10:00:00+0300
Параметр price:booking_price_formatted2 500,00 ₽
Параметр source:ref_titleВеб-сайт
Параметр textНовая запись! :customer_full_name придёт :date в :time. Услуга: :service_name, длительность :booking_duration_formatted, к оплате :booking_price_formattedНовая запись! Анастасия Соколова придёт 15 октября 2026 г. в 10:00. Услуга: Стрижка и укладка, длительность 1 час, к оплате 2 500,00 ₽

Особенности вебхуков:

  • Значения, состоящие только из цифр, отправляются в параметрах и заголовках как числа. Поэтому телефон приходит без знака «+», а ведущие нули теряются: день 05 придёт как 5.
  • В адресе значения кодируются для URL: пробелы и русские буквы заменяются кодами.
  • Переменная с заглавной первой буквой подставляет значение с заглавной буквы, а переменная, набранная заглавными целиком, — значение заглавными буквами: :CUSTOMER_FIRST_NAME превратится в «АНАСТАСИЯ».
  • Если параметры не заданы, при методе POST отправляется JSON со всеми переменными записи. Его состав описан в статье Данные вебхука для разработчиков.
  • Событие продажи товаров (goods-sold) содержит другой набор данных: переменные записи в нём недоступны.

Страница «Спасибо»

ПолеШаблонЧто увидит клиент
ЗаголовокСпасибо, :customer_first_name!Спасибо, Анастасия!
ТекстВы записаны на :date в :time — до встречи! Наш адрес: :location_address_formattedВы записаны на 15 октября 2026 г. в 10:00 — до встречи! Наш адрес: набережная Академика Туполева 222, 105005 Москва
Надпись на кнопкеКак добратьсяКак добраться
Ссылка в кнопкеhttps://yandex.ru/maps/?text=:location_address_formattedссылка на Яндекс Карты с адресом филиала

В ссылке кнопки значения кодируются для URL, поэтому переменная должна быть частью адреса, как в примере. Если вставить вместо всего адреса переменную со ссылкой, например :booking_page, ссылка не откроется.

Уведомление сотрудникам в Telegram

ШаблонЧто получит сотрудник
Новая запись: :customer_full_name, :service_name, :booking_date_start_formatted. Открыть в календаре: :my_urlНовая запись: Анастасия Соколова, Стрижка и укладка, четверг, 15 октября 2026 г., 10:00. Открыть в календаре: https://my.booknow.ru/bookings/40566573

Данные о клиенте

ПеременнаяОписаниеПример
:customer_nameимя клиента; используется в стандартных шаблонахАнастасия
:customer_first_nameимя, то же значение, что у :customer_nameАнастасия
:customer_last_nameфамилияСоколова
:customer_middle_nameотчествоСергеевна
:customer_full_nameимя и фамилияАнастасия Соколова
:customer_emailэлектронная почтаcustomer@booknow.ru
:customer_phoneтелефон+79150010203
:customer_birthdayдень рождения21.12.1994
:customer_commentкомментарий о клиенте из его карточкиПредпочитает запись на утро
:customer_idномер клиента в системе10171469

Атрибуты клиента

Любое дополнительное поле карточки клиента тоже можно вставить в шаблон. Такие поля создаются в разделе Настройки → Данные → Пользовательские атрибуты, вкладка Атрибуты клиентов.

Системное имя атрибута BookNow присваивает автоматически по его названию. Оно показано серым под названием в списке атрибутов. Добавьте его к переменной :customer_attributes. через точку:

ПеременнаяОписаниеПример
:customer_attributes.customer_liubimyi_napitokатрибут «Любимый напиток»Капучино без сахара

Для телефона и почты используйте :customer_phone и :customer_email. В переменных :customer_attributes.customer_phone и :customer_attributes.customer_email значение может быть скрыто звёздочками.

Статистика визитов клиента

ПеременнаяОписаниеПример
:visits_totalчисло состоявшихся визитов клиента0
:booked_sum_amountсумма предстоящих записей клиента, в копейках900000
:paid_sum_amountсумма закрытых оплаченных записей, в копейках0

Пример относится к новому клиенту: у него есть предстоящие записи на 9 000 ₽, визитов и оплат ещё не было.

Услуга и исполнитель

ПеременнаяОписаниеПример
:service_nameназвание услугиСтрижка и укладка
:service_categoryкатегория услугиВолосы
:service_idномер услуги в системе1045084
:services_descriptionсписок услуг в записи через запятуюСтрижка и укладка, Маникюр
:services_countколичество услуг в записи2
:service_relatedостальные услуги записи, кроме первойМаникюр
:user_nameимя и фамилия исполнителяАнна Иванова
:manager_first_nameимя исполнителя; только в напоминанияхАнна
:manager_last_nameфамилия исполнителя; только в напоминанияхИванова
:users_descriptionсписок исполнителей через запятую, если их несколькоАнна Иванова
:user_emailэлектронная почта исполнителяanna@example.ru
:user_phoneтелефон исполнителя+79009090999

Примеры для :services_description, :services_count и :service_related показаны для записи с двумя услугами: «Стрижка и укладка» и «Маникюр». Для записи с одной услугой :service_related пуста.

Данные о записи

Эти переменные используются чаще всего и подходят для большинства сообщений.

ПеременнаяОписаниеПример
:booking_statusстатус записиНовый
:booking_descriptionкомментарий клиента к записиХочу обновить форму каре
:ref_titleназвание источника записиВеб-сайт
:booking_sourceключ источника записиwebsite
:booking_hash_idномер записи, который виден в календаре и на странице записи897399598
:booking_pageстраница записи со всей информацией, для клиента и сотрудниковhttps://bknw.ru/r/897399598
:review_urlссылка, по которой клиент оставляет отзыв после визита; только в напоминанияхhttps://bknw.ru/f/897399598
:my_urlссылка для сотрудников на запись в календаре панели: изменить, принять оплату, закрытьhttps://my.booknow.ru/bookings/40566573
:idвнутренний номер записи, тот же, что в конце ссылки :my_url40566573
:quantityколичество мест в записи (для групповых услуг)1
:slots_countколичество слотов подряд, если услуга занимает несколько1

Названия статусов настраиваются в разделе Настройки → Данные → Статусы, источники — в разделе Настройки → Данные → Источники. Для записи по телефону :ref_title подставит «Телефон», а :booking_source — phone.

Расширенные данные о записи

Пригодятся для вебхуков и интеграций: даты здесь в машинном формате ISO 8601.

ПеременнаяОписаниеПример
:uidуникальный идентификатор записиc17215ec-cc85-413b-8b1a-cacf0b476b2c
:booking_created_atдата и время создания записи, UTC2026-10-02T09:02:34+0000
:booking_date_startначало записи, UTC2026-10-15T07:00:00+0000
:booking_date_start_tzначало записи с часовым поясом2026-10-15T10:00:00+0300
:booking_date_endокончание записи, UTC2026-10-15T08:00:00+0000
:timezoneчасовой поясEurope/Moscow

Атрибуты записи

Как и у клиента, у записи могут быть дополнительные поля: их создают в разделе Настройки → Данные → Пользовательские атрибуты, вкладка Запись. Системное имя атрибута добавляется к переменной :booking_attributes. через точку.

ПеременнаяОписаниеПример
:booking_attributes.booking_commentкомментарий клиента к записиХочу обновить форму каре
:booking_attributes.booking_internal_noteзаметка для сотрудников
:booking_attributes.booking_callbackклиент попросил перезвонить; доступна, если в форме записи есть поле «Обратный звонок»1
:booking_attributes.booking_google_meetссылка на встречу в Google Meet, если подключена интеграцияhttps://my.booknow.ru/go/bookings/…
:booking_attributes.booking_zoomссылка на встречу в Zoom, если подключена интеграцияhttps://my.booknow.ru/go/bookings/…
:booking_attributes.booking_microsoft_teamsссылка на встречу в Microsoft Teams, если подключена интеграцияhttps://my.booknow.ru/go/bookings/…
:booking_attributes.booking_google_meet_guest_emailsпочты гостей встречи Google Meetguest1@example.ru,guest2@example.ru
:booking_attributes.booking_названиелюбой свой атрибут записи по системному имени

Если интеграция для онлайн-встреч не подключена, соответствующая переменная остаётся в тексте как набрана.

Цена

ПеременнаяОписаниеПример
:booking_price_formattedстоимость записи с валютой, как в панели2 500,00 ₽
:booking_price_intстоимость в целых рублях2500
:booking_price_floatстоимость с копейками через точку2500.00
:booking_priceстоимость в копейках250000
:booking_price_currencyкод валютыRUB

Оплаченная сумма

Пока запись не оплачена, значения равны нулю, как в примере.

ПеременнаяОписаниеПример
:booking_paid_amount_formattedоплачено, с валютой0,00 ₽
:booking_paid_amount_floatоплачено, с копейками через точку0.00
:booking_paid_amountоплачено, в копейках0

Время

Дата и время подставляются на языке компании. В напоминаниях и на странице «Спасибо» используется часовой пояс клиента, если клиент записывался онлайн и его часовой пояс известен; в остальных случаях и во всех вебхуках используется часовой пояс филиала.

ПеременнаяОписаниеПример
:booking_date_start_formattedначало визитачетверг, 15 октября 2026 г., 10:00
:booking_date_end_formattedокончание визитачетверг, 15 октября 2026 г., 11:00
:booking_created_at_formattedкогда была создана записьпятница, 2 октября 2026 г., 12:02
:dateтолько дата15 октября 2026 г.
:dayчисло месяца15
:month_numberномер месяца10
:timeтолько время10:00
:booking_duration_formattedдлительность словами1 час
:booking_durationдлительность в минутах60

В переменных с полной датой часы до десяти пишутся без нуля в начале: для записи на половину десятого получится «9:30», а в :time — «09:30». Если формат времени важен, составляйте фразу из :date и :time.

Адрес

ПеременнаяОписаниеПример
:company_nameназвание компанииТвой выбор
:company_pageссылка на страницу компании для онлайн-записиhttps://bknw.ru/tvoy-vybor
:location_address_formattedполный адрес филиала: улица, дом, индекс, городнабережная Академика Туполева 222, 105005 Москва
:addressгород и улица, без номера домаМосква, набережная Академика Туполева
:location_cityгородМосква
:location_streetулицанабережная Академика Туполева
:location_aptдом222
:location_zipпочтовый индекс105005

Адрес собирается из полей филиала в том виде, в каком они заполнены. Если индекс не указан, в :location_address_formatted на его месте останется пробел, поэтому заполните индекс в настройках филиала.

О филиале

ПеременнаяОписаниеПример
:location_nameназвание филиала, в который записался клиентТвой выбор на Туполева
:location_descriptionтекст из поля «О филиале»Вход со стороны набережной, 2-й этаж
:location_idномер филиала в системе331734
:location_latширота55.759314
:location_lngдолгота37.67705
:company_logoссылка на логотип компанииhttps://…/company_logo.png

Календарь и онлайн-встречи

Эти переменные доступны только в напоминаниях. В письмах ссылки на календарь уже есть в стандартном оформлении.

ПеременнаяОписаниеПример
:icalссылка на файл .ics, чтобы добавить визит в любой календарьhttps://my.booknow.ru/go/bookings/c17215ec-…/ical
:googleссылка «добавить в Google Календарь»https://my.booknow.ru/go/bookings/c17215ec-…/google
:outlookссылка «добавить в Outlook»https://my.booknow.ru/go/bookings/c17215ec-…/outlook
:google_meet_urlссылка на встречу в Google Meet, если подключена интеграция
:zoom_meet_urlссылка на встречу в Zoom, если подключена интеграция
:microsoft_teams_urlссылка на встречу в Microsoft Teams, если подключена интеграция

Подтверждение записи

Эти переменные доступны только в напоминаниях и заполняются, если включено напоминание с просьбой подтвердить визит.

ПеременнаяОписаниеПример
:confirmation_urlссылка, по которой клиент подтверждает записьhttps://r.bknw.ru/…
:link_validity_periodсколько действует ссылка24 часа

UTM-метки

Метки сохраняются, если клиент пришёл на страницу записи по ссылке с UTM-параметрами. Пример такой ссылки:

https://booking.booknow.ru/tvoy-vybor?ref=website&utm_source=yandex&utm_medium=cpc&utm_campaign=autumn_sale&utm_term=стрижка%20москва&utm_content=banner_1
ПеременнаяОписаниеПример
:utm_sourceисточник переходаyandex
:utm_mediumтип трафикаcpc
:utm_campaignназвание кампанииautumn_sale
:utm_termключевое словострижка москва
:utm_contentидентификатор объявления или контентаbanner_1

Настройка и устранение неполадок

Что видно в сообщенииПричинаЧто сделать
Переменная осталась текстом, например :review_urlОпечатка, заглавная буква или переменная недоступна в этом местеСверьте написание с таблицами и проверьте раздел «Где работают переменные»
На месте переменной пустоУ записи или клиента нет этих данныхЗаполните поле в карточке клиента или в настройках филиала
К значению добавились лишние буквыСразу после переменной идёт буква, цифра или подчёркиваниеПоставьте после переменной пробел или знак препинания
Телефон в вебхуке без знака «+»Значения из одних цифр отправляются как числаДобавляйте «+» на стороне получателя
Время «9:30» вместо «09:30»В переменных с полной датой час пишется без нуляИспользуйте :date и :time

Если нужной переменной нет в списке или значение подставляется не так, как ожидали, напишите в поддержку через чат на сайте: мы проверим конкретный шаблон.

Читайте также

Copyright © 2026