Обзор
Вебхук — это HTTP-запрос, который BookNow отправляет на ваш адрес при событии в аккаунте. В одном аккаунте можно создать до 10 вебхуков, каждый подписывается на свой набор событий.
События
| Событие | Когда отправляется (проверено 26.09.2026) |
|---|---|
booking-created | создана запись: из виджета, панели или POST /bookings |
booking-updated | запись изменена в панели или через API: время, сотрудник, статус. При изменении только публичной заметки (public_notes) событие не отправляется |
booking-rescheduled | запись перенесена (PUT /bookings/{uuid}/reschedule или панель). Вместе с ним отправляется и booking-updated |
booking-canceled | запись отменена (PUT /bookings/{uuid}/status/cancel или панель) |
booking-succeeded | визит завершён (PUT /bookings/{uuid}/status/complete или панель) |
goods-sold | оплачен заказ с товарами (POST /orders/{uuid}/pay, касса в панели) |
https://crm.example.ru/booknow?event=booking-created. Подробнее — Данные вебхука.Настройка
Через панель: раздел Настройки → Разработчикам → Вебхуки. Через API: POST /webhooks с полями url, method (POST или GET), events, success_statuses, при необходимости headers и parameters. Полный список полей — в API reference.
Повторные попытки и отключение
Каждый вебхук имеет tries (число попыток, по умолчанию 5) и timeout (секунды ожидания ответа, по умолчанию 10). Ответ считается успешным, если код входит в success_statuses. После исчерпания попыток вебхук переходит в статус auto_disabled; при send_notification: true на адреса из emails отправляется письмо. Повторно включить вебхук можно в панели или запросом POST /webhooks/{id}/enable.
Статусы вебхука: enabled, disabled (выключен вручную), auto_disabled (выключен после неудачных попыток). История попыток и повторная отправка доступны в панели.