Un webhook è una procedura non standardizzata per la comunicazione automatica tra servizi web. Dal punto di vista tecnico un webhook è una richiesta HTTP POST inviata automaticamente a un URL predefinito non appena si verifica un determinato evento.
Funzionamento
- Il gestore configura un URL di destinazione (ad es. un sistema proprio oppure Zapier/Make)
- In caso di evento di prenotazione (nuova prenotazione, modifica, cancellazione) il sistema di prenotazione appuntamenti invia automaticamente una richiesta POST con i dati della prenotazione (tipicamente in formato JSON)
- Il sistema ricevente elabora i dati e può reagire di conseguenza
Tipi di evento supportati
- Nuova prenotazione (
new_appointment) - Prenotazione cancellata (
cancelled_appointment) - Prenotazione spostata/modificata (
rescheduled_appointment)
Sicurezza
- Chiave segreta facoltativa (secret key), inviata nell'header HTTP
X-Schedule-Organizer-Secret - Il tipo di evento viene trasmesso nell'header
X-Schedule-Organizer-Event - L'endpoint di destinazione deve rispondere con HTTP 200
Casi d'uso
- Trasferimento automatico delle prenotazioni in un sistema CRM
- Trigger per automazioni in Zapier, Make (in precedenza Integromat) o n8n
- Sincronizzazione in tempo reale con i propri sistemi di backend
- Notifiche in Slack o Teams