В шаблонах сообщений BookNow можно использовать переменные: специальные слова, вместо которых при отправке подставляются данные конкретной записи, например имя клиента, дата визита или название услуги. Так одно сообщение становится персональным для каждого клиента, а вводить данные вручную не нужно.
Переменные работают везде, где есть текстовый шаблон:
- напоминания и уведомления клиентам и сотрудникам (SMS, Telegram, WhatsApp, push, e-mail);
- вебхуки: адрес, тело и заголовки запроса;
- страница «Спасибо» после записи: заголовок, текст и кнопки;
- сообщения Telegram-бота компании.
Переменная пишется с двоеточием в начале: :customer_full_name. Регистр важен, пробелов внутри быть не должно. Панель не подсвечивает переменные в тексте, поэтому сверяйте написание с таблицами ниже. Если данных для переменной нет (например, у клиента не указана почта), на её месте будет пусто.
| Шаблон с переменными | Что получит адресат |
|---|
Новая запись! :customer_full_name посетит :user_name :booking_date_start_formatted. Услуга: :service_name, длительность :booking_duration_formatted, к оплате :booking_price_formatted | Новая запись! Анна Петрова посетит Ирина Смирнова среда, 23 сентября 2026 г., 13:00. Услуга: Маникюр, длительность 1 час, к оплате 3 500,00 ₽ |
:customer_first_name, ждём вас :date в :time. Адрес: :location_address_formatted. Подробности: :booking_page | Анна, ждём вас 23 сентября 2026 г. в 13:00. Адрес: ул. Ленина, 10, 101000 Москва. Подробности: https://bknw.ru/r/40589417 |
Запись :customer_full_name в :location_name изменена. Открыть в календаре: :my_url | Запись Анна Петрова в Салон на Ленина изменена. Открыть в календаре: https://my.booknow.ru/bookings/1811630 |
Спасибо за визит! Будем рады отзыву: :review_url | Спасибо за визит! Будем рады отзыву: https://bknw.ru/f/40589417 |
| Переменная | Описание | Пример |
|---|
:customer_full_name | полное имя клиента | Анна Петрова |
:customer_first_name | имя | Анна |
:customer_last_name | фамилия | Петрова |
:customer_middle_name | отчество | Сергеевна |
:customer_email | электронная почта | anna@example.ru |
:customer_phone | телефон | +79161234567 |
:customer_birthday | день рождения | 17.09.1990 |
:customer_comment | комментарий о клиенте из его карточки | Любит кофе без сахара |
:customer_id | номер клиента в системе | 323876 |
Любое дополнительное поле карточки клиента (любимый напиток, цвет волос, номер карты лояльности) тоже можно вставить в шаблон. Такие поля создаются в разделе Настройки → Данные → Пользовательские атрибуты, вкладка Атрибуты клиентов.
У каждого атрибута есть системное имя: оно показано серым в скобках рядом с названием, например customer_haircolor. Добавьте его к переменной :customer_attributes. через точку:
:customer_attributes.customer_haircolor
| Переменная | Описание | Пример |
|---|
:visits_total | число визитов клиента | 2 |
:booked_sum_amount | сумма всех записей клиента, в копейках | 4300000 |
:paid_sum_amount | сумма закрытых оплаченных записей, в копейках | 1350000 |
| Переменная | Описание | Пример |
|---|
:service_name | название услуги | Маникюр |
:services_description | список услуг в записи через запятую | Маникюр, Покрытие гель-лак |
:services_count | количество услуг в записи | 2 |
:service_category | категория услуги | Ногтевой сервис |
:service_related | связанная услуга | Педикюр |
:service_id | номер услуги в системе | 33061 |
:user_name | имя исполнителя | Ирина Смирнова |
:manager_first_name | имя исполнителя без фамилии | Ирина |
:manager_last_name | фамилия исполнителя | Смирнова |
:users_description | список исполнителей, если их несколько | Ирина Смирнова, Ольга Иванова |
:user_email | электронная почта исполнителя | irina@example.ru |
:user_phone | телефон исполнителя | +79167654321 |
Эти переменные используются чаще всего и подходят для большинства сообщений.
| Переменная | Описание | Пример |
|---|
:booking_status | статус записи | Новая запись |
:booking_description | текст из поля «Комментарий» к записи | Прошу подготовить кабинет заранее |
:ref_title | название источника записи | По телефону |
:booking_source | ключ источника записи | phone |
:booking_hash_id | номер записи, который виден в календаре и на странице записи | 40589417 |
:booking_page | страница записи со всей информацией, для клиента и сотрудников | https://bknw.ru/r/40589417 |
:review_url | ссылка, по которой клиент оставляет отзыв после визита | https://bknw.ru/f/40589417 |
:my_url | ссылка для сотрудников на запись в календаре панели: изменить, принять оплату, закрыть | https://my.booknow.ru/bookings/1811630 |
:id | внутренний номер записи, тот же, что в конце ссылки :my_url | 1811630 |
:quantity | количество мест в записи (для групповых услуг) | 2 |
:slots_count | количество слотов подряд, если услуга занимает несколько | 1 |
:review_url доступна в напоминаниях и уведомлениях. В вебхуках и на странице «Спасибо» этой переменной нет: отзыв просят после визита, а не в момент записи.
Пригодятся для вебхуков и интеграций: даты здесь в машинном формате ISO 8601.
| Переменная | Описание | Пример |
|---|
:uid | уникальный идентификатор записи | ac15372d-7422-4fc6-8fcb-b520bbffa669 |
:booking_created_at | дата и время создания записи, UTC | 2026-09-22T08:33:18+0000 |
:booking_date_start | начало записи, UTC | 2026-09-23T10:00:00+0000 |
:booking_date_start_tz | начало записи в часовом поясе филиала | 2026-09-23T13:00:00+0300 |
:booking_date_end | окончание записи, UTC | 2026-09-23T11:00:00+0000 |
:timezone | часовой пояс филиала | Europe/Moscow |
Как и у клиента, у записи могут быть дополнительные поля: их создают в разделе Настройки → Данные → Пользовательские атрибуты, вкладка Запись. Системное имя атрибута добавляется к переменной :booking_attributes. через точку.
| Переменная | Описание | Пример |
|---|
:booking_attributes.booking_callback | клиент попросил перезвонить | true |
:booking_attributes.booking_comment | комментарий клиента к записи | Нужен кабинет на 2 этаже |
: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 Meet | guest1@example.ru,guest2@example.ru |
:booking_attributes.booking_название | любой свой атрибут записи по системному имени | |
| Переменная | Описание | Пример |
|---|
:booking_price_formatted | стоимость записи с валютой, как в панели | 3 500,00 ₽ |
:booking_price_int | стоимость в целых рублях | 3500 |
:booking_price_float | стоимость с копейками через точку | 3500.00 |
:booking_price | стоимость в копейках | 350000 |
:booking_price_currency | код валюты | RUB |
| Переменная | Описание | Пример |
|---|
:booking_paid_amount_formatted | оплачено, с валютой | 3 500,00 ₽ |
:booking_paid_amount_float | оплачено, с копейками через точку | 3500.00 |
:booking_paid_amount | оплачено, в копейках | 350000 |
Даты и время подставляются в часовом поясе филиала и на языке компании.
| Переменная | Описание | Пример |
|---|
:booking_date_start_formatted | начало визита | среда, 23 сентября 2026 г., 13:00 |
:booking_date_end_formatted | окончание визита | среда, 23 сентября 2026 г., 14:00 |
:booking_created_at_formatted | когда была создана запись | вторник, 22 сентября 2026 г., 11:33 |
:date | только дата | 23 сентября 2026 г. |
:day | число месяца | 23 |
:month_number | номер месяца | 09 |
:time | только время | 13:00 |
:booking_duration_formatted | длительность словами | 1 час |
:booking_duration | длительность в минутах | 60 |
| Переменная | Описание | Пример |
|---|
:company_name | название компании | Салон красоты «Лена» |
:company_page | ссылка на страницу компании для онлайн-записи | https://bknw.ru/salon-lena |
:location_address_formatted | полный адрес филиала с индексом | ул. Ленина, 10, 101000 Москва |
:address | город и улица | Москва, ул. Ленина |
:location_city | город | Москва |
:location_street | улица и дом | ул. Ленина, 10 |
:location_apt | дом | 10 |
:location_zip | почтовый индекс | 101000 |
| Переменная | Описание | Пример |
|---|
:location_name | название филиала, в который записался клиент | Салон на Ленина |
:location_description | текст из поля «О филиале» | 1-й этаж БЦ «Регус», вход со двора |
:location_id | номер филиала в системе | 14440 |
:location_lat | широта | 55.751244 |
:location_lng | долгота | 37.618423 |
:company_logo | ссылка на логотип компании | https://…/company_logo.png |
Доступны в напоминаниях и уведомлениях: удобно добавить в письмо-подтверждение.
| Переменная | Описание |
|---|
:ical | ссылка на файл .ics, чтобы добавить визит в любой календарь |
:google | ссылка «добавить в Google Календарь» |
:outlook | ссылка «добавить в Outlook» |
:google_meet_url | ссылка на встречу в Google Meet, если подключена интеграция |
:zoom_meet_url | ссылка на встречу в Zoom, если подключена интеграция |
:microsoft_teams_url | ссылка на встречу в Microsoft Teams, если подключена интеграция |
Для напоминаний с просьбой подтвердить визит.
| Переменная | Описание | Пример |
|---|
:confirmation_url | ссылка, по которой клиент подтверждает запись | https://r.bknw.ru/ac15372d-… |
:link_validity_period | сколько действует ссылка | 2 часа |
Метки сохраняются, если клиент пришёл на страницу записи по ссылке с UTM-параметрами. Удобно передавать в вебхуки для сквозной аналитики.
| Переменная | Описание | Пример |
|---|
:utm_source | источник перехода | yandex |
:utm_medium | тип трафика | cpc |
:utm_campaign | название кампании | autumn_sale |
:utm_term | ключевое слово | запись+онлайн |
:utm_content | идентификатор объявления или контента | banner_1 |
Если нужной переменной нет в списке или значение подставляется не так, как ожидали, напишите в поддержку через чат на сайте: мы разберёмся с конкретным шаблоном.
