Barberly har nu ett öppet Booking API. Med det kan din egen webbplats, app, WhatsApp-bot, röstagent eller AI-assistent ta emot bokningar till din salong, med samma tjänster, samma team, samma lediga tider och samma bokningsregler som dina kunder redan ser i din Barberly-app.
Det här kan du bygga med ett boknings-API för salonger
- WhatsApp: boka i chatten som kunderna redan använder
- AI-assistenter: boka utifrån dina faktiska lediga tider
- Röstagenter: telefonbokningar, automatiserat
- Webbplatser: ditt eget bokningsflöde med ditt eget varumärke
- Chattbottar: ett bokningssteg i valfri chattwidget
- Egna integrationer: allt annat som skapar en bokning
Det bokar så som dina kunder bokar
Booking API är ännu ett verktyg för kunderna, bredvid din app, din webbplats, bokningswidgetarna, kiosken och bokning via Google. Det är inte ett back office-API. Det ger ingen åtkomst till rapporter, teamhantering eller inställningar.
Allt du har ställt in för din egen bokningssida gäller oförändrat:
- En tid som är stängd för kunder är också stängd i API:t. De lediga tiderna visar kundvyn av din kalender, aldrig teamets.
- Om du godkänner bokningar manuellt kommer bokningar via API:t också in obekräftade.
- Om du kräver en registrerad kund kräver API:t det också.
- Arbetstider, minsta framförhållning, tjänsternas längd och vilken frisör som gör vad läses direkt från dina inställningar.
API:t hittar inte på egna regler och kan inte kringgå några.
Det här täcker Booking API
- Katalog: platser, teammedlemmar, tjänster med tillval
- Lediga tider: lediga dagar och tider per plats, frisör och tjänst
- Bokningar: skapa, hämta, flytta och avboka
- Kundkonton: registrering, inloggning och återställning av lösenord
API-nycklar och behörigheter
Ställ först in dina platser, ditt team, dina tjänster och arbetstider i Barberly. API:t läser den inställningen, det skapar den inte. Skapa sedan en nyckel i Barberly-portalen under Apps → Booking API → Create key och ge den bara de behörigheter den behöver:
| Behörighet | Ger åtkomst till |
|---|---|
catalog:read | Platser, teammedlemmar, tjänster, lediga tider |
bookings:read | Att hämta en bokning |
bookings:write | Att skapa, ändra och avboka bokningar |
accounts:write | Att registrera, logga in och återställa kundkonton |
Skicka nyckeln i headern X-Api-Key. Nycklar kan återkallas eller tas bort på samma skärm.
Testa livedemona
Två fungerande bokningsflöden för gäster körs på en öppen demosalong och visar riktiga data direkt. Båda går igenom plats, frisör, tjänster med tillval, datum och tid, gästens uppgifter och bekräftelse, utan inloggning.
- Appointment hub: ett kort med fyra fält som gästen fyller i i valfri ordning
- Guided wizard: fem steg med förloppsindikator
Källkoden finns på GitHub: React-exempel som du kan läsa, kopiera eller använda i ditt eget projekt.
Dokumentation
- API-referens: alla endpoints och fält
- OpenAPI-dokument: generera en klient i ditt eget språk
Vanliga frågor
Kostar Booking API extra?
Nej. Booking API ingår i ditt Barberly-abonnemang. Det finns ingen extra avgift.
Jag är inte utvecklare. Hur får jag en integration byggd?
Ge ChatGPT, Claude eller en annan AI-agent länken till API-referensen och beskriv vad du vill ha. På några minuter har du en fungerande lösning att utgå från.
Kan jag koppla det till n8n, Make eller Zapier?
Ja. Alla verktyg som kan skicka en HTTP-förfrågan med en header kan anropa API:t: HTTP Request-noden i n8n, HTTP-modulen i Make eller en egen förfrågan i Zapier. Verktygen kan skapa, flytta och avboka bokningar. De kan inte reagera på ändringar inne i Barberly, eftersom API:t ännu inte har webhooks.
Kan en röstagent eller ChatGPT boka tider via det?
Ja. Röstplattformar som Vapi eller Retell anropar externa API:er som verktyg, och en egen GPT i ChatGPT kan importera OpenAPI-dokumentet och skicka din nyckel i headern. Dagens API räcker för båda.
Får kunderna de vanliga bokningsbekräftelserna?
Ja. Bokningar via API:t skickar samma aviseringar som du har ställt in för din app och din webbplats.
Hur blir det med depositioner och förskottsbetalningar?
Booking API tar inte emot betalningar. Behöver du en deposition eller förskottsbetalning tar du betalt i ditt eget flöde först och skapar sedan bokningen via API:t.
Kan jag se vilka bokningar som kom via API:t?
Ja. I bokningens historik står en bokning via API:t som skapad via Booking API, på samma sätt som andra bokningar visar appen eller webbplatsen.
Hamnar kunder som bokar via API:t i mitt kundregister?
Ja. De läggs till bland dina kunder som alla andra och tjänar lojalitetspoäng när bokningen markeras som slutförd.
Finns det ett testläge?
Nej. Avboka testbokningarna du skapar medan du bygger.
Får mitt system veta om en bokning ändras i Barberly?
Inte automatiskt: det finns inga webhooks ännu. För att kontrollera en bokning hämtar du den igen via dess ID.
Jag har flera platser. Behöver jag en nyckel för varje?
Nej. En nyckel fungerar för alla dina platser. Precis som i din app och på din webbplats väljer kunden plats vid bokningen.
Hanterar Booking API drop-in-kunder eller väntelistan?
Nej. Det är till för bokningar: skapa, hämta, flytta och avboka tider. Drop-in-kön och väntelistan sköts via kiosken och Barberly Business-appen.
