Webhooks

En adress hos dig som anropas varje gång något händer i Piklo.

2 min läsning ·

Vad det är. Under Inställningar → Integrationer lägger ägaren eller en administratör till en https-adress och väljer händelser. Piklo skickar då ett POST-anrop med en liten JSON-kropp. Använd det med Zapier, Make eller ditt eget system. Ett företag kan ha upp till tre webhooks.

Händelserna.

  • booking.created — en kund bokade eller en reserverad bokning betalades
  • booking.cancelled — en kund avbokade
  • booking.rescheduled — en kund flyttade sin tid
  • client.created — en bokning skapade en ny kund
  • review.received — en kund gav ett betyg
  • membership.started — ett medlemskap betalades och började
  • ping — skickas när du väljer ”Skicka test”

Bokningar, kunder och medlemskap som du skapar i dashboarden skickas också.

Så ser ett anrop ut. Varje anrop innehåller händelse, tidpunkt, företag och data.

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

Kunduppgifter bara när du ber om dem. Namn, e-post, telefon, pris och omdömeskommentar skickas bara när ”Skicka kunduppgifter” är valt. Då innehåller data också client och price. Det är avstängt från början eftersom du ansvarar enligt GDPR för hur mottagaren använder uppgifterna.

Kontrollera signaturen. Varje anrop har X-Piklo-Signature: sha256=… — en HMAC-SHA256 av den råa kroppen med hemligheten som visades vid konfigureringen.

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

Kontrollera signaturen innan kroppen parsas. X-Piklo-Event innehåller också händelsens namn.

Svar. Svara med valfri 2xx-status inom 5 sekunder. Annars försöker Piklo igen efter 1, 5 och 30 minuter. Efter 10 fel i rad stängs webhooken av. Anrop kan komma dubbelt eller i annan ordning; använd occurred_at och bokningens id.

Det du kan se. Varje webhook visar de senaste 50 leveranserna med status. De raderas efter 14 dagar.

Kontakt. Skriv till support@piklobooking.com.

Webhooks kostar inget i Piklo Booking och ingår för alla verksamheter.