Come configurare i Webhook in Koalendar

Usa i Webhook per ricevere aggiornamenti in tempo reale: le richieste POST vengono inviate quando qualcuno prenota, riprogramma o annulla 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 il tuo Editor della Pagina di Prenotazione
Scorri fino alla sezione Dopo la prenotazione
Inserisci il tuo Webhook URL endpoint (la destinazione per le richieste POST)

Passo 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 payload include:
- Tipo di evento:
  - event.created – quando qualcuno prenota un appuntamento
  - event.tentative – quando qualcuno effettua una prenotazione provvisoria
  - event.rescheduled – quando un invitato modifica l'orario della prenotazione
  - event.canceled – quando un invitato annulla il proprio appuntamento
- Dettagli della prenotazione (nome, email, luogo, ora di inizio, ora di fine, ecc.)
- Risposte dell'invitato tramite invitee.fields —con gli ID delle domande e i valori

Puoi usarlo per:

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

Payload di esempio

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?

event.created , event.tentative , event.rescheduled , e event.canceled

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.