belbo
  • Vue d'ensemble
    • Découvrir Belbo
    • Paramètres de l'établissement
    • Passage à Belbo
    • Vue calendaire & Navigation
    • Rendez-vous récurrents & cours
    • Saisie et gestion des rendez-vous
    • Tâches
    • Aperçu
    • Plusieurs sites & siège social
    • Gérer les collaborateurs
    • Connexions
    • Droits
    • Aperçu
    • Absences & Jours fériés
    • Horaires de travail
    • Enregistrement du temps de travail
    • Aperçu
    • Protection des données (RGPD)
    • Communication client (e-mail, SMS)
    • Gestion des clients & Fichier clients
    • Aperçu
    • Programmes de bonus & de fidélité
    • Campagnes (Newsletter & SMS)
    • Autorisations marketing (RGPD)
    • Suivi & Analyse
    • Aperçu
    • Prestations & Tarifs
    • Forfaits de prestations & Abonnements
    • Bons cadeaux
    • Produits
    • Achat & Fournisseurs
    • Stocks & Inventaire
    • Numérisation et vente
    • Coût des marchandises et dépenses
    • Aperçu
    • Configuration & paramètres
    • Conception
    • Textes
    • Intégration (site web, Google, Instagram, Facebook)
    • Paiement en ligne
    • Aperçu
    • Comptabilité & Exports
    • Paramètres de caisse
    • Procédure d'encaissement
    • Clôture de caisse & Rapports
    • TSE & Règlement sur la sécurisation des caisses enregistreuses
    • Aperçu
    • Aperçu des exportations
    • Taux d'occupation des employés
    • Chiffre d'affaires & Analyses
    • Belbo Satellite
    • Imprimante
    • Terminal EC & Paiement par carte
    • Dépannage matériel
    • Scanners et caisses enregistreuses
    • Paramètres généraux
    • API & Intégrations
    • Notifications & e-mails
    • Contrats & Aspects juridiques
Skip to content
Paramètres & Administration›API & Intégrations

Interfaces API

Fonction : Général › Accès aux API › Paramètres

Vous pouvez coupler Belbo de différentes manières avec d'autres produits logiciels. En plus des intégrations prêtes à l'emploi que vous pouvez simplement activer via la liste des fonctionnalités, comme la synchronisation du calendrier avec Google, vous pouvez également créer des réservations par programmation et interroger des données.

Nous distinguons deux types de données :

Données publiques

Horaires d'ouverture, prestations ainsi que disponibilités des prestations et des collaborateurs. Vous pouvez interroger ces données sans clé via l'API REST.

Données sensibles

Données de calendrier et données clients. Pour les interroger, vous avez besoin d'une clé API.

Vous la créez dans votre calendrier sous les paramètres globaux en tant qu'accès API.

Documentation REST-API Tous les points d'accès disponibles, paramètres et exemples de réponses – régulièrement mis à jour chez Postman.
Ouvrir la documentation

Une fois que vous avez créé un accès API, vous pouvez effectuer des requêtes à l'aide du token. En principe, tous les interfaces se trouvent sous l'URL avec la structure suivante :

Structure de l'URL d'interface https://<VotreEntreprise>.belbo.com/office/api/<Nom>?token=<Token>

Webhooks

En plus de l'interrogation active des données, vous pouvez également entrer des webhooks dans la fonction API. Un webhook inverse le sens : votre système n'a pas besoin de demander régulièrement s'il y a quelque chose de nouveau – Belbo se manifeste de lui-même.

Événement se produit Par exemple une nouvelle réservation dans Belbo.
Belbo envoie Une requête HTTP est immédiatement envoyée à votre URL cible enregistrée.
Votre système réagit CRM, gestion des stocks ou application personnalisée traite les données plus avant.

Vous créez un webhook directement dans la fonction API. Trois informations sont nécessaires pour la définition :

Clé API

Une boîte de sélection avec les accès API créés dans votre calendrier. La clé sélectionnée détermine avec quelles permissions le webhook est déclenché.

