Come configurare i Webhook in Koalendar

Utilizza i webhook per ricevere aggiornamenti in tempo reale: vengono inviate richieste POST quando qualcuno fissa, modifica o cancella un appuntamento sulla tua pagina di prenotazione.

Questo è utile se stai creando automazioni personalizzate utilizzando piattaforme come Zapier, Make (Integromat), n8n, o il tuo codice backend.

Passo 1: Crea il tuo Webhook Endpoint

Apri l'editor della tua pagina di prenotazione
Scorri fino alla sezione " Dopo la prenotazione "
Inserisci il tuo Webhook URL endpoint (la destinazione per le richieste POST)

Fase 2: Test e automazione

Effettua una prenotazione di prova, riprogramma o annulla per attivare un Webhook
Controlla i log del tuo server o lo strumento Webhook per confermare la ricezione del POST
Ogni carico utile comprende:
- Tipo di evento:
  - evento.creato – quando qualcuno prenota un appuntamento
  - evento (provvisorio) – quando qualcuno effettua una prenotazione provvisoria
  - evento rinviato – quando un invitato modifica l'orario della prenotazione
  - evento annullato – quando un invitato annulla il proprio appuntamento
- Dettagli della prenotazione (nome, e-mail, località, ora di inizio, ora di fine, ecc.)
- L'invitato risponde tramite campi dell'invitato —con gli ID e i valori delle domande

Puoi utilizzarlo per:

Attivare e-mail o avvisi interni
Aggiorna il tuo CRM o il tuo database
Sincronizza i dati tra le app tramite Zapier o logica personalizzata

Esempio di payload

L'oggetto invitee.fields contiene le risposte alle domande che poni nel tuo Modulo di prenotazione.

La chiave dell'oggetto èl'ID della domanda, che puoi trovare quando modifichi una domanda (in alto):

ℹ️ Domande frequenti

Quali eventi attivano un Webhook?

evento.creato , evento (provvisorio) , evento rinviato , e evento annullato

Posso usare Zapier con i webhooks?

Sì! I Webhook possono essere utilizzati per attivare azioni di Zapier o qualsiasi piattaforma di integrazione che accetta richieste POST. Leggi la nostra guida su Zapier.

Cosa succede se il mio Webhook fallisce?

Koalendar ritenterà se il tuo endpoint è temporaneamente irraggiungibile o restituisce un errore.

Posso aggiornare o rimuovere il mio Webhook in seguito?

Sì. Basta tornare alle impostazioni del Webhook nell'editor della tua pagina di prenotazione.