Barberly hat jetzt eine öffentliche Booking API. Damit können Ihre eigene Website, App, Ihr WhatsApp-Bot, Sprachagent oder KI-Assistent Buchungen für Ihren Barbershop annehmen, mit denselben Leistungen, demselben Team, derselben Verfügbarkeit und denselben Buchungsregeln, die Ihre Kunden bereits in Ihrer Barberly-App sehen.
Was Sie mit einer Buchungs-API für Barbershops bauen können
- WhatsApp: Buchung direkt im Chat, den Ihre Kunden ohnehin nutzen
- KI-Assistenten: Buchung anhand Ihrer echten Verfügbarkeit
- Sprachagenten: Telefonbuchungen, automatisiert
- Websites: Ihr eigener Buchungsablauf, in Ihrem eigenen Design
- Chatbots: ein Buchungsschritt in jedem Chat-Widget
- Eigene Integrationen: alles andere, das eine Buchung erstellt
Sie bucht so, wie Ihre Kunden buchen
Die Booking API ist ein weiteres Tool für Ihre Kunden, neben Ihrer mobilen App, Ihrer Website, den Buchungs-Widgets, dem Kiosk und der Google-Buchung. Sie ist keine Back-Office-API. Sie öffnet keine Berichte, keine Teamverwaltung und keine Einstellungen.
Alles, was Sie für Ihre eigene Buchungsseite eingerichtet haben, gilt unverändert:
- Ein Zeitfenster, das für Kunden geschlossen ist, ist auch in der API geschlossen. Die Verfügbarkeit zeigt die Kundensicht Ihres Kalenders, nie die Mitarbeitersicht.
- Wenn Sie Termine von Hand bestätigen, kommen auch Buchungen über die API unbestätigt an.
- Wenn Sie einen registrierten Kunden verlangen, verlangt die API das ebenfalls.
- Arbeitszeiten, Vorlaufzeiten, Leistungsdauern und welcher Barber was macht, werden live aus Ihren Einstellungen gelesen.
Die API erfindet keine eigenen Regeln und kann keine umgehen.
Was die Booking API abdeckt
- Katalog: Standorte, Teammitglieder, Leistungen mit Zusatzleistungen
- Verfügbarkeit: freie Tage und Zeitfenster, pro Standort, Barber und Leistung
- Buchungen: erstellen, abrufen, verschieben und stornieren
- Kundenkonten: registrieren, anmelden und Passwort zurücksetzen
API-Schlüssel und Berechtigungen
Richten Sie zuerst Ihre Standorte, Ihr Team, Ihre Leistungen und Arbeitszeiten in Barberly ein. Die API liest diese Konfiguration; sie legt sie nicht an. Erstellen Sie dann im Barberly-Portal unter Apps → Booking API → Create key einen Schlüssel und geben Sie ihm nur die Berechtigungen, die er braucht:
| Berechtigung | Erlaubt |
|---|---|
catalog:read | Standorte, Teammitglieder, Leistungen, Verfügbarkeit |
bookings:read | Eine Buchung abrufen |
bookings:write | Buchungen erstellen, ändern und stornieren |
accounts:write | Kundenkonten registrieren, anmelden und wiederherstellen |
Senden Sie den Schlüssel im Header X-Api-Key. Schlüssel lassen sich auf derselben Seite widerrufen oder löschen.
Probieren Sie die Live-Demos aus
Zwei funktionierende Buchungsabläufe für Gäste laufen auf einem öffentlichen Demo-Shop und zeigen sofort echte Daten. Beide führen durch Standort, Barber, Leistungen mit Zusatzleistungen, Datum und Uhrzeit, Gastdaten und Bestätigung, ohne Anmeldung.
- Appointment hub: eine Karte mit vier Feldern, die der Gast in beliebiger Reihenfolge ausfüllt
- Guided wizard: fünf Schritte mit Fortschrittsanzeige
Der Quellcode liegt auf GitHub: React-Beispiele, die Sie lesen, kopieren oder in Ihr eigenes Projekt übernehmen können.
Dokumentation
- API-Referenz: jeder Endpunkt und jedes Feld
- OpenAPI-Dokument: erzeugen Sie einen Client in Ihrer Sprache
Häufige Fragen
Kostet die Booking API extra?
Nein. Die Booking API ist in Ihrem Barberly-Abo enthalten. Es gibt keine zusätzliche Gebühr dafür.
Ich bin kein Entwickler. Wie bekomme ich eine Integration gebaut?
Geben Sie ChatGPT, Claude oder einem anderen KI-Agenten den Link zur API-Referenz und beschreiben Sie, was Sie möchten. In wenigen Minuten haben Sie eine funktionierende Umsetzung als Ausgangspunkt.
Kann ich die API mit n8n, Make oder Zapier verbinden?
Ja. Jedes Tool, das eine HTTP-Anfrage mit Header senden kann, kann die API aufrufen: der HTTP-Request-Node in n8n, das HTTP-Modul in Make oder eine eigene Anfrage in Zapier. Diese Tools können Buchungen erstellen, verschieben und stornieren. Auf Änderungen innerhalb von Barberly können sie nicht reagieren, weil die API noch keine Webhooks hat.
Kann ein Sprachagent oder ChatGPT darüber Termine buchen?
Ja. Sprachplattformen wie Vapi oder Retell rufen externe APIs als Tools auf, und ein eigenes GPT in ChatGPT kann das OpenAPI-Dokument importieren und Ihren Schlüssel im Header senden. Die aktuelle API reicht für beides aus.
Bekommen Kunden die üblichen Buchungsbestätigungen?
Ja. Buchungen über die API senden dieselben Benachrichtigungen, die Sie für Ihre mobile App und Ihre Website eingerichtet haben.
Was ist mit Anzahlungen und Vorauszahlungen?
Die Booking API nimmt keine Zahlungen an. Wenn Sie eine Anzahlung oder Vorauszahlung brauchen, nehmen Sie sie zuerst in Ihrem eigenen Ablauf entgegen und erstellen dann die Buchung über die API.
Sehe ich, welche Buchungen über die API kamen?
Ja. Im Verlauf des Termins ist eine über die API erstellte Buchung als über die Booking API erstellt gekennzeichnet, so wie andere Buchungen die mobile App oder die Website zeigen.
Werden Kunden, die über die API buchen, Teil meiner Kundenbasis?
Ja. Sie werden wie alle anderen zu Ihren Kunden hinzugefügt und sammeln Treuepunkte, wenn die Buchung als abgeschlossen markiert wird.
Gibt es einen Testmodus?
Nein. Stornieren Sie während der Entwicklung die Testbuchungen, die Sie anlegen.
Erfährt mein System, wenn sich eine Buchung in Barberly ändert?
Nicht automatisch: Es gibt noch keine Webhooks. Um eine Buchung zu prüfen, rufen Sie sie erneut über ihre ID ab.
Ich habe mehrere Standorte. Brauche ich für jeden einen Schlüssel?
Nein. Ein Schlüssel funktioniert für alle Ihre Standorte. Wie in Ihrer App und auf Ihrer Website wählt der Kunde den Standort bei der Buchung.
Unterstützt die Booking API Walk-ins oder die Warteliste?
Nein. Sie ist für Buchungen da: Termine erstellen, abrufen, verschieben und stornieren. Die Walk-in-Warteschlange und die Warteliste laufen über den Kiosk und die Barberly-Business-App.
