🔌 Token API
In 30 secondi
- Un token permette a Make, Zapier o ai tuoi script di leggere o scrivere nel laboratorio senza che ci sia una persona davanti.
- È incluso nei piani Max e Business, e lo creano Admin e Proprietari.
- La chiave si vede una volta sola, quando la crei: copiala in quel momento.
- Dai al token il ruolo minimo di cui ha bisogno, e disattivalo quando non lo usi più.
I token API permettono di collegare BolloPrint a strumenti esterni come Make (Integromat), Zapier, script propri o qualsiasi sistema che debba leggere o scrivere dati nel laboratorio senza che ci sia una persona davanti.
Sono disponibili in Impostazioni → Estensioni → Token API per Admin e Proprietari.
L'API è inclusa nei piani Max e Business. Se il tuo piano non la include, la sezione appare bloccata e le chiamate con token vengono rifiutate anche se il token esiste.
Cosa può fare un'integrazione con un token API?
A seconda del ruolo che assegni al token, un'integrazione può:
- Creare ordini automaticamente quando arriva una vendita da un'altra piattaforma.
- Leggere lo stato degli ordini per aggiornare un sistema esterno di tracciamento.
- Aggiungere clienti in blocco da un'importazione.
- Consultare l'inventario per gli avvisi di stock.
Il token agisce a nome di un utente "di sistema" del laboratorio, non di una persona specifica.
Creare un token API
- Vai su Impostazioni → Estensioni → Token API.
- Premi "Crea token".
- Compila il modulo:
- Nome: qualcosa di descrittivo per sapere a cosa serve (p.es. "Make — ordini web").
- Ruolo: il livello di accesso del token (Admin, Operatore o Sola lettura). Usa il minimo necessario.
- Scadenza: per quanto tempo resterà attivo il token (1 settimana, 1 mese, 3 mesi, 1 anno, o Non scade).
- Premi Crea token.
🔐 Il token si vede una volta sola
Subito dopo aver creato il token, il sistema mostra la chiave completa. Copiala in quel momento — non si può vedere di nuovo. Se la perdi, dovrai creare un nuovo token e disattivare il precedente.
Il token inizia con bp_tat_
Tutti i token di laboratorio iniziano con il prefisso bp_tat_ (BolloPrint Tenant API Token). È facile da riconoscere se hai diversi token in un gestore di password.
Ruoli del token
| Ruolo | Cosa può fare |
|---|---|
| Admin | Accesso completo (lettura e scrittura su tutti i moduli). |
| Operatore | Lo stesso di una persona con ruolo Lavoratore: gestisce ordini, clienti, catalogo. |
| Sola lettura | Solo consultazione, non modifica nulla. Utile per integrazioni che devono solo consultare i dati. |
Disattivare un token
Se un token non ti serve più ma vuoi conservare lo storico di ciò che ha fatto, usa Disattiva. Il token smette di funzionare ma resta nell'elenco.
Se vuoi eliminarlo completamente dall'elenco, usa Elimina (disponibile solo per i token già disattivati o scaduti).
Audit di utilizzo
Ogni volta che un'integrazione chiama l'API usando un token, BolloPrint registra l'azione nella cronologia dell'ordine o del preventivo che modifica. Al posto del nome di una persona, come autore vedrai il nome del token.
Chi può gestire i token API?
Solo Admin e Proprietari possono creare, vedere e disattivare token. I Lavoratori e i Sola lettura non hanno accesso a questa sezione.