Barberly heeft nu een openbare Booking API. Daarmee kunnen uw eigen website, app, WhatsApp-bot, spraakagent of AI-assistent boekingen voor uw barbershop aannemen, met dezelfde diensten, hetzelfde team, dezelfde beschikbaarheid en dezelfde boekingsregels die uw klanten al in uw Barberly-app zien.
Wat u kunt bouwen met een boekings-API voor barbershops
- WhatsApp: boeken in de chat die klanten al gebruiken
- AI-assistenten: boeken op basis van uw echte beschikbaarheid
- Spraakagenten: telefonische boekingen, geautomatiseerd
- Websites: uw eigen boekingsflow, in uw eigen huisstijl
- Chatbots: een boekingsstap in elke chatwidget
- Eigen integraties: al het andere dat een boeking maakt
Hij boekt zoals uw klanten boeken
De Booking API is nog een hulpmiddel voor klanten, naast uw app, uw website, de boekingswidgets, de kiosk en boeken via Google. Het is geen back-office-API. Hij geeft geen toegang tot rapporten, teambeheer of instellingen.
Alles wat u voor uw eigen boekingspagina hebt ingesteld, geldt ongewijzigd:
- Een tijdslot dat gesloten is voor klanten, is ook gesloten in de API. De beschikbaarheid toont de klantweergave van uw agenda, nooit die van het team.
- Als u afspraken handmatig goedkeurt, komen boekingen via de API ook onbevestigd binnen.
- Als u een geregistreerde klant vereist, vereist de API dat ook.
- Werktijden, minimale boekingstermijn, duur van diensten en welke kapper wat doet, worden live uit uw instellingen gelezen.
De API bedenkt geen eigen regels en kan er geen omzeilen.
Wat de Booking API dekt
- Catalogus: vestigingen, teamleden, diensten met extra's
- Beschikbaarheid: vrije dagen en tijdsloten, per vestiging, kapper en dienst
- Boekingen: maken, opvragen, verzetten en annuleren
- Klantaccounts: registreren, inloggen en wachtwoord herstellen
API-sleutels en rechten
Stel eerst uw vestigingen, team, diensten en werktijden in Barberly in. De API leest die configuratie, hij maakt die niet aan. Maak daarna in het Barberly-portaal een sleutel aan onder Apps → Booking API → Create key en geef hem alleen de rechten die hij nodig heeft:
| Recht | Staat toe |
|---|---|
catalog:read | Vestigingen, teamleden, diensten, beschikbaarheid |
bookings:read | Een boeking opvragen |
bookings:write | Boekingen maken, wijzigen en annuleren |
accounts:write | Klantaccounts registreren, laten inloggen en herstellen |
Stuur de sleutel mee in de header X-Api-Key. Sleutels kunt u op hetzelfde scherm intrekken of verwijderen.
Probeer de live demo's
Twee werkende boekingsflows voor gasten draaien op een openbare demozaak en tonen meteen echte gegevens. Beide gaan langs vestiging, kapper, diensten met extra's, datum en tijd, gegevens van de gast en bevestiging, zonder in te loggen.
- Appointment hub: één kaart met vier velden die de gast in willekeurige volgorde invult
- Guided wizard: vijf stappen met een voortgangsbalk
De broncode staat op GitHub: React-voorbeelden die u kunt lezen, kopiëren of in uw eigen project gebruiken.
Documentatie
- API-referentie: elk endpoint en elk veld
- OpenAPI-document: genereer een client in uw programmeertaal
Veelgestelde vragen
Kost de Booking API extra?
Nee. De Booking API zit in uw Barberly-abonnement. Er zijn geen extra kosten.
Ik ben geen ontwikkelaar. Hoe laat ik een integratie bouwen?
Geef ChatGPT, Claude of een andere AI-agent de link naar de API-referentie en beschrijf wat u wilt. Binnen een paar minuten hebt u een werkende basis om mee te beginnen.
Kan ik hem koppelen aan n8n, Make of Zapier?
Ja. Elke tool die een HTTP-verzoek met een header kan sturen, kan de API aanroepen: de HTTP Request-node in n8n, de HTTP-module in Make of een eigen verzoek in Zapier. Deze tools kunnen boekingen maken, verzetten en annuleren. Ze kunnen niet reageren op wijzigingen in Barberly zelf, omdat de API nog geen webhooks heeft.
Kan een spraakagent of ChatGPT er afspraken mee boeken?
Ja. Spraakplatforms zoals Vapi of Retell roepen externe API's aan als tools, en een eigen GPT in ChatGPT kan het OpenAPI-document importeren en uw sleutel in de header meesturen. De huidige API is voor beide voldoende.
Krijgen klanten de gebruikelijke boekingsbevestigingen?
Ja. Boekingen via de API sturen dezelfde meldingen die u voor uw app en website hebt ingesteld.
En aanbetalingen en vooruitbetalingen?
De Booking API neemt geen betalingen aan. Hebt u een aanbetaling of vooruitbetaling nodig, ontvang die dan eerst in uw eigen flow en maak daarna de boeking via de API.
Kan ik zien welke boekingen via de API binnenkwamen?
Ja. In de geschiedenis van de afspraak staat een boeking via de API als gemaakt via de Booking API, zoals andere boekingen de app of de website tonen.
Komen klanten die via de API boeken in mijn klantenbestand?
Ja. Ze worden net als iedereen aan uw klanten toegevoegd en sparen loyaliteitspunten zodra de boeking als voltooid is gemarkeerd.
Is er een testmodus?
Nee. Annuleer tijdens het bouwen de testboekingen die u maakt.
Weet mijn systeem het als een boeking in Barberly verandert?
Niet automatisch: er zijn nog geen webhooks. Om een boeking te controleren, vraagt u hem opnieuw op via zijn ID.
Ik heb meerdere vestigingen. Heb ik voor elke vestiging een sleutel nodig?
Nee. Eén sleutel werkt voor al uw vestigingen. Net als in uw app en op uw website kiest de klant de vestiging bij het boeken.
Werkt de Booking API met inloopklanten of de wachtlijst?
Nee. Hij is voor boekingen: afspraken maken, opvragen, verzetten en annuleren. De inloopwachtrij en de wachtlijst lopen via de kiosk en de Barberly Business-app.
