Webhooks

Une adresse chez vous, appelée chaque fois qu'un événement se produit dans Piklo.

2 min de lecture ·

Ce que c'est. Dans Paramètres → Intégrations, le propriétaire ou un administrateur ajoute une adresse https et choisit les événements. Piklo envoie alors un appel POST avec un petit corps JSON. Utilisez-le avec Zapier, Make ou votre propre système. Une entreprise peut avoir jusqu'à trois webhooks.

Les événements.

  • booking.created — un client a réservé ou une réservation retenue a été payée
  • booking.cancelled — un client a annulé
  • booking.rescheduled — un client a déplacé son rendez-vous
  • client.created — une réservation a créé un nouveau client
  • review.received — un client a donné une note
  • membership.started — un abonnement a été payé et a commencé
  • ping — envoyé avec « Envoyer un test »

Les réservations, clients et abonnements créés dans le tableau de bord sont également envoyés.

Forme d'un appel. Chaque appel contient l'événement, l'heure, l'entreprise et les données.

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

Données client uniquement sur demande. Le nom, l'e-mail, le téléphone, le prix et le commentaire ne sont envoyés que si « Envoyer les données client » est activé. data contient alors aussi client et price. L'option est désactivée par défaut, car vous êtes responsable au titre du RGPD de l'utilisation par le destinataire.

Vérifier la signature. Chaque appel porte X-Piklo-Signature: sha256=… — un HMAC-SHA256 du corps brut avec le secret affiché lors de la configuration.

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

Vérifiez avant d'analyser le corps. X-Piklo-Event contient aussi le nom de l'événement.

Réponse. Répondez avec un statut 2xx sous 5 secondes. Sinon Piklo réessaie après 1, 5 et 30 minutes. Après 10 échecs consécutifs, le webhook est désactivé. Les appels peuvent être doublés ou arriver dans un autre ordre ; utilisez occurred_at et l'identifiant de réservation.

Visibilité. Chaque webhook affiche ses 50 dernières livraisons et leur statut. Elles sont supprimées après 14 jours.

Contact. Écrivez à support@piklobooking.com.

Les webhooks sont gratuits dans Piklo Booking et inclus pour toutes les entreprises.