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.

Passaggio 1: Crea il tuo endpoint webhook

1. Apri l'editor della tua pagina di prenotazione
2. Scorri fino alla sezione " Dopo la prenotazione "
3. Inserisci l'URL dell'endpoint del tuo webhook (la destinazione delle richieste POST)

Fase 2: Test e automazione

• Effettua una prenotazione di prova, modifica la data o cancella la prenotazione per attivare un webhook
• Controlla i log del server o lo strumento webhook per verificare che il POST sia stato ricevuto
• 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 una logica personalizzata

Esempio di payload

Il campo "invited.fields" contiene le risposte alle domande poste nel 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 webhook?

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

Cosa succede se il mio webhook non funziona?

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

Posso aggiornare o rimuovere il mio webhook in un secondo momento?

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