API e webhook

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 gratis

Tre 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.

I permessi di una chiave API di Slotora
PermessoCosa consenteQuando la crei
Leggere gli appuntamentiVedere le prenotazioni del saloneGià spuntato
Leggere i clientiNome, contatti e consenso alle promozioniGià spuntato
Leggere i serviziIl listino con durate e prezziGià spuntato
Creare appuntamentiPrenotare negli orari che l'agenda offreDa 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.

Registrati gratis

Possiamo misurare quali pagine sono davvero utili? “Accetta tutto” ci permette anche di misurare le nostre pubblicità.

Cosa significa esattamente?

Vorremmo usare Google Analytics per capire quali pagine sono utili e quali no, e per ricordare quale nostro poster, volantino o messaggio (o la raccomandazione di quale salone) ti ha portato qui. “Accetta tutto” consente anche un pixel pubblicitario di Meta, così possiamo capire quale delle nostre pubblicità ha portato un salone che si è registrato; e se crei un account, il nostro server invia a Meta il tuo indirizzo email in forma cifrata (hash), mai in chiaro, insieme al tuo indirizzo IP, ai dati del tuo browser e agli identificativi dei cookie di Meta (mai il tuo nome), al solo scopo di riconoscere che la registrazione è arrivata da una pubblicità. Niente di tutto questo è attivo sulla pagina di prenotazione di un salone. Tutto ciò che serve al servizio funziona in ogni caso. Informativa sui cookie