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.