Webhooks

Én adresse hos jer, der bliver kaldt, hver gang der sker noget i Piklo.

2 min. læsetid ·

Hvad det er. Under Indstillinger → Integrationer tilføjer ejeren eller en admin en https-adresse og vælger, hvilke hændelser den skal have. Piklo sender så et POST-kald med en lille JSON-krop til adressen, hver gang en af dem sker. Brug det med Zapier, Make eller jeres eget system. En virksomhed kan have op til tre.

Hændelserne.

  • booking.created — en kunde bookede, eller en reserveret booking blev betalt
  • booking.cancelled — en kunde aflyste
  • booking.rescheduled — en kunde flyttede sin tid
  • client.created — en booking gav en ny kunde
  • review.received — en kunde gav stjerner
  • membership.started — et medlemskab blev betalt og startede
  • ping — sendes, når I trykker "Send test"

Bookinger, kunder og medlemskaber, som I selv opretter i dashboardet, sendes også.

Sådan ser et kald ud. Alle kald har samme form: hændelsen, hvornår den skete, virksomheden og data.

{
  "event": "booking.created",
  "occurred_at": "2026-11-02T14:03:11.204Z",
  "organization_id": "5b0c…",
  "data": {
    "booking": {
      "id": "e1f4…",
      "status": "confirmed",
      "seats": 1,
      "starts_at": "2026-11-06T15:30:00+00:00",
      "ends_at": "2026-11-06T16:15:00+00:00",
      "services": ["Klipning"],
      "staff": "Anna",
      "location": "Hovedgaden",
      "client_id": "77ad…"
    }
  }
}

Kundeoplysninger kun, når I beder om dem. Kundens navn, e-mail og telefon, prisen og kommentaren fra en anmeldelse kommer kun med, når "Send kundeoplysninger" er krydset af på webhooken. Så indeholder data også client (name, email, phone) og price (amount_cents, currency). Det er slået fra, indtil I krydser af, fordi det, modtageren gør med oplysningerne, er jeres ansvar efter GDPR.

Tjek signaturen. Alle kald har headeren X-Piklo-Signature: sha256=… — en HMAC-SHA256 af den rå krop, lavet med den nøgle, I fik vist, da I tilføjede webhooken. I Node.js:

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();

Tjek den mod kroppen, præcis som den kom, før den bliver parset. Headeren X-Piklo-Event bærer også hændelsens navn.

Svar. Svar med en hvilken som helst 2xx inden for 5 sekunder. Alt andet, eller intet svar, bliver prøvet igen efter 1, 5 og 30 minutter og derefter markeret som fejlet. Efter 10 fejlede leveringer i træk slår Piklo webhooken fra og siger det under Indstillinger; ret adressen, send en test, og slå den til igen. Et kald kan komme to gange, og to kald kan komme i omvendt rækkefølge — brug occurred_at og bookingens id til at holde styr på det.

Det, I kan se. Hver webhook viser sine seneste 50 leveringer med status. Leveringer slettes efter 14 dage.

Kontakt. Skriv til support@piklobooking.com.

Webhooks koster ingenting i Piklo Booking. De er en del af produktet for alle virksomheder, uanset hvilke tilkøb I har.

Start gratisingen kort, ingen binding