Webhooks

Eine Adresse von Ihnen, die bei jedem Ereignis in Piklo aufgerufen wird.

2 Min. Lesezeit ·

Was das ist. Unter Einstellungen → Integrationen fügt der Inhaber oder ein Admin eine https-Adresse hinzu und wählt die Ereignisse. Piklo sendet dann bei jedem Ereignis einen POST-Aufruf mit einem kleinen JSON-Body. Nutzen Sie ihn mit Zapier, Make oder Ihrem eigenen System. Ein Unternehmen kann bis zu drei Webhooks haben.

Die Ereignisse.

  • booking.created — ein Kunde hat gebucht oder eine reservierte Buchung wurde bezahlt
  • booking.cancelled — ein Kunde hat storniert
  • booking.rescheduled — ein Kunde hat seinen Termin verschoben
  • client.created — durch eine Buchung entstand ein neuer Kunde
  • review.received — ein Kunde hat Sterne vergeben
  • membership.started — eine Mitgliedschaft wurde bezahlt und begann
  • ping — wird über „Test senden“ ausgelöst

Auch Buchungen, Kunden und Mitgliedschaften, die Sie im Dashboard anlegen, werden gesendet.

Form eines Aufrufs. Jeder Aufruf enthält Ereignis, Zeitpunkt, Unternehmen und Daten.

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

Kundendaten nur auf Wunsch. Name, E-Mail, Telefon, Preis und Bewertungskommentar werden nur gesendet, wenn „Kundendaten senden“ aktiviert ist. Dann enthält data auch client und price. Die Option ist standardmäßig aus, weil Sie nach der DSGVO für die Verwendung beim Empfänger verantwortlich sind.

Signatur prüfen. Jeder Aufruf trägt X-Piklo-Signature: sha256=… — einen HMAC-SHA256 des unveränderten Bodys mit dem bei der Einrichtung angezeigten Geheimnis.

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

Prüfen Sie vor dem Parsen gegen den Body in seiner ursprünglichen Form. X-Piklo-Event enthält zusätzlich den Ereignisnamen.

Antwort. Antworten Sie innerhalb von 5 Sekunden mit einem beliebigen 2xx-Status. Andernfalls folgen Wiederholungen nach 1, 5 und 30 Minuten. Nach 10 Fehlern in Folge wird der Webhook deaktiviert. Aufrufe können doppelt oder in anderer Reihenfolge eintreffen; verwenden Sie occurred_at und die Buchungs-ID.

Sichtbarkeit. Jeder Webhook zeigt die letzten 50 Zustellungen mit Status. Sie werden nach 14 Tagen gelöscht.

Kontakt. Schreiben Sie an support@piklobooking.com.

Webhooks kosten in Piklo Booking nichts und gehören für jedes Unternehmen zum Produkt.