API prenotazioni per il tuo salone: collega i tuoi strumenti senza dare via le chiavi di casa
Prima o poi qualcuno te lo chiede: il nipote che ti ha fatto il sito, l'agenzia che cura i social, lo studio che tiene la contabilità. “Se c'è un'API, lo collego io.” In Slotora c'è, è inclusa, e decidi tu che cosa può leggere ogni strumento collegato e che cosa resta nel salone.
0 € al mese · 0% di commissione · nessuna carta per registrarti · appuntamenti, clienti e collaboratori senza limiti
Crea il tuo account gratisTre collegamenti che un salone fa davvero
Non serve un reparto informatico: chi ti aiuta con il sito o con i tuoi strumenti sa usare una chiave e un indirizzo.
Un foglio dei clienti nuovi
Ogni volta che entra un cliente nuovo, una riga si aggiunge da sola a un foglio di calcolo, con nome, contatti e se ha accettato di ricevere promozioni. Chi ha detto no resta segnato come tale.
Il modulo del tuo sito
Il sito chiede gli orari liberi e crea l'appuntamento passando dallo stesso motore del banco: solo orari che la tua agenda offre davvero, con le pause e le regole di ogni servizio.
Un avviso al team
Quando un appuntamento viene cancellato, il tuo strumento riceve subito la notizia e può avvisare la chat del salone, così qualcuno chiama chi è in lista d'attesa.
Cosa esce dal salone, e cosa resta dentro
Esce quello che serve a un altro strumento per lavorare: appuntamenti con orario, servizio, persona, stato e importi; clienti con nome e contatti; il listino. E per ogni cliente, la risposta sul consenso alle promozioni, perché lo strumento possa lasciar fuori chi ha detto di no.
Non esce mai una nota. Né le note sul cliente né quelle sull'appuntamento, né il campo delle avvertenze, né il test di tolleranza o il motivo di una cancellazione: sono parole su una persona, e restano al salone. Restano dentro anche indirizzo, codice fiscale o partita IVA, compleanno ed etichette.
Se hai nascosto telefono ed e-mail dei clienti al tuo team, l'API li nasconde allo stesso modo: arrivano vuoti, con un'indicazione che sono nascosti e non mancanti.
Le chiavi, una per ogni strumento
Ogni chiave ha un nome e i suoi permessi. Le crei e le revochi dalla schermata API e webhook.
| Permesso | Cosa consente | Quando la crei |
|---|---|---|
| Leggere gli appuntamenti | Vedere le prenotazioni del salone | Già spuntato |
| Leggere i clienti | Nome, contatti e consenso alle promozioni | Già spuntato |
| Leggere i servizi | Il listino con durate e prezzi | Già spuntato |
| Creare appuntamenti | Prenotare negli orari che l'agenda offre | Da spuntare tu, solo se serve |
Fino a 20 chiavi attive e 10 indirizzi per i webhook. Ogni chiave può fare 120 richieste al minuto, e ogni richiesta resta nel registro.
I webhook: la notizia arriva da sola
Invece di chiedere ogni cinque minuti “c'è qualcosa di nuovo?”, il tuo strumento riceve un messaggio quando un appuntamento viene creato, modificato o cancellato, quando entra un cliente nuovo e quando viene registrato un pagamento.
Ogni messaggio è firmato con un segreto che vale solo per quell'indirizzo, con l'ora dentro la firma: chi lo riceve può verificare che arriva da Slotora e non da qualcun altro. Se l'indirizzo non risponde, Slotora riprova dopo un minuto, poi dopo cinque, trenta, due ore, sei, dodici e ventiquattro: otto tentativi in tutto. Puoi mandare un messaggio di prova, mettere in pausa un indirizzo e riattivarlo, e alla ripresa non arriva una valanga di vecchie notizie.
Domande sull’API e sui collegamenti
L'API si paga a parte?
No, è inclusa come il resto: 0 € al mese e nessun costo per chiamata. Il limite è tecnico, 120 richieste al minuto per chiave.
Chi del salone può creare una chiave?
Solo la titolare e gli amministratori. La reception e le collaboratrici non vedono la schermata, perché una chiave legge tutta la rubrica clienti. Nell'app c'è l'elenco in sola lettura.
Dove trova la documentazione chi fa il collegamento?
C'è un documento OpenAPI pubblico, all'indirizzo /api/v1/openapi.json di Slotora, che descrive ogni indirizzo, ogni campo e ogni errore. È scritto accanto al codice e un controllo automatico lo tiene allineato agli indirizzi che esistono davvero.
Posso collegare Slotora alla fatturazione elettronica?
Slotora non emette fatture e non parla con il Sistema di Interscambio. Uno strumento collegato può ricevere gli appuntamenti e i pagamenti registrati, ma la fattura la fa il tuo programma di fatturazione.
Se un collaboratore se ne va, le sue chiavi restano attive?
Una chiave vale finché chi l'ha creata è titolare o amministratore del salone: quando non lo è più, la chiave smette di funzionare insieme al suo accesso.
Quello che l'API di Slotora non fa
- Nessun collegamento già pronto
- Non ci sono integrazioni con un singolo clic verso programmi italiani. L'API è la porta: il collegamento lo costruisce chi ti aiuta, con gli strumenti che preferisce.
- Niente dati fiscali in uscita
- Slotora non è un registratore telematico e non manda corrispettivi all'Agenzia delle Entrate: il documento commerciale resta compito della tua cassa. In Italia non offriamo nemmeno Tap to Pay o un lettore di carte.
- Non si può prenotare dove l'agenda dice di no
- Uno strumento collegato non può forzare un appuntamento fuori orario o sopra un altro, come può fare il banco: crea solo prenotazioni negli orari che Slotora offre.
La prima chiave, in sola lettura
Apri API e webhook nelle impostazioni, crea una chiave con i permessi già spuntati e passala a chi fa il collegamento: se qualcosa non va, la revochi con un tocco.
