Интеграция с Zapier

На этой странице описаны API и структура веб-хуков, используемые в интеграции Baza Booking Calendar с Zapier. Здесь рассматриваются аутентификация, доступные события, а также конкретные поля полезных данных, отправляемые с каждым событием.

Аутентификация

Доступ привязан к вашему лицензионному ключу Baza Booking Calendar. Этот ключ используется как для проверки вашего тарифного плана, так и для аутентификации запросов, отправляемых на указанные ниже конечные точки подписки. Для интеграции с Zapier требуется лицензия по тарифному плану «Pro» или «Elite» с включенной синхронизацией с Zapier.

Встроенные конечные точки подписки (REST Hook)

Для полноценной работы с триггерами Zap сервис Baza Booking Calendar предоставляет конечные точки подписки и отписки, благодаря чему Zap может включаться и выключаться автоматически без необходимости вручную копировать URL-адрес веб-хука.

Все три конечные точки требуют указания лицензионного ключа в качестве токена-носителя:

Authorization: Bearer YOUR_LICENSE_KEY

Запросы на подписку принимают тело в формате JSON, в котором указывается, куда отправлять события, а также (опционально) по какому событию следует осуществлять фильтрацию. Пустое event значение означает подписку на все события.

POST /wp-json/bbc/v1/zapier/subscribe
{
  "target_url": "https://hooks.zapier.com/hooks/standard/...",
  "event": "booking.confirmed"
}

В ответе содержится ссылка для подписки id, которую можно использовать для отписки позже:

{ "id": "sub_123" }

Активные подписки хранятся в bbc_zapier_subscriptions WordPress. Устаревшая настройка веб-хука с одним URL-адресом (bbc_zapier_url в настройках админ-панели плагина) продолжает работать параллельно, поэтому это нововведение не затронет существующие настройки Zapier, выполненные вручную.

Настройка веб-хука

Baza Booking Calendar отправляет уведомления о событиях, связанных с бронированием, на URL-адрес веб-хука, настроенный в административных настройках плагина в разделе «Baza Booking», «Настройки», «Zapier». Веб-хук срабатывает автоматически при каждом создании бронирования или изменении его статуса.

Доступные мероприятия

Структура полезной нагрузки

Данные бронирования одной услуги:

{
  "event": "booking.confirmed",
  "site_url": "https://example.com",
  "timestamp": "2026-08-12T14:00:00+02:00",
  "booking_id": 1234,
  "order_id": "ABC-001",
  "order_status": "booked",
  "order_status_label": "Booked",
  "service": "Studio / Room A",
  "booking_dates": "12.08.2026n10:00 - 12:00",
  "booking_dates_raw": "2026/08/12/10:00-12:00",
  "booking_price": "150",
  "tax_rate": 20,
  "tax_amount": 25,
  "payment_made": "75",
  "remaining_payment": "75",
  "customer": {
    "name": "Ivan Ivanov",
    "phone": "+380991234567",
    "email": "ivan@example.com"
  },
  "admin_url": "https://example.com/wp-admin/admin.php?page=bbc-bookings&edit=1234",
  "zoom_url": "https://zoom.us/j/123456789",
  "google_meet_url": "https://meet.google.com/abc-defg-hij",
  "custom_fields": {
    "my_custom_field": "value"
  }
}

Объем бронирования в режиме «корзины», когда в одном заказе бронируются несколько услуг, service и booking_dates заменяются на cart_items массив:

{
  "event": "booking.confirmed",
  "site_url": "https://example.com",
  "timestamp": "2026-08-12T14:00:00+02:00",
  "booking_id": 1234,
  "order_id": "ABC-001",
  "order_status": "booked",
  "order_status_label": "Booked",
  "cart_items": [
    {
      "service": "Studio / Room A",
      "booking_dates": "12.08.2026n10:00 - 11:00",
      "booking_dates_raw": "2026/08/12/10:00-11:00",
      "price": "75.00"
    },
    {
      "service": "Studio / Room B",
      "booking_dates": "12.08.2026n11:00 - 12:00",
      "booking_dates_raw": "2026/08/12/11:00-12:00",
      "price": "75.00"
    }
  ],
  "booking_price": "150",
  "tax_rate": 20,
  "tax_amount": 25,
  "payment_made": "75",
  "remaining_payment": "75"
}

Полевая ссылка

Все поля можно сопоставить с любым полем целевого приложения в Zapier — программирование не требуется.

Настройка вручную (веб-хуки через Zapier)

Пока нативное приложение Baza Booking Calendar не появится в каталоге приложений Zapier, интеграцию можно настроить вручную с помощью встроенного триггера Zapier «Webhooks»:

1. Перейдите на сайт zapier.com и нажмите «Создать» (Create), «Zap»
2. Выберите «Webhooks by Zapier» в качестве триггера, «Catch Hook»
3. Скопируйте URL-адрес веб-хука (выглядит примерно так: https://hooks.zapier.com/hooks/catch/...)
4. Вставьте его в поле «URL веб-хука» в Baza Booking, в разделе «Настройки» → «Zapier», и сохраните
5. Нажмите «Отправить тестовое событие» — Zapier определит все доступные поля
6. Продолжите настройку действий в Zap (Google Sheets, Slack, CRM и т. д.)

Требования к плану

Интеграция с Zapier доступна в тарифных планах «Pro» и «Elite» сервиса Baza Booking Calendar. Она недоступна в рамках бесплатной пробной версии или без действующего лицензионного ключа для тарифных планов «Pro»/«Elite».