Webhooki

Jeden adres Twojego systemu, wywoływany przy każdym zdarzeniu w Piklo.

2 min czytania ·

Co to jest. W Ustawienia → Integracje właściciel lub administrator dodaje adres https i wybiera zdarzenia. Piklo wysyła pod ten adres żądanie POST z małym obiektem JSON. Można użyć Zapier, Make lub własnego systemu. Firma może mieć do trzech webhooków.

Zdarzenia.

  • booking.created — klient zarezerwował lub opłacił wstępnie zarezerwowany termin
  • booking.cancelled — klient odwołał rezerwację
  • booking.rescheduled — klient przeniósł termin
  • client.created — rezerwacja utworzyła nowego klienta
  • review.received — klient wystawił ocenę
  • membership.started — członkostwo zostało opłacone i rozpoczęte
  • ping — wysyłany po wybraniu „Wyślij test”

Wysyłane są także rezerwacje, klienci i członkostwa utworzone w panelu.

Wygląd wywołania. Każde zawiera zdarzenie, czas, firmę i dane.

{
  "event": "booking.created",
  "occurred_at": "2026-11-02T14:03:11.204Z",
  "organization_id": "5b0c…",
  "data": { "booking": { "id": "e1f4…", "status": "confirmed" } }
}

Dane klienta tylko na życzenie. Imię, e-mail, telefon, cena i komentarz oceny są wysyłane tylko po włączeniu „Wyślij dane klienta”. Wtedy data zawiera również client i price. Domyślnie opcja jest wyłączona, ponieważ zgodnie z RODO odpowiadasz za wykorzystanie danych przez odbiorcę.

Sprawdzenie podpisu. Każde wywołanie ma nagłówek X-Piklo-Signature: sha256=… — HMAC-SHA256 surowej treści z sekretem pokazanym podczas konfiguracji.

const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
const valid = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signatureHeader));
if (!valid) return response.status(401).end();

Podpis należy sprawdzić przed parsowaniem treści. X-Piklo-Event zawiera także nazwę zdarzenia.

Odpowiedź. W ciągu 5 sekund należy zwrócić dowolny status 2xx. W przeciwnym razie Piklo ponawia po 1, 5 i 30 minutach. Po 10 kolejnych błędach webhook jest wyłączany. Wywołania mogą się powtórzyć lub przyjść w innej kolejności; należy używać occurred_at i ID rezerwacji.

Widoczność. Każdy webhook pokazuje ostatnich 50 dostarczeń ze statusem. Są usuwane po 14 dniach.

Kontakt. Napisz na support@piklobooking.com.

Webhooki są bezpłatne w Piklo Booking i należą do produktu dla każdej firmy.