Comment configurer les webhooks dans Koalendar

Utilisez les webhooks pour obtenir des mises à jour en temps réel : des requêtes POST sont envoyées lorsque quelqu'un planifie, reprogramme ou annule un rendez-vous sur votre page de réservation.

Cela est utile si vous créez des automatisations personnalisées à l'aide de plateformes telles que Zapier, Make (Integromat), n8n ou votre propre code backend.

Étape 1 : Créez votre point de terminaison Webhook

1. Ouvrez votre éditeur de page de réservation
2. Faites défiler jusqu'à la section Après la réservation.
3. Entrez l'URL de votre point de terminaison webhook (la destination des requêtes POST).

Étape 2 : Tester et automatiser

• Effectuez une réservation test, modifiez la date ou annulez pour déclencher un webhook.
• Inspectez les journaux de votre serveur ou votre outil webhook pour confirmer la réception du POST.
• Chaque charge utile comprend :
  • Type d'événement :
    • événement.créé   – lorsqu'une personne prend rendez-vous
    • événement.provisoire   – lorsqu'une personne effectue une réservation provisoire
    • événement.reporté   – lorsqu'un invité modifie l'heure de réservation
    • événement.annulé   – lorsqu'un invité annule son rendez-vous
  • Détails de la réservation (nom, e-mail, lieu, début, fin, etc.)
  • L'invité répond via invité.champs   —avec les identifiants et les valeurs des questions

Vous pouvez l'utiliser pour :

• Déclencher des e-mails ou des alertes internes
• Mettez à jour votre CRM ou votre base de données
• Synchronisez les données entre les applications via Zapier ou une logique personnalisée.

Exemple de charge utile

Le champinvitee.fieldscontient les réponses aux questions que vous posez dans votre formulaire de réservation.

La clé de l'objet estl'identifiant de la question, que vous pouvez trouver lorsque vous modifiez une question (en haut) :

ℹ️ Foire aux questions

Quels événements déclenchent un webhook ?

événement.créé , événement.provisoire , événement.reporté , et événement.annulé  

Puis-je utiliser Zapier avec les webhooks ?

Oui ! Les webhooks peuvent être utilisés pour déclencher des actions Zapier ou toute plateforme d'intégration qui accepte les requêtes POST. Consultez notre guide Zapier.

Que se passe-t-il si mon webhook échoue ?

Koalendar réessaiera si votre point de terminaison est temporairement inaccessible ou renvoie une erreur.

Puis-je mettre à jour ou supprimer mon webhook ultérieurement ?

Oui. Il suffit de revenir aux paramètres du webhook dans l'éditeur de votre page de réservation.