Barberly are acum un Booking API public. Cu el, propriul tău site, aplicația ta, botul de WhatsApp, agentul vocal sau asistentul AI pot primi rezervări pentru frizeria ta, folosind aceleași servicii, aceeași echipă, aceeași disponibilitate și aceleași reguli de rezervare pe care clienții tăi le văd deja în aplicația ta Barberly.
Ce poți construi cu un API de rezervări pentru frizerie
- WhatsApp: rezervare direct în chatul pe care clienții îl folosesc deja
- Asistenți AI: rezervare pe baza disponibilității tale reale
- Agenți vocali: rezervări telefonice, automatizate
- Site-uri: propriul flux de rezervare, cu brandul tău
- Chatboți: un pas de rezervare în orice widget de chat
- Integrări personalizate: orice altceva care creează o rezervare
Rezervă exact ca clienții tăi
Booking API este încă un instrument pentru clienți, alături de aplicația mobilă, site-ul tău, widgeturile de rezervare, kioskul și rezervarea prin Google. Nu este un API de back-office. Nu deschide rapoarte, gestionarea echipei sau setări.
Tot ce ai configurat pentru propria pagină de rezervare se aplică neschimbat:
- Un slot închis pentru clienți este închis și în API. Disponibilitatea arată calendarul tău așa cum îl văd clienții, niciodată așa cum îl vede personalul.
- Dacă aprobi programările manual, și rezervările făcute prin API ajung neconfirmate.
- Dacă ceri un client înregistrat, și API-ul cere unul.
- Programul de lucru, timpul minim înainte de rezervare, durata serviciilor și ce face fiecare frizer sunt citite în timp real din setările tale.
API-ul nu inventează reguli proprii și nu poate ocoli niciuna.
Ce acoperă Booking API
- Catalog: locații, membri ai echipei, servicii cu servicii suplimentare
- Disponibilitate: zile și intervale orare libere, pe locație, frizer și serviciu
- Rezervări: creare, citire, reprogramare și anulare
- Conturi de client: înregistrare, autentificare și resetarea parolei
Chei API și permisiuni
Configurează mai întâi în Barberly locațiile, echipa, serviciile și programul de lucru. API-ul citește această configurare, nu o creează. Apoi generează o cheie în portalul Barberly din Aplicații → API de rezervări → Creează cheie și dă-i doar permisiunile de care are nevoie:
| Permisiune | Acordă |
|---|---|
catalog:read | Locații, membri ai echipei, servicii, disponibilitate |
bookings:read | Citirea unei rezervări |
bookings:write | Crearea, modificarea și anularea rezervărilor |
accounts:write | Înregistrarea, autentificarea și recuperarea conturilor de client |
Trimite cheia în headerul X-Api-Key. Cheile pot fi revocate sau șterse din același ecran.
Încearcă demo-urile live
Două fluxuri funcționale de rezervare pentru vizitatori rulează pe o frizerie demo publică, așa că afișează date live imediat. Ambele trec prin locație, frizer, servicii cu servicii suplimentare, dată și oră, datele vizitatorului și confirmare, fără autentificare.
- Appointment hub: un singur card cu patru câmpuri pe care vizitatorul le completează în orice ordine
- Ghid pas cu pas: cinci pași cu bară de progres
Codul sursă este pe GitHub: exemple în React pe care le poți citi, copia sau prelua în propriul proiect.
Documentație
- Referința API: fiecare endpoint și fiecare câmp
- Documentul OpenAPI: generează un client în limbajul tău
Întrebări frecvente
Booking API costă în plus?
Nu. Booking API este inclus în abonamentul tău Barberly. Nu există nicio taxă suplimentară pentru el.
Nu sunt programator. Cum îmi fac o integrare?
Dă-i lui ChatGPT, Claude sau altui agent AI linkul către referința API și descrie ce vrei. În câteva minute vei avea o implementare funcțională de la care să pornești.
Îl pot conecta cu n8n, Make sau Zapier?
Da. Orice instrument care poate trimite o cerere HTTP cu un header poate apela API-ul: nodul HTTP Request din n8n, modulul HTTP din Make sau o cerere personalizată în Zapier. Aceste instrumente pot crea, reprograma și anula rezervări. Nu pot reacționa la modificările făcute în Barberly, pentru că API-ul nu are încă webhookuri.
Poate un agent vocal sau ChatGPT să facă programări prin el?
Da. Platformele vocale precum Vapi sau Retell apelează API-uri externe ca instrumente, iar un GPT personalizat în ChatGPT poate importa documentul OpenAPI și îți poate trimite cheia în header. API-ul actual este suficient pentru ambele.
Primesc clienții confirmările obișnuite de rezervare?
Da. Rezervările făcute prin API trimit aceleași notificări pe care le-ai configurat pentru aplicația mobilă și site.
Ce se întâmplă cu avansurile și plățile în avans?
Booking API nu încasează plăți. Dacă ai nevoie de un avans sau de o plată în avans, încaseaz-o mai întâi în propriul flux, apoi creează rezervarea prin API.
Pot vedea ce rezervări au venit prin API?
Da. În istoricul programării, o rezervare făcută prin API este marcată ca fiind creată prin Booking API, la fel cum alte rezervări arată aplicația mobilă sau site-ul.
Clienții care rezervă prin API intră în baza mea de clienți?
Da. Sunt adăugați la clienții tăi ca oricine altcineva și primesc puncte de loialitate când rezervarea este marcată ca finalizată.
Există un mod de testare?
Nu. Cât timp construiești, anulează rezervările de test pe care le creezi.
Va ști sistemul meu când se modifică o rezervare în Barberly?
Nu automat: încă nu există webhookuri. Ca să verifici o rezervare, citește-o din nou după ID.
Am mai multe locații. Am nevoie de câte o cheie pentru fiecare?
Nu. O singură cheie funcționează pentru toate locațiile tale. La fel ca în aplicație și pe site, clientul alege locația când rezervă.
Booking API gestionează clienții fără programare sau lista de așteptare?
Nu. Este pentru rezervări: crearea, citirea, reprogramarea și anularea programărilor. Coada pentru clienți fără programare și lista de așteptare funcționează pe kiosk și în aplicația Barberly Business.
