Barberly dispose désormais d'une Booking API publique. Grâce à elle, votre site, votre application, votre bot WhatsApp, votre agent vocal ou votre assistant IA peuvent prendre des réservations pour votre barbershop, avec les mêmes prestations, la même équipe, les mêmes disponibilités et les mêmes règles de réservation que vos clients voient déjà dans votre application Barberly.
Ce que vous pouvez construire avec une API de réservation pour barbershop
- WhatsApp : réserver dans la conversation que vos clients utilisent déjà
- Assistants IA : réserver selon vos vraies disponibilités
- Agents vocaux : réservations par téléphone, automatisées
- Sites web : votre propre parcours de réservation, à votre image
- Chatbots : une étape de réservation dans n'importe quel widget de chat
- Intégrations sur mesure : tout autre outil qui crée une réservation
Elle réserve comme vos clients réservent
La Booking API est un outil client de plus, à côté de votre application mobile, de votre site, des widgets de réservation, du kiosque et de la réservation Google. Ce n'est pas une API de back-office. Elle n'ouvre ni les rapports, ni la gestion de l'équipe, ni les réglages.
Tout ce que vous avez configuré pour votre propre page de réservation s'applique tel quel :
- Un créneau fermé aux clients est aussi fermé dans l'API. Les disponibilités montrent la vue client de votre agenda, jamais la vue équipe.
- Si vous validez les rendez-vous à la main, les réservations faites via l'API arrivent aussi non confirmées.
- Si vous exigez un client inscrit, l'API l'exige aussi.
- Horaires, délais de réservation, durées des prestations et qui fait quoi sont lus en direct dans vos réglages.
L'API n'invente aucune règle et ne peut en contourner aucune.
Ce que couvre la Booking API
- Catalogue : établissements, membres de l'équipe, prestations avec options
- Disponibilités : jours et créneaux libres, par établissement, barbier et prestation
- Réservations : créer, consulter, déplacer et annuler
- Comptes clients : inscription, connexion et réinitialisation du mot de passe
Clés API et permissions
Configurez d'abord vos établissements, votre équipe, vos prestations et vos horaires dans Barberly. L'API lit cette configuration, elle ne la crée pas. Créez ensuite une clé dans le portail Barberly sous Apps → Booking API → Create key, en ne lui donnant que les permissions nécessaires :
| Permission | Autorise |
|---|---|
catalog:read | Établissements, membres de l'équipe, prestations, disponibilités |
bookings:read | Consulter une réservation |
bookings:write | Créer, modifier et annuler des réservations |
accounts:write | Inscrire, connecter et récupérer des comptes clients |
Envoyez la clé dans l'en-tête X-Api-Key. Les clés peuvent être révoquées ou supprimées sur le même écran.
Essayez les démos en ligne
Deux parcours de réservation invité fonctionnent sur un barbershop de démonstration public et affichent tout de suite de vraies données. Les deux passent par l'établissement, le barbier, les prestations avec options, la date et l'heure, les coordonnées et la confirmation, sans connexion.
- Appointment hub : une carte avec quatre champs à remplir dans n'importe quel ordre
- Guided wizard : cinq étapes avec une barre de progression
Le code source est sur GitHub : des exemples React à lire, copier ou reprendre dans votre propre projet.
Documentation
- Référence de l'API : chaque endpoint et chaque champ
- Document OpenAPI : générez un client dans votre langage
Questions fréquentes
La Booking API est-elle payante en plus ?
Non. La Booking API est incluse dans votre abonnement Barberly. Aucun frais supplémentaire.
Je ne suis pas développeur. Comment faire réaliser une intégration ?
Donnez à ChatGPT, Claude ou un autre agent IA le lien vers la référence de l'API et décrivez ce que vous voulez. En quelques minutes, vous aurez une implémentation fonctionnelle comme point de départ.
Puis-je la connecter à n8n, Make ou Zapier ?
Oui. Tout outil capable d'envoyer une requête HTTP avec un en-tête peut appeler l'API : le nœud HTTP Request dans n8n, le module HTTP dans Make ou une requête personnalisée dans Zapier. Ces outils peuvent créer, déplacer et annuler des réservations. Ils ne peuvent pas réagir aux changements faits dans Barberly, car l'API n'a pas encore de webhooks.
Un agent vocal ou ChatGPT peut-il prendre des rendez-vous avec ?
Oui. Les plateformes vocales comme Vapi ou Retell appellent des API externes comme outils, et un GPT personnalisé dans ChatGPT peut importer le document OpenAPI et envoyer votre clé dans l'en-tête. L'API actuelle suffit pour les deux.
Les clients reçoivent-ils les confirmations habituelles ?
Oui. Les réservations faites via l'API envoient les mêmes notifications que celles configurées pour votre application mobile et votre site.
Et les acomptes et prépaiements ?
La Booking API n'encaisse pas de paiements. Si vous avez besoin d'un acompte ou d'un prépaiement, encaissez-le d'abord dans votre propre parcours, puis créez la réservation via l'API.
Puis-je voir quelles réservations viennent de l'API ?
Oui. Dans l'historique du rendez-vous, une réservation faite via l'API est indiquée comme créée via la Booking API, comme les autres indiquent l'application mobile ou le site.
Les clients qui réservent via l'API rejoignent-ils ma base clients ?
Oui. Ils sont ajoutés à vos clients comme tout le monde et gagnent des points de fidélité quand la réservation est marquée comme terminée.
Y a-t-il un mode test ?
Non. Pendant le développement, annulez les réservations de test que vous créez.
Mon système saura-t-il si une réservation change dans Barberly ?
Pas automatiquement : il n'y a pas encore de webhooks. Pour vérifier une réservation, consultez-la à nouveau par son ID.
J'ai plusieurs établissements. Me faut-il une clé pour chacun ?
Non. Une seule clé fonctionne pour tous vos établissements. Comme dans votre application et sur votre site, le client choisit l'établissement en réservant.
La Booking API gère-t-elle les clients sans rendez-vous ou la liste d'attente ?
Non. Elle sert aux réservations : créer, consulter, déplacer et annuler des rendez-vous. La file d'attente sans rendez-vous et la liste d'attente passent par le kiosque et l'application Barberly Business.
