Barberlylla on nyt julkinen Booking API. Sen avulla omat verkkosivusi, sovelluksesi, WhatsApp-bottisi, puheagenttisi tai tekoälyavustajasi voivat ottaa vastaan varauksia parturiisi, samoilla palveluilla, samalla tiimillä, samoilla vapailla ajoilla ja samoilla varaussäännöillä, jotka asiakkaasi jo näkevät Barberly-sovelluksessasi.
Mitä voit rakentaa parturin ajanvaraus-API:lla
- WhatsApp: varaus siinä chatissa, jota asiakkaat jo käyttävät
- Tekoälyavustajat: varaus todellisten vapaiden aikojesi mukaan
- Puheagentit: puhelinvaraukset automaattisesti
- Verkkosivut: oma varauspolkusi omalla brändilläsi
- Chatbotit: varausvaihe mihin tahansa chat-widgetiin
- Omat integraatiot: mikä tahansa muu, joka luo varauksen
Se varaa niin kuin asiakkaasi varaavat
Booking API on yksi asiakastyökalu lisää sovelluksesi, verkkosivujesi, varausvimpainten, kioskin ja Google-varauksen rinnalla. Se ei ole back office -API. Se ei avaa raportteja, tiimin hallintaa eikä asetuksia.
Kaikki, mitä olet asettanut omalle varaussivullesi, pätee sellaisenaan:
- Asiakkailta suljettu aika on suljettu myös API:ssa. Vapaat ajat näyttävät kalenterisi asiakasnäkymän, ei koskaan tiimin näkymää.
- Jos hyväksyt ajat käsin, myös API:n kautta tulevat varaukset saapuvat vahvistamattomina.
- Jos vaadit rekisteröityneen asiakkaan, API vaatii sen myös.
- Työajat, minimivarausaika, palveluiden kestot ja se, kuka parturi tekee mitäkin, luetaan suoraan asetuksistasi.
API ei keksi omia sääntöjä eikä voi kiertää yhtäkään.
Mitä Booking API kattaa
- Luettelo: toimipisteet, tiimin jäsenet, palvelut lisäpalveluineen
- Vapaat ajat: vapaat päivät ja ajat toimipisteittäin, parturikohtaisesti ja palveluittain
- Varaukset: luonti, haku, siirto ja peruutus
- Asiakastilit: rekisteröityminen, kirjautuminen ja salasanan palautus
API-avaimet ja käyttöoikeudet
Aseta ensin toimipisteet, tiimi, palvelut ja työajat Barberlyyn. API lukee nämä asetukset, se ei luo niitä. Luo sitten avain Barberly-portaalissa kohdassa Apps → Booking API → Create key ja anna sille vain ne oikeudet, joita se tarvitsee:
| Oikeus | Sallii |
|---|---|
catalog:read | Toimipisteet, tiimin jäsenet, palvelut, vapaat ajat |
bookings:read | Varauksen haun |
bookings:write | Varausten luonnin, muuttamisen ja perumisen |
accounts:write | Asiakastilien rekisteröinnin, kirjautumisen ja palautuksen |
Lähetä avain otsakkeessa X-Api-Key. Avaimet voi perua tai poistaa samassa näkymässä.
Kokeile live-demoja
Kaksi toimivaa vieraan varauspolkua pyörii julkisessa demoliikkeessä ja näyttää oikeaa dataa heti. Molemmat kulkevat toimipisteen, parturin, lisäpalveluineen valittujen palveluiden, päivän ja ajan, vieraan tietojen ja vahvistuksen kautta ilman kirjautumista.
- Appointment hub: yksi kortti, jonka neljä kenttää vieras täyttää missä järjestyksessä tahansa
- Guided wizard: viisi vaihetta ja edistymispalkki
Lähdekoodi on GitHubissa: React-esimerkkejä, joita voit lukea, kopioida tai käyttää omassa projektissasi.
Dokumentaatio
- API-viite: jokainen endpoint ja kenttä
- OpenAPI-dokumentti: luo asiakasohjelma omalla kielelläsi
Usein kysytyt kysymykset
Maksaako Booking API lisää?
Ei. Booking API sisältyy Barberly-tilaukseesi. Siitä ei peritä lisämaksua.
En ole kehittäjä. Miten saan integraation tehtyä?
Anna ChatGPT:lle, Claudelle tai muulle tekoälyagentille linkki API-viitteeseen ja kerro, mitä haluat. Muutamassa minuutissa sinulla on toimiva toteutus pohjaksi.
Voinko yhdistää sen n8n:ään, Makeen tai Zapieriin?
Kyllä. Mikä tahansa työkalu, joka voi lähettää HTTP-pyynnön otsakkeen kanssa, voi kutsua API:a: HTTP Request -solmu n8n:ssä, HTTP-moduuli Makessa tai oma pyyntö Zapierissa. Nämä työkalut voivat luoda, siirtää ja perua varauksia. Ne eivät voi reagoida Barberlyn sisällä tehtyihin muutoksiin, koska API:ssa ei vielä ole webhookeja.
Voiko puheagentti tai ChatGPT varata aikoja sen kautta?
Kyllä. Puhealustat kuten Vapi tai Retell kutsuvat ulkoisia API:ja työkaluina, ja oma GPT ChatGPT:ssä voi tuoda OpenAPI-dokumentin ja lähettää avaimesi otsakkeessa. Nykyinen API riittää kumpaankin.
Saavatko asiakkaat tavalliset varausvahvistukset?
Kyllä. API:n kautta tehdyt varaukset lähettävät samat ilmoitukset, jotka olet asettanut sovellukseesi ja verkkosivuillesi.
Entä ennakkomaksut?
Booking API ei ota vastaan maksuja. Jos tarvitset ennakkomaksun, ota se ensin omassa polussasi ja luo sitten varaus API:n kautta.
Näenkö, mitkä varaukset tulivat API:n kautta?
Kyllä. Varauksen historiassa API:n kautta tehty varaus näkyy Booking API:lla luotuna, samaan tapaan kuin muut näyttävät sovelluksen tai verkkosivut.
Tulevatko API:n kautta varaavat asiakkaat asiakasrekisteriini?
Kyllä. Heidät lisätään asiakkaisiisi kuten kaikki muutkin, ja he keräävät kanta-asiakaspisteitä, kun varaus merkitään valmiiksi.
Onko testitilaa?
Ei. Peru rakentaessasi luomasi testivaraukset.
Saako järjestelmäni tiedon, jos varaus muuttuu Barberlyssa?
Ei automaattisesti: webhookeja ei vielä ole. Tarkista varaus hakemalla se uudelleen sen tunnisteella.
Minulla on useita toimipisteitä. Tarvitsenko avaimen jokaiselle?
Et. Yksi avain toimii kaikissa toimipisteissäsi. Kuten sovelluksessasi ja verkkosivuillasi, asiakas valitsee toimipisteen varatessaan.
Hoitaako Booking API walk-in-asiakkaat tai jonotuslistan?
Ei. Se on tarkoitettu varauksille: aikojen luontiin, hakuun, siirtoon ja perumiseen. Walk-in-jono ja jonotuslista toimivat kioskin ja Barberly Business -sovelluksen kautta.
