Comment configurer un webhook pour vos rendez-vous
Ajoutez un webhook pour que votre application soit prévenue en temps réel d'un rendez-vous créé, déplacé ou annulé, avec un envoi signé.
Par Équipe ArtiboxPublié le 3 min de lecture
Ce guide s'adresse au propriétaire de l'organisation, seul à voir la carte « Webhooks », et au développeur qui reçoit les envois. Savoir comment configurer un webhook évite d'interroger l'API en boucle : c'est Artibox Calendar qui prévient votre outil dès qu'il se passe quelque chose.
Comment configurer un webhook : prérequis
- La formule Équipe ou plus (tarifs).
- Une adresse de réception en https://, accessible depuis internet. Les adresses du réseau interne sont refusées.
Ajouter un webhook en six étapes
Ouvrir les intégrations
Dans le menu, ouvrez Réglages › Intégrations et repérez la carte « Webhooks ».
Saisir l'adresse
Dans « Adresse de réception (https://) », collez l'adresse de votre application qui recevra les envois.
Limiter à un type si besoin
Dans « Type de rendez-vous », gardez « Tous les types » ou choisissez un seul type.
Cocher les événements
Sous « Événements », cochez ceux qui intéressent votre outil, par exemple reservation.creee et reservation.annulee.
Ajouter et copier le secret
Cliquez sur « Ajouter le webhook ». Le « Secret de signature » s'affiche une seule fois : copiez-le dans votre application.
Tester
Cliquez sur « Envoyer un test » et vérifiez dans « Envois des 30 derniers jours » que l'envoi est « Livré ».
Les événements disponibles
- reservation.creee, reservation.deplacee, reservation.annulee, reservation.constatee (honoré ou absent)
- sondage.vote, sondage.confirme
- envoi_lien.envoye, envoi_lien.reservation_obtenue
- type.cree, type.modifie
- connexion_agenda.a_reconnecter
- routage.soumis (formulaire d'orientation)
Vérifier la signature
Chaque envoi porte un en-tête X-Signature de la forme t=…,v1=…, où v1 est un HMAC-SHA256 calculé avec votre secret sur l'horodatage, un point, puis le corps reçu. Votre application recalcule cette valeur et rejette tout envoi dont la signature ne correspond pas. C'est ce qui garantit que le message vient bien d'Artibox Calendar.
Réessais, désactivation et rejeu
Si votre adresse ne répond pas correctement, l'envoi est réessayé automatiquement, d'une minute à douze heures. Après 20 échecs d'affilée, le webhook est désactivé : vérifiez l'adresse, puis cliquez sur « Réactiver ». Le journal garde les envois des 30 derniers jours, avec leur nombre de tentatives, et « Rejouer » renvoie un envoi précis.
Pour une vue d'ensemble, voir la page API et webhooks, la définition du webhook, ou l'API et les jetons pour agir en retour.
Si quelque chose bloque
Les envois sont en « Échec ». Votre adresse renvoie une erreur ou ne répond pas assez vite. Consultez le journal, corrigez, puis rejouez.
Le webhook est « Désactivé ». Il a cumulé 20 échecs d'affilée, ou vous l'avez désactivé. Réactivez-le une fois l'adresse corrigée.
Questions fréquentes
J'ai perdu le secret de signature. Que faire ?
Il n'est pas réaffiché. Supprimez le webhook puis ajoutez-le de nouveau : un nouveau secret est créé.
Zapier ou Make utilisent-ils ces webhooks ?
Oui, ils créent leurs propres webhooks quand vous les autorisez, marqués « Créé par l'application … ». Voir Zapier et Make.
Vos outils prévenus à chaque rendez-vous
Essayez la formule Équipe gratuitement pendant 14 jours.
Créer mon compteÀ lire aussi
- Intégrations
Utiliser l'API et les jetons personnels
Créez un jeton personnel, choisissez ses portées et appelez l'API d'Artibox Calendar depuis vos propres outils, en votre nom.
- Intégrations
Connecter Zapier et Make
Branchez vos rendez-vous à des centaines d'outils sans écrire de code : déclencheurs et actions Artibox Calendar dans vos Zaps et vos scénarios Make.
- Intégrations
Connecter HubSpot, Salesforce ou Pipedrive
Reliez HubSpot, Salesforce ou Pipedrive : chaque rendez-vous crée ou met à jour le contact et ajoute une réunion dans votre CRM, sans double saisie.