Barberly har nå et offentlig Booking API. Med det kan ditt eget nettsted, appen din, WhatsApp-boten din, stemmeagenten din eller AI-assistenten din ta imot bookinger til barbershopen din, med de samme tjenestene, det samme teamet, den samme ledigheten og de samme bookingreglene som kundene dine allerede ser i Barberly-appen.
Dette kan du bygge med et booking-API for barbershoper
- WhatsApp: book i chatten kundene allerede bruker
- AI-assistenter: book ut fra den faktiske ledigheten din
- Stemmeagenter: telefonbookinger, automatisert
- Nettsteder: din egen bookingflyt med din egen profil
- Chatboter: et bookingsteg i hvilken som helst chatwidget
- Egne integrasjoner: alt annet som oppretter en booking
Det booker slik kundene dine booker
Booking API-et er enda et verktøy for kundene, ved siden av appen din, nettstedet ditt, bookingwidgetene, kiosken og booking via Google. Det er ikke et back office-API. Det gir ikke tilgang til rapporter, teamstyring eller innstillinger.
Alt du har satt opp for din egen bookingside, gjelder uendret:
- En time som er stengt for kunder, er også stengt i API-et. Ledigheten viser kundevisningen av kalenderen din, aldri teamets.
- Hvis du godkjenner avtaler manuelt, kommer bookinger via API-et også inn ubekreftet.
- Hvis du krever en registrert kunde, krever API-et det også.
- Arbeidstider, minste varsel, varighet på tjenester og hvilken barber som gjør hva, leses direkte fra innstillingene dine.
API-et finner ikke på egne regler og kan ikke omgå noen.
Dette dekker Booking API-et
- Katalog: lokasjoner, teammedlemmer, tjenester med tillegg
- Ledighet: ledige dager og tider per lokasjon, barber og tjeneste
- Bookinger: opprette, hente, flytte og avbestille
- Kundekontoer: registrering, innlogging og tilbakestilling av passord
API-nøkler og tilganger
Sett først opp lokasjoner, team, tjenester og arbeidstider i Barberly. API-et leser oppsettet, det oppretter det ikke. Lag deretter en nøkkel i Barberly-portalen under Apps → Booking API → Create key, og gi den bare tilgangene den trenger:
| Tilgang | Gir tilgang til |
|---|---|
catalog:read | Lokasjoner, teammedlemmer, tjenester, ledighet |
bookings:read | Å hente en booking |
bookings:write | Å opprette, endre og avbestille bookinger |
accounts:write | Å registrere, logge inn og gjenopprette kundekontoer |
Send nøkkelen i headeren X-Api-Key. Nøkler kan trekkes tilbake eller slettes på samme skjerm.
Prøv live-demoene
To fungerende bookingflyter for gjester kjører på en offentlig demobutikk og viser ekte data med en gang. Begge går gjennom lokasjon, barber, tjenester med tillegg, dato og tid, gjestens opplysninger og bekreftelse, uten innlogging.
- Appointment hub: ett kort med fire felt gjesten fyller ut i hvilken som helst rekkefølge
- Guided wizard: fem steg med fremdriftslinje
Kildekoden ligger på GitHub: React-eksempler du kan lese, kopiere eller bruke i ditt eget prosjekt.
Dokumentasjon
- API-referanse: alle endepunkter og felt
- OpenAPI-dokument: generer en klient i ditt eget språk
Ofte stilte spørsmål
Koster Booking API-et ekstra?
Nei. Booking API-et er inkludert i Barberly-abonnementet ditt. Det er ingen ekstra kostnad.
Jeg er ikke utvikler. Hvordan får jeg laget en integrasjon?
Gi ChatGPT, Claude eller en annen AI-agent lenken til API-referansen, og beskriv hva du vil ha. På noen minutter har du en fungerende løsning å bygge videre på.
Kan jeg koble det til n8n, Make eller Zapier?
Ja. Alle verktøy som kan sende en HTTP-forespørsel med en header, kan kalle API-et: HTTP Request-noden i n8n, HTTP-modulen i Make eller en egendefinert forespørsel i Zapier. Disse verktøyene kan opprette, flytte og avbestille bookinger. De kan ikke reagere på endringer inne i Barberly, fordi API-et ennå ikke har webhooks.
Kan en stemmeagent eller ChatGPT booke timer gjennom det?
Ja. Stemmeplattformer som Vapi eller Retell kaller eksterne API-er som verktøy, og en egen GPT i ChatGPT kan importere OpenAPI-dokumentet og sende nøkkelen din i headeren. Dagens API er nok for begge deler.
Får kundene de vanlige bookingbekreftelsene?
Ja. Bookinger via API-et sender de samme varslene du har satt opp for appen og nettstedet ditt.
Hva med depositum og forhåndsbetaling?
Booking API-et tar ikke imot betalinger. Trenger du depositum eller forhåndsbetaling, tar du imot det i din egen flyt først og oppretter deretter bookingen via API-et.
Kan jeg se hvilke bookinger som kom via API-et?
Ja. I historikken til avtalen står en booking via API-et som opprettet via Booking API, på samme måte som andre bookinger viser appen eller nettstedet.
Blir kunder som booker via API-et med i kundebasen min?
Ja. De legges til kundene dine som alle andre og tjener lojalitetspoeng når bookingen markeres som fullført.
Finnes det en testmodus?
Nei. Avbestill testbookingene du lager mens du bygger.
Får systemet mitt beskjed hvis en booking endres i Barberly?
Ikke automatisk: det finnes ennå ingen webhooks. For å sjekke en booking henter du den på nytt via ID-en.
Jeg har flere lokasjoner. Trenger jeg en nøkkel for hver?
Nei. Én nøkkel fungerer for alle lokasjonene dine. Som i appen og på nettstedet ditt velger kunden lokasjon når det bookes.
Håndterer Booking API-et drop-in-kunder eller ventelisten?
Nei. Det er for bookinger: opprette, hente, flytte og avbestille avtaler. Drop-in-køen og ventelisten går via kiosken og Barberly Business-appen.