Nom interne

Une désignation librement choisie pour distinguer plusieurs webhooks. Elle s'affiche uniquement en interne.

URL absolue

L'adresse cible complète y compris https://, vers laquelle Belbo envoie les événements. Les adresses relatives ne sont pas possibles.

Dialog zur Definition eines Webhooks mit Auswahlbox für den API Schlüssel, internem Namen und absoluter Ziel-URL
Définition d'un webhook dans la fonction API
L'URL cible doit être accessible publiquement de l'extérieur et accepter les demandes par HTTPS. Vous pouvez créer plusieurs webhooks en parallèle, par exemple un pour chaque système connecté.

Quels événements déclenchent un webhook :

Chaque appel porte un type d'événement (event_type). Le type détermine quand Belbo envoie – et quelles données figurent dans la charge utile. Il y a trois types de charge utile : rendez-vous, client et liste d'attente. Les mêmes événements sous-tendent également l'application Zapier.

Charge utileevent_typeEst déclenché
Rendez-vousnew_appointmentUn rendez-vous a été réservé.
new_course_bookingUn cours a été réservé.
voucher_boughtUn bon d'achat a été acheté.
product_boughtUn produit a été vendu.
customer_registeredLe client s'est inscrit au rendez-vous.
customer_checked_inLe client a été enregistré au rendez-vous.
appointment_reminderLe rappel de rendez-vous est dû.
Clientnew_customerUn nouveau client a été créé.
updated_customerLes données client ont été modifiées.
Liste d'attentenew_waitlistUne nouvelle inscription à la liste d'attente a été créée.

Tous les événements liés aux rendez-vous – y compris les ventes et réservations de cours, bons d'achat et produits – fournissent la même structure. Ce qui a été acheté ou réservé figure dans services :

Exemple de charge utile (lié au rendez-vous) { "booking_id": 53429371, "appointment_start": "2026-10-17T07:00:00+0000", "appointment_end": "2026-10-17T07:30:00+0000", "services": [ "Paquet A (Coupe & Brushing)" ], "gender_type": "MALE", "first_name": "Max", "last_name": "Mustermann", "email": "max.mustermann@example.com", "mobile": "123123123" }

Les heures sont au format AAAA-MM-JJ'T'hh:mm:ss+0000, services est toujours une liste (pour plusieurs prestations réservées, elle contient plusieurs entrées). Les événements new_customer et updated_customer envoient à la place des données de rendez-vous uniquement le dossier client, new_waitlist l'inscription à la liste d'attente.

Automatisations avec Zapier

En plus de l'utilisation directe de l'API, Belbo offre également la possibilité d'utiliser des événements de Belbo via une application Zapier et de les traiter de manière automatisée. Via Zapier, vous pouvez vous abonner à des événements typiques et les intégrer dans plus de 6 000 autres applications pour automatiser les flux de travail.

Ces événements sont disponibles en tant que déclencheurs :

  • nouvelles réservations de rendez-vous
  • inscriptions à la liste d'attente
  • modifications ou annulations de rendez-vous
  • nouveaux clients ou mises à jour de données client

Cela permet de déclencher des actions dans d'autres outils :

  • envoi d'e-mails ou SMS
  • entrées dans les systèmes CRM
  • création de tâches dans les outils de gestion de projet
  • synchronisation avec les outils de marketing ou de reporting

Zapier agit ainsi comme un pont entre Belbo et d'autres systèmes et permet des automatisations même sans développement propre. Techniquement, cela repose sur ce qu'on appelle des déclencheurs et des actions qui peuvent être mis en œuvre via des intégrations ou des webhooks.

Application Zapier pour Belbo Invitation à l'application Belbo chez Zapier – vous y activez les événements pour votre propre compte Zapier.
Activer l'application Zapier
Catégories : API & Intégrations
Étiquettes : API, Schnittstellen

Vous avez une question ? Posez-la ici.

Ce manuel est un service de belbo. Mentions légales