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):

🛠️ Non hai ricevuto il pacco di Webhook o è in ritardo?

Pagina di prenotazione corretta: ogni pagina di prenotazione ha il proprio URL webhook . Verifica che sia impostato sulla pagina in cui è stata effettuata la prenotazione e che tu abbia salvato la pagina.
URL completo: inserisci l'indirizzo completo, iniziando con https:// . Un URL non valido viene ignorato.
Rispondi rapidamente: Il tuo endpoint dovrebbe accettare un POST con un corpo JSON e rispondere con un 2xx stato. Se si verifica un timeout o viene restituito un errore, Koalendar riprova in un secondo momento, quindi l'webhook o arriva in ritardo.
Nessun ostacolo: assicurati che nessun sistema di autenticazione, firewall o filtro IP blocchi le richieste al tuo endpoint.
Verifica il funzionamento: incolla un URL temporaneo generato da uno strumento come webhook.site, effettua una prenotazione di prova e verifica che la richiesta venga ricevuta.

ℹ️ 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.