Aller au contenu
Intégrations

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 Publié 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

  1. Ouvrir les intégrations

    Dans le menu, ouvrez Réglages › Intégrations et repérez la carte « Webhooks ».

  2. Saisir l'adresse

    Dans « Adresse de réception (https://) », collez l'adresse de votre application qui recevra les envois.

  3. Limiter à un type si besoin

    Dans « Type de rendez-vous », gardez « Tous les types » ou choisissez un seul type.

  4. Cocher les événements

    Sous « Événements », cochez ceux qui intéressent votre outil, par exemple reservation.creee et reservation.annulee.

  5. Ajouter et copier le secret

    Cliquez sur « Ajouter le webhook ». Le « Secret de signature » s'affiche une seule fois : copiez-le dans votre application.

  6. 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
Cet article vous a-t-il aidé ?

À 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.