Un webhook est un procédé non standardisé de communication automatique entre services web. Techniquement, un webhook est une requête HTTP POST envoyée automatiquement à une URL prédéfinie dès qu'un événement déterminé se produit.
Fonctionnement
- L'exploitant configure une URL de destination (par exemple son propre système ou Zapier/Make)
- Lors d'un événement de réservation (nouvelle réservation, modification, annulation), le système de prise de rendez-vous envoie automatiquement une requête POST contenant les données de réservation (généralement au format JSON)
- Le système destinataire traite les données et peut y réagir
Types d'événements pris en charge
- Nouvelle réservation (
new_appointment) - Réservation annulée (
cancelled_appointment) - Réservation reportée/modifiée (
rescheduled_appointment)
Sécurité
- Clé secrète facultative (Secret Key), transmise dans l'en-tête HTTP
X-Schedule-Organizer-Secret - Le type d'événement est transmis dans l'en-tête
X-Schedule-Organizer-Event - Le point de terminaison destinataire doit répondre avec HTTP 200
Cas d'utilisation
- Reprise automatique des réservations dans un système CRM
- Déclencheur d'automatisations dans Zapier, Make (anciennement Integromat) ou n8n
- Synchronisation en temps réel avec vos propres systèmes backend
- Notifications dans Slack ou Teams