Integrácia so Zapierom

Táto stránka popisuje štruktúru rozhrania API a webhookov, ktoré využíva integrácia Baza Booking Calendar so službou Zapier. Obsahuje informácie o overovaní, dostupných udalostiach a presných poliach dátového obsahu odosielaných s každou udalosťou.

Overenie identity

Prístup je viazaný na váš licenčný kľúč Baza Booking Calendar. Ten istý kľúč sa používa jednak na overenie vášho tarifu a jednak na autentizáciu požiadaviek smerovaných na nižšie uvedené koncové body predplatného. Integrácia so službou Zapier vyžaduje licenciu v rámci tarifu Pro alebo Elite s povolenou synchronizáciou so službou Zapier.

Natívne koncové body predplatného (REST Hook)

Aby bolo používanie spúšťačov v Zap úplne intuitívne, Baza Booking Calendar poskytuje koncové body na prihlásenie a odhlásenie, vďaka čomu sa spúšťač v Zap môže automaticky zapínať a vypínať bez potreby ručného kopírovania URL webhooku.

Všetky tri koncové body vyžadujú licenčný kľúč ako token typu „bearer“:

Authorization: Bearer YOUR_LICENSE_KEY

Žiadosti o odber prijímajú telo v formáte JSON, v ktorom sa špecifikuje, kam majú byť udalosti odosielané, a voliteľne aj to, podľa akej udalosti sa má filtrovať. Prázdna event hodnota znamená odber všetkých udalostí.

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

Odpoveď obsahuje odkaz na registráciu id, ktoré slúži na neskoršie odhlásenie:

{ "id": "sub_123" }

Aktívne predplatné sú uložené v bbc_zapier_subscriptions WordPress. Staršie nastavenie webhooku s jednou URL adresou (bbc_zapier_url v nastaveniach správcu doplnku) naďalej funguje paralelne, takže toto doplnenie nemá vplyv na existujúce ručné nastavenia v Zapieri.

Nastavenie webhooku

Baza Booking Calendar odosiela udalosti týkajúce sa rezervácií na URL adresu webhooku, ktorá je nakonfigurovaná v nastaveniach administrátora pluginu v časti Baza Booking, Nastavenia, Zapier. Webhook sa spustí automaticky vždy, keď sa vytvorí rezervácia alebo sa zmení jej stav.

Dostupné podujatia

Štruktúra užitočného zaťaženia

Dátová náplň rezervácie jednej služby:

{
  "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"
  }
}

Údaje o rezervácii v režime „Cart-mode“, keď je v jednej objednávke rezervovaných viacero služieb, service a booking_dates sú nahradené cart_items pole:

{
  "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"
}

Odkaz na pole

Všetky polia je možné priradiť k akémukoľvek cieľovému poľu aplikácie v Zapieri, bez potreby programovania.

Ručné nastavenie (Webhooky cez Zapier)

Kým nebude natívna aplikácia Baza Booking Calendar dostupná v zozname aplikácií Zapier, integráciu je možné nastaviť ručne pomocou vstavaného spúšťača Webhooks v Zapieri:

1. Prejdite na stránku zapier.com a kliknite na „Vytvoriť“, „Zap“
2. Ako spúšťač vyberte možnosť „Webhooks by Zapier“, Catch Hook
3. Skopírujte URL webhooku (vyzerá takto: https://hooks.zapier.com/hooks/catch/...)
4. Vložte ju do poľa „URL webhooku“ v aplikácii Baza Booking, v časti Nastavenia, Zapier, a uložte
5. Kliknite na „Odoslať testovú udalosť“ – Zapier rozpozná všetky dostupné polia
6. Pokračujte v nastavovaní akcií v Zap (Google Sheets, Slack, CRM atď.)

Požiadavky plánu

Integrácia so službou Zapier je k dispozícii v rámci tarifných plánov Pro a Elite služby Baza Booking Calendar. Nie je k dispozícii v rámci bezplatnej skúšobnej verzie ani bez platného licenčného kľúča pre tarifné plány Pro alebo Elite.