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

🛠️ Webhook non reçu ou en retard ?

• Page de réservation concernée : chaque page de réservation dispose de sa propre URL de webhook. Vérifiez qu'elle est bien configurée sur la page qui a reçu la réservation et que vous avez bien enregistré la page.
• URL complète : saisissez l'adresse complète, en commençant par https:// . Une URL non valide est ignorée.
• Répondez rapidement : Votre point de terminaison doit accepter un PUBLICATION  avec un corps JSON et renvoyer une réponse avec un 2xx  statut. En cas de délai d'expiration ou d'erreur, Koalendar réessaie plus tard, ce qui explique que le webhook arrive avec un certain retard.
• Aucun obstacle : assurez-vous qu'aucun système d'authentification, pare-feu ou filtre IP ne bloque les requêtes adressées à votre point de terminaison.
• Testez la transmission : collez une URL temporaire générée par un outil tel que webhook.site, effectuez une réservation test et vérifiez que la requête est bien reçue.

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