Barberly har nu et offentligt Booking API. Med det kan dit eget website, din app, din WhatsApp-bot, din stemmeagent eller din AI-assistent tage imod bookinger til din barbershop, med de samme ydelser, det samme team, den samme ledighed og de samme bookingregler, som dine kunder allerede ser i din Barberly-app.
Det kan du bygge med et booking-API til barbershops
- WhatsApp: book i den chat, kunderne allerede bruger
- AI-assistenter: book ud fra din reelle ledighed
- Stemmeagenter: telefonbookinger, automatisk
- Websites: dit eget bookingforløb med dit eget brand
- Chatbots: et bookingtrin i enhver chatwidget
- Egne integrationer: alt andet, der opretter en booking
Det booker, som dine kunder booker
Booking API'et er endnu et værktøj til kunderne, ved siden af din app, dit website, booking-widgets, kiosken og booking via Google. Det er ikke et back office-API. Det giver ikke adgang til rapporter, teamstyring eller indstillinger.
Alt, hvad du har sat op til din egen bookingside, gælder uændret:
- En tid, der er lukket for kunder, er også lukket i API'et. Ledigheden viser kundevisningen af din kalender, aldrig teamets.
- Hvis du godkender aftaler manuelt, kommer bookinger via API'et også ind ubekræftede.
- Hvis du kræver en registreret kunde, kræver API'et det også.
- Arbejdstider, minimumsvarsel, ydelsernes varighed og hvilken barber der laver hvad, læses live fra dine indstillinger.
API'et finder ikke på egne regler og kan ikke omgå nogen.
Det dækker Booking API'et
- Katalog: lokationer, teammedlemmer, ydelser med tilvalg
- Ledighed: ledige dage og tider pr. lokation, barber og ydelse
- Bookinger: opret, hent, flyt og aflys
- Kundekonti: registrering, login og nulstilling af adgangskode
API-nøgler og rettigheder
Sæt først dine lokationer, dit team, dine ydelser og arbejdstider op i Barberly. API'et læser den opsætning, det opretter den ikke. Opret derefter en nøgle i Barberly-portalen under Apps → Booking API → Create key, og giv den kun de rettigheder, den har brug for:
| Rettighed | Giver adgang til |
|---|---|
catalog:read | Lokationer, teammedlemmer, ydelser, ledighed |
bookings:read | At hente en booking |
bookings:write | At oprette, ændre og aflyse bookinger |
accounts:write | At registrere, logge ind og gendanne kundekonti |
Send nøglen i headeren X-Api-Key. Nøgler kan tilbagekaldes eller slettes på samme skærm.
Prøv live-demoerne
To fungerende bookingforløb for gæster kører på en offentlig demoforretning og viser rigtige data med det samme. Begge går gennem lokation, barber, ydelser med tilvalg, dato og tid, gæstens oplysninger og bekræftelse, uden login.
- Appointment hub: ét kort med fire felter, som gæsten udfylder i vilkårlig rækkefølge
- Guided wizard: fem trin med en statuslinje
Kildekoden ligger på GitHub: React-eksempler, du kan læse, kopiere eller bruge i dit eget projekt.
Dokumentation
- API-reference: alle endpoints og felter
- OpenAPI-dokument: generér en klient i dit eget sprog
Ofte stillede spørgsmål
Koster Booking API'et ekstra?
Nej. Booking API'et er inkluderet i dit Barberly-abonnement. Der er intet ekstra gebyr.
Jeg er ikke udvikler. Hvordan får jeg bygget en integration?
Giv ChatGPT, Claude eller en anden AI-agent linket til API-referencen, og beskriv, hvad du vil have. På få minutter har du en fungerende løsning at bygge videre på.
Kan jeg forbinde det med n8n, Make eller Zapier?
Ja. Ethvert værktøj, der kan sende en HTTP-forespørgsel med en header, kan kalde API'et: HTTP Request-noden i n8n, HTTP-modulet i Make eller en tilpasset forespørgsel i Zapier. Værktøjerne kan oprette, flytte og aflyse bookinger. De kan ikke reagere på ændringer inde i Barberly, fordi API'et endnu ikke har webhooks.
Kan en stemmeagent eller ChatGPT booke tider via det?
Ja. Stemmeplatforme som Vapi eller Retell kalder eksterne API'er som værktøjer, og en tilpasset GPT i ChatGPT kan importere OpenAPI-dokumentet og sende din nøgle i headeren. Det nuværende API er nok til begge dele.
Får kunderne de sædvanlige bookingbekræftelser?
Ja. Bookinger via API'et sender de samme beskeder, som du har sat op til din app og dit website.
Hvad med depositum og forudbetaling?
Booking API'et tager ikke imod betalinger. Har du brug for et depositum eller en forudbetaling, så tag imod den i dit eget forløb først, og opret derefter bookingen via API'et.
Kan jeg se, hvilke bookinger der kom via API'et?
Ja. I aftalens historik står en booking via API'et som oprettet via Booking API, ligesom andre bookinger viser appen eller websitet.
Kommer kunder, der booker via API'et, med i min kundebase?
Ja. De tilføjes dine kunder som alle andre og optjener loyalitetspoint, når bookingen markeres som gennemført.
Er der en testtilstand?
Nej. Aflys de testbookinger, du opretter, mens du bygger.
Får mit system besked, hvis en booking ændres i Barberly?
Ikke automatisk: der er endnu ingen webhooks. For at tjekke en booking henter du den igen via dens ID.
Jeg har flere lokationer. Skal jeg have en nøgle til hver?
Nej. Én nøgle virker til alle dine lokationer. Ligesom i din app og på dit website vælger kunden lokationen, når der bookes.
Håndterer Booking API'et walk-in-kunder eller ventelisten?
Nej. Det er til bookinger: oprette, hente, flytte og aflyse aftaler. Walk-in-køen og ventelisten kører via kiosken og Barberly Business-appen.
