Rela AIRela AI Docs
Amministrazione

Fatturazione e Abbonamenti

Gestione dei piani, limiti di utilizzo e misurazione dei consumi per tenant.

Quando usare questa guida

Consulta questa pagina quando devi capire cosa include ogni piano, come funzionano i limiti di utilizzo, o quando vuoi valutare se e il momento di cambiare piano.

Esempio pratico: La tua organizzazione ha 3 agenti WhatsApp e 2 agenti email, e sta elaborando 8.000 eventi al mese. Il piano Starter (5 agenti, 10.000 eventi) e sufficiente per ora, ma al ritmo di crescita attuale, tra 2 mesi avrai bisogno del piano Professional. Controlla la sezione eccedenze per capire i costi se superi il limite prima dell'upgrade.

Quando fare l'upgrade: L'upgrade sblocca piu interazioni, agenti e funzionalita. Ad esempio, il piano Starter con 5 agenti e 10.000 eventi/mese e sufficiente per un piccolo impianto con 5 agenti. Il piano Professional con 20 agenti e 100.000 eventi e ideale per operazioni con piu linee di produzione e monitoraggio intensivo.


Piani di Abbonamento

Rela AI offre quattro piani adattati a diverse esigenze:

PianoAgentiEventi/meseStrumentiArchiviazione
Free15005100 MB
Starter510.000251 GB
Professional20100.00010010 GB
EnterpriseIllimitatoIllimitatoIllimitatoPersonalizzato

Ogni tenant viene associato a un piano al momento della creazione. Il piano determina i limiti delle risorse e le funzionalità disponibili.

Applicazione dei Limiti

Il sistema verifica i limiti prima di ogni operazione di creazione risorse. Quando un tenant raggiunge il limite del piano, l'API risponde con HTTP 403:

{
  "detail": "Plan limit reached: max 5 agents for starter plan"
}

Le verifiche vengono eseguite in tempo reale consultando il conteggio attuale delle risorse rispetto ai limiti definiti nel piano.

Feature Gating

Le funzionalità avanzate sono limitate per piano. Il campo features del piano definisce quali capacità sono abilitate:

  • sso — Solo Enterprise
  • white_label — Professional ed Enterprise
  • audit_export — Professional ed Enterprise
  • custom_domain — Enterprise
  • api_priority — Enterprise

Se un tenant tenta di accedere a una funzionalità non inclusa nel proprio piano, riceve HTTP 403 con dettaglio della funzionalità richiesta.

Misurazione dell'Utilizzo

La dashboard di utilizzo mostra metriche in tempo reale:

  • Agenti attivi — Conteggio degli agenti creati
  • Eventi elaborati — Totale del periodo corrente
  • Archiviazione utilizzata — Spazio consumato in byte
  • Chiamate API — Richieste effettuate nel periodo

I dati vengono aggiornati ogni 5 minuti e sono esposti sia nella dashboard che tramite l'endpoint GET /api/v1/admin/billing/usage.

Reset Mensile

I contatori di utilizzo si azzerano automaticamente il primo giorno di ogni mese alle 00:00 UTC. Il processo:

  1. Viene generato uno snapshot dell'utilizzo del periodo precedente
  2. Il registro storico viene archiviato per la fatturazione
  3. I contatori vengono azzerati
  4. Il tenant viene notificato se applicabile

Lo storico di utilizzo viene conservato per 24 mesi per consultazioni e audit.

Calcolo degli Eccedenti

Quando un tenant supera i limiti del piano durante il periodo di fatturazione:

  • Eventi: Addebito per blocchi aggiuntivi di 1.000 eventi
  • Archiviazione: Addebito per GB aggiuntivo utilizzato
  • Chiamate API: Viene applicato il throttling dopo il limite, nessun costo aggiuntivo

Il calcolo dell'eccedenza viene eseguito alla chiusura del periodo:

eccedenza = max(0, utilizzo_attuale - limite_piano) * tariffa_eccedenza

I tenant Enterprise hanno tariffe di eccedenza negoziate individualmente. La dashboard mostra proiezioni di eccedenza basate sul consumo attuale.

Avvisi automatici vengono inviati al raggiungimento dell'80% e del 95% del limite.


Vedi anche

In questa pagina