54. Vedere il tuo piano SaaS e l'utilizzo (usage tracking)
Ti serve quando vuoi sapere quanto stai consumando del tuo piano mensile Brigata AI, prevedere se arriverai al limite, e capire se conviene fare upgrade.
Il consumo si vede nel widget Consumo Brigata AI nella dashboard admin.
1. Vai su Dashboard
Menu di sinistra -> Dashboard (/admin/dashboard). Il widget e’ la
seconda sezione dall’alto, sotto i 4 contatori statistici.
2. Leggi il widget
Mostra 4 informazioni:
- Piano corrente (in alto a sinistra) — es. “Piano Pro”, “Piano Base”, “Piano Premium”
- Periodo di fatturazione (in alto a destra) — es. “1 mag - 1 giu”: e’ il ciclo mensile in cui contano le tue conversazioni
- Barra colorata — riempimento percentuale del consumo:
- Verde (0-59%) — consumo basso, tutto ok
- Giallo (60-79%) — consumo medio, attenzione
- Arancione (80-94%) — vicino al limite, ricevi alert email
- Rosso (95-100%) — limite raggiunto o quasi
- Conteggio numerico — es. “1240 / 2000 conversazioni” (62%)
Cosa conta come “conversazione”
Una nuova conversazione = un cliente che apre la chat con Brigata e scambia almeno 1 messaggio. Le successive risposte di Brigata nella stessa conversazione non consumano un’altra unita’ (e’ una conversazione sola, anche se sono 50 messaggi).
Il limite cambia con il piano:
| Piano | Limite mensile conversazioni |
|---|---|
| Base | 500 |
| Pro | 2000 |
| Premium | 5000 |
Il limite del tuo piano e’ visibile nel widget. Per cambiare piano, vedi sezione 55.
3. Cosa succede se superi il limite
Il sistema applica soft limit con alert email, non blocco brutale:
- 80% — ricevi un’email all’admin con oggetto “Limite conversazioni in avvicinamento”. Il widget passa a banner arancione.
- 100% (limite raggiunto) — ricevi una seconda email con oggetto “Limite conversazioni raggiunto”. Brigata AI si mette in pausa fino al prossimo ciclo di fatturazione: i clienti che provano a chattare vedono un messaggio tipo “Brigata e’ in pausa, contatta la pizzeria al 06/12345”
- Il menu self-service, carrello, ordini, pagamenti continuano a funzionare normalmente: solo la chat AI e’ in pausa
- Al rinnovo del ciclo (1 del mese o data fatturazione configurata), il contatore si azzera e Brigata torna disponibile
Quando rinnova il ciclo?
Il ciclo si rinnova ogni mese al billingCycleDay (campo del
ristorante, default = 1 del mese). Se la tua pizzeria e’ stata creata
con billingCycleDay = 15, il ciclo va dal 15 al 14 del mese successivo.
Suggerimento: controlla il widget almeno 1 volta a settimana. Se ad inizio mese hai gia’ consumato il 30%, e’ probabile che superi il limite a fine mese: meglio fare upgrade in anticipo (vedi sezione 55) invece di farti bloccare la chat in pieno servizio del sabato sera.
Attenzione: se sei vicino al limite, evita di testare Brigata aprendo conversazioni a ripetizione dal tuo telefono per “vedere come risponde”: ogni test conta come conversazione vera. Per testare il menu, usa il pannello admin
/admin/menuo un account separato.