Подключение Integrilla

Integrilla — сервис отправки сообщений в мессенджеры. Если подключить его к BookNow, клиенты будут получать сообщения о своих записях, а сотрудники — о новых записях к ним.

Связь работает через вебхуки. При событии в BookNow, например при создании записи, BookNow отправляет в Integrilla запрос с текстом сообщения и номером получателя, а Integrilla доставляет сообщение по подключённым каналам. Каждый вебхук отвечает за один вид сообщения со своим текстом, поэтому для уведомлений о создании, переносе и отмене записи создаются три отдельных вебхука.

Подготовка в Integrilla

1. Зарегистрируйтесь в Integrilla и подключите каналы, через которые будут отправляться сообщения, в разделе «Каналы» личного кабинета. Порядок подключения каждого канала описан в инструкциях Integrilla.
2. Если каналов несколько, проверьте порядок каскадной отправки в разделе «Интеграции → Настройки каскадов»: если сообщение не доставлено по первому каналу, Integrilla отправляет его по следующему. Подробнее — в статье о каскадах.
3. Скопируйте токен: он указан в инструкции, которую Integrilla присылает при регистрации и при создании нового канала в личном кабинете. Токен понадобится в каждом вебхуке.

Быстрая настройка

1. Откройте в панели раздел Интеграции → Integrilla.
2. В блоке Готовые сообщения выберите сообщение. Откроется форма вебхука, заполненная по этой инструкции.
3. Вставьте токен Integrilla в параметр token. При необходимости измените текст сообщения в параметре text.
4. Нажмите Сохранить. Вебхук появится в блоке Подключённые сообщения на странице интеграции.

Форму нельзя сохранить, пока не вставлен токен. В сообщении с просьбой об отзыве замените слова «ссылка на отзывы» на ссылку на карточку компании в картах: до замены форма тоже не сохраняется.

Пока включён хотя бы один вебхук Integrilla, интеграция отмечена в разделе Интеграции как подключённая.

Создание вебхука вручную

Если нужен вебхук с другим событием или своими настройками, создайте его вручную. Откройте в панели раздел Настройки → Разработчикам → Вебхуки и нажмите Добавить. Заполните форму, как показано ниже.

Основные настройки

Integrilla отвечает кодом 201, когда принимает сообщение к отправке, и кодом 400, когда в записи нет телефона получателя, например у записи анонимного клиента. Код 400 в настройках нужен, чтобы такие записи не приводили к отключению вебхука: если его не указать, BookNow будет считать ответ ошибкой, повторит запрос и после всех попыток отключит вебхук. Если не указать код 201, ошибкой будет считаться каждая доставка.

Автоматическое отключение

Если Integrilla не приняла сообщение, BookNow повторяет запрос несколько раз. Когда все попытки исчерпаны, вебхук отключается и перестаёт отправлять все сообщения этого вида, а не только то, которое не удалось доставить.

Включите Оповещать по e-mail и укажите почту в поле Email для уведомлений: так вы узнаете об отключении сразу, а не по жалобам клиентов. Можно указать несколько адресов через запятую.

Событие

В блоке Запускать по событию отметьте одно событие, при котором отправляется сообщение.

Рекомендации по выбору события:

• Отмечайте в одном вебхуке одно событие. Если отметить несколько, текст «Вы записаны» получит и клиент, у которого запись отменили.
• Для сообщения о переносе выбирайте booking-rescheduled. При переносе записи BookNow отправляет и booking-rescheduled, и booking-updated, поэтому вебхук с обоими событиями отправит клиенту два одинаковых сообщения.
• Событие booking-updated отправляется при любом изменении записи, в том числе при смене статуса. Сообщения клиенту на это событие приходят слишком часто, поэтому используйте его только для уведомлений сотрудникам.
• Вебхук отправляется сразу после события. Напоминание за сутки до визита через вебхук настроить нельзя: для таких сообщений используйте раздел Маркетинг → Напоминания.

Параметры

Во вкладке Параметры нажмите Добавить четыре раза и заполните пары «Ключ — Значение».

Вместо :customer_phone в поле to можно указать :user_phone, чтобы сообщение получил исполнитель записи, или постоянный номер администратора в формате 79991234567.

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

Нажмите Сохранить. Чтобы отправлять несколько видов сообщений, создайте по вебхуку на каждый вид: параметры to, token и booking_hash_id в них одинаковые, различаются событие и text.

Готовые тексты

Тексты можно копировать в параметр text целиком. В правом столбце показано, что получит адресат для записи из статьи Переменные в шаблонах сообщений: клиент Анастасия Соколова записана в «Твой выбор» на стрижку к Анне Ивановой, 15 октября 2026 года в 10:00.

Переменная :review_url в вебхуках не работает: она доступна только в напоминаниях. Для просьбы об отзыве укажите в тексте прямую ссылку на карточку компании в картах.

Проверка

1. Создайте в календаре тестовую запись на свой номер телефона.
2. Откройте вебхук в разделе Настройки → Разработчикам → Вебхуки. На странице Настройки и история отправки появится строка с событием.
3. Откройте строку. Код ответа 201 означает, что Integrilla приняла сообщение; дальше статус доставки виден в личном кабинете Integrilla.

Если код другой, найдите его в таблице ниже. Ответ 400 отмечается в истории как успешный, поэтому проверяйте и текст ответа: сообщение отправлено только при коде 201.

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

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