Configurer les Webhooks

Le Webhooks La fonctionnalité de Bookablesites vous permet d'envoyer des données d'événements en temps réel de la plateforme à des applications externes via des URL personnalisées. Utilisez-le pour automatiser les notifications et transférer les données de réservation vers d'autres systèmes pour des intégrations rationalisées.

Le Webhooks La fonctionnalité pour Bookablesites est une option premium et comptera dans vos fonctionnalités et intégrations personnalisées totales.

Commencer

  • Activer Webhooks sur le Fonctionnalités et intégrations page.
  • Après l’activation, cliquez sur Configurer pour ouvrir la page de gestion des webhooks. Au départ, il n'y aura pas de webhooks, alors créez-en de nouveaux à l'aide du bouton Créer un webhook en haut à droite

Types d'événements webhook disponibles Vous pouvez créer un webhook pour chacun de ces événements. Cliquez sur le “créer un webhook“:

  • Rendez-vous réservé
  • Rendez-vous annulé
  • Rendez-vous reporté
  • Statut de nomination modifié
  • Client Créé
Capture d'écran d'un tableau de bord Web montrant la section Webhooks sous Fonctionnalités et intégrations, avec des options pour ajouter des URL de webhook et un bouton « Créer un Webhook » en surbrillance.

Veuillez noter qu'à ce stade, vous ne pouvez créer qu'un seul webhook pour chaque type. Cela signifie qu'il ne peut y avoir qu'un seul webhook ‘Rendez-vous pris’, un seul webhook ‘Rendez-vous annulé’, et ainsi de suite.

Options de configuration Lors de la création d'un webhook, vous pouvez définir :

  • Nom — une étiquette descriptive pour le webhook.
  • URL du site Web — le point de terminaison où les sites réservables PUBLIERONT la charge utile de l'événement.

Testez et chargez vos Webhooks :

Envoyer un webhook de test envoie des exemples de données à l'URL configurée afin que vous puissiez vérifier la charge utile et le mappage. La charge utile de test comprend des détails tels que :

  • Statut du rendez-vous, dates et heures de début/fin, date/heure de début/fin combinée
  • Prix du rendez-vous
  • Nom complet du client, prénom, nom, email, téléphone
  • Nom complet de l'employé, prénom, nom, e-mail, téléphone
  • Catégorie de service, nom, durée, prix
  • Extras
  • Nom de l'emplacement, adresse, téléphone
  • Champs personnalisés

Cela vous permet de vous assurer que le webhook est correctement configuré pour envoyer les informations nécessaires à vos besoins d'intégration.

Notes

Vous ne pouvez créer qu'un seul webhook par type d'événement (par exemple, un seul webhook de prise de rendez-vous).

Le formatage de la charge utile suit les paramètres que vous avez choisis dans les sites de réservation. Les événements sont diffusés via HTTP POST demandes.

Sécurité

Jeton de vérification cliquez sur le bouton Jeton de vérification (près de Créer un Webhook) pour afficher et copier votre jeton. Lorsqu'il est inclus dans l'en-tête d'autorisation de chaque demande de webhook, ce jeton vous permet d'authentifier les demandes entrantes et de confirmer qu'elles proviennent de Bookablesites.

Une page Web affiche une fenêtre contextuelle “Jeton de vérification” avec une chaîne de jeton et des options pour copier le jeton ou fermer la fenêtre contextuelle ; les paramètres du webhook sont visibles en arrière-plan.

Exemples et intégrations

Intégrateurs tiers tels que Bavarde et KonnectzIT j'ai créé des intégrations à l'aide des webhooks Bookablesites, démontrant comment vous pouvez connecter la plateforme à des outils d'automatisation et de flux de travail externes.