Barberly ora ha una Booking API pubblica. Con questa, il tuo sito, la tua app, il tuo bot WhatsApp, il tuo agente vocale o il tuo assistente IA possono accettare prenotazioni per il tuo barbershop, con gli stessi servizi, lo stesso team, la stessa disponibilità e le stesse regole di prenotazione che i tuoi clienti vedono già nella tua app Barberly.
Cosa puoi costruire con un'API di prenotazione per barbershop
- WhatsApp: prenotare nella chat che i clienti usano già
- Assistenti IA: prenotare in base alla tua disponibilità reale
- Agenti vocali: prenotazioni telefoniche, automatizzate
- Siti web: il tuo flusso di prenotazione, con il tuo brand
- Chatbot: un passaggio di prenotazione in qualsiasi widget di chat
- Integrazioni personalizzate: qualsiasi altra cosa che crei una prenotazione
Prenota come prenotano i tuoi clienti
La Booking API è uno strumento in più per i clienti, accanto alla tua app, al tuo sito, ai widget di prenotazione, al chiosco e alla prenotazione Google. Non è un'API di back office. Non apre report, gestione del team o impostazioni.
Tutto ciò che hai configurato per la tua pagina di prenotazione vale anche qui:
- Uno slot chiuso ai clienti è chiuso anche nell'API. La disponibilità mostra la vista cliente della tua agenda, mai quella del team.
- Se approvi gli appuntamenti a mano, anche le prenotazioni fatte con l'API arrivano non confermate.
- Se richiedi un cliente registrato, lo richiede anche l'API.
- Orari, preavviso minimo, durata dei servizi e chi fa cosa vengono letti in tempo reale dalle tue impostazioni.
L'API non inventa regole proprie e non può aggirarne nessuna.
Cosa copre la Booking API
- Catalogo: sedi, membri del team, servizi con extra
- Disponibilità: giorni e orari liberi, per sede, barbiere e servizio
- Prenotazioni: creare, leggere, spostare e cancellare
- Account clienti: registrazione, accesso e reimpostazione della password
Chiavi API e permessi
Configura prima sedi, team, servizi e orari in Barberly. L'API legge questa configurazione, non la crea. Poi crea una chiave nel portale Barberly in Apps → Booking API → Create key e dalle solo i permessi necessari:
| Permesso | Consente |
|---|---|
catalog:read | Sedi, membri del team, servizi, disponibilità |
bookings:read | Leggere una prenotazione |
bookings:write | Creare, modificare e cancellare prenotazioni |
accounts:write | Registrare, far accedere e recuperare account clienti |
Invia la chiave nell'header X-Api-Key. Le chiavi si possono revocare o eliminare dalla stessa schermata.
Prova le demo dal vivo
Due flussi di prenotazione per ospiti funzionano su un barbershop demo pubblico e mostrano subito dati reali. Entrambi passano per sede, barbiere, servizi con extra, data e ora, dati dell'ospite e conferma, senza accesso.
- Appointment hub: una scheda con quattro campi da compilare in qualsiasi ordine
- Guided wizard: cinque passaggi con barra di avanzamento
Il codice sorgente è su GitHub: esempi React da leggere, copiare o riusare nel tuo progetto.
Documentazione
- Riferimento API: ogni endpoint e ogni campo
- Documento OpenAPI: genera un client nel tuo linguaggio
Domande frequenti
La Booking API costa di più?
No. La Booking API è inclusa nel tuo abbonamento Barberly. Nessun costo aggiuntivo.
Non sono uno sviluppatore. Come ottengo un'integrazione?
Dai a ChatGPT, Claude o un altro agente IA il link al riferimento API e descrivi cosa vuoi. In pochi minuti avrai un'implementazione funzionante da cui partire.
Posso collegarla a n8n, Make o Zapier?
Sì. Qualsiasi strumento che possa inviare una richiesta HTTP con un header può chiamare l'API: il nodo HTTP Request in n8n, il modulo HTTP in Make o una richiesta personalizzata in Zapier. Questi strumenti possono creare, spostare e cancellare prenotazioni. Non possono reagire alle modifiche fatte in Barberly, perché l'API non ha ancora webhook.
Un agente vocale o ChatGPT possono prenotare appuntamenti con l'API?
Sì. Piattaforme vocali come Vapi o Retell chiamano API esterne come strumenti, e un GPT personalizzato in ChatGPT può importare il documento OpenAPI e inviare la tua chiave nell'header. L'API attuale basta per entrambi.
I clienti ricevono le solite conferme?
Sì. Le prenotazioni fatte con l'API inviano le stesse notifiche che hai configurato per la tua app e il tuo sito.
E gli acconti e i pagamenti anticipati?
La Booking API non incassa pagamenti. Se ti serve un acconto o un pagamento anticipato, incassalo prima nel tuo flusso e poi crea la prenotazione con l'API.
Posso vedere quali prenotazioni arrivano dall'API?
Sì. Nella cronologia dell'appuntamento, una prenotazione fatta con l'API risulta creata tramite la Booking API, come le altre mostrano l'app o il sito.
I clienti che prenotano tramite l'API entrano nella mia base clienti?
Sì. Vengono aggiunti ai tuoi clienti come tutti gli altri e guadagnano punti fedeltà quando la prenotazione è segnata come completata.
C'è una modalità di test?
No. Durante lo sviluppo, cancella le prenotazioni di prova che crei.
Il mio sistema saprà se una prenotazione cambia in Barberly?
Non automaticamente: non ci sono ancora webhook. Per controllare una prenotazione, rileggila tramite il suo ID.
Ho più sedi. Mi serve una chiave per ognuna?
No. Una sola chiave funziona per tutte le tue sedi. Come nella tua app e sul tuo sito, il cliente sceglie la sede quando prenota.
La Booking API gestisce i clienti senza appuntamento o la lista d'attesa?
No. Serve per le prenotazioni: creare, leggere, spostare e cancellare appuntamenti. La coda dei clienti senza appuntamento e la lista d'attesa funzionano con il chiosco e l'app Barberly Business.
