Les webhooks

Un webhook prévient votre serveur quand quelque chose change. Service envoie une requête POST au point de terminaison que vous déclarez lorsque les réservations ou les clients de cet établissement changent. La section Webhooks vit dans l’espace Développeurs.

Paramètres → Développeurs

Comme les clés d’API, les webhooks relèvent de l’espace Développeurs et de l’offre Premium — voir Les clés d’API pour l’accès et l’offre.

BureauMobile

Ajouter un point de terminaison

Le bouton Ajouter un point de terminaison ouvre un panneau avec :

• URL du point de terminaison — l’adresse qui reçoit les requêtes. Elle doit être en HTTPS.
• Description — facultative, pour vous repérer.
• Événements à envoyer — choisissez des types précis, groupés en Réservations, Options, Liste d’attente, Clients et Avis, ou cochez Envoyer tous les types d’événements (y compris les futurs). Les Options sont les tables qu’un système connecté retient via l’API le temps qu’un client se décide.
• Actif — un point de terminaison inactif ne reçoit rien.

La version de l’API du point de terminaison est fixée à sa création. À la validation, un secret de signature s’affiche.

Le secret de signature

Chaque envoi porte un en-tête Service-Signature. Le secret de signature sert à vérifier cet en-tête sur votre serveur, pour confirmer que la requête vient bien de Service. Sur la page du point de terminaison, Afficher révèle le secret et Renouveler le secret en génère un nouveau. Le renouvellement interrompt la vérification tant que vous n’avez pas mis à jour le secret sur votre serveur.

Suivre les envois

Chaque ligne indique le point de terminaison, ses événements (ou Tous), son Statut et son dernier envoi. Ouvrez un point de terminaison pour voir l’historique de ses envois et, avec Envoyer un test, déclencher un événement de test vers votre serveur.

Un point de terminaison a trois statuts :

• Activé — les envois partent normalement.
• Désactivé — vous l’avez mis en pause.
• Désactivé automatiquement — Service l’a coupé après plusieurs échecs d’envoi. Réactivez-le une fois votre serveur prêt.

Le menu d’actions propose Modifier, Désactiver ou Activer, et Supprimer. Supprimer un point de terminaison arrête ses envois et efface son historique ; l’action est irréversible.

Le contenu des événements

La gestion des points de terminaison se fait ici. Le contenu de chaque événement et la vérification de la signature relèvent de la documentation de l’API — notamment le catalogue des événements et la vérification de la signature. Vous y accédez aussi depuis Service, par le même lien que pour les clés, tout en haut de l’écran Développeurs.