Documentazione

Crediti e metering

Comprendi il sistema di crediti, monitora i consumi e configura gli alert di budget.

betool addebita a consumo in crediti: 1 credito = 0,0001 € (un decimillesimo di euro). Ricarichi il tuo saldo in anticipo; ogni esecuzione addebita il costo corrispondente.

Perché i crediti

Il sistema di crediti consente:

  • Granularità fine — una chiamata API da $0.000003 è misurabile senza arrotondamenti.
  • Stabilità dei prezzi — i tuoi prezzi unitari in crediti non cambiano quando un provider rivede le sue tariffe.
  • Suddivisione per organizzazione — ogni org ha il proprio saldo e i propri alert.

Cosa si paga?

Consulta i dettagli in Prezzi. Riepilogo:

  • LLM — su un modello gestito, per token di input / output. Con BYOK, nulla: paghi direttamente il tuo provider, betool non prende nulla sui token.
  • Voce — ASR al secondo, TTS al carattere.
  • Telefonia — nessun prezzo al minuto di per sé: una chiamata viene fatturata in base alle sue componenti (trascrizione, sintesi vocale, LLM).
  • Operatori HTTP / DB / transform — non soggetti a metering.

Ricaricare il saldo

Due modalità:

  • Manuale — da Impostazioni dell'organizzazione → Piano (pulsante Ricarica), aggiungi un importo una tantum.
  • Ricarica automatica — ricarica automatica quando il saldo scende sotto una soglia. Consigliata per evitare interruzioni.

Monitorare i consumi

Impostazioni dell'organizzazione → Consumo:

  • Saldo corrente
  • Cronologia dei consumi filtrabile per periodo
  • Ripartizione per nodo di pipeline e per tipo di risorsa

La tabella è esportabile in Excel per l'integrazione con il tuo monitoraggio interno.

Alert

Due alert automatici proteggono il tuo saldo:

  • Saldo basso — quando il saldo scende sotto una soglia, gli amministratori dell'org vengono avvisati (in-app + email).
  • Saldo esaurito — quando il saldo arriva a zero, parte immediatamente un alert distinto.

Combinali con la ricarica automatica (soglia + importo, configurabili per organizzazione) per non arrivare mai all'interruzione.

Rifiuto pre-chiamata

Se il tuo saldo è insufficiente per eseguire una chiamata LLM o una chiamata telefonica, betool rifiuta l'esecuzione prima di qualsiasi addebito, con un errore esplicito out of credits visibile nella cronologia.

Nessun sovrapprezzo è possibile: una chiamata non parte mai senza credito disponibile.

Archiviazione dei file

Il tuo piano può fissare un'archiviazione consentita: il volume di file che la tua organizzazione conserva in betool — file della base di conoscenza, allegati ricevuti, file prodotti dai tuoi processi. Un piano senza limite mostra Archiviazione illimitata.

L'utilizzo si segue in Impostazioni dell'organizzazione → Piano, sezione Archiviazione: volume utilizzato, quota del piano consumata, e un indicatore che segnala il superamento dell'80 % e poi l'archiviazione piena.

Il limite viene controllato a ogni scrittura di file, prima dell'invio allo storage:

  • Scritture decise dalla tua organizzazione — importazione nella base di conoscenza, file prodotti da un nodo (download, estrazione di archivio, divisione di PDF, esportazione Excel…): oltre il limite, la scrittura viene rifiutata e non viene scritto nulla. Il nodo interessato passa per il suo percorso di errore; un nodo che produce più file ritira quelli che aveva già scritto.
  • File inviati dai tuoi contatti — allegati di email, media di messaggistica, file ricevuti tramite webhook: sempre accettati, anche oltre il limite (non si perde mai il messaggio di un cliente), e conteggiati nel tuo utilizzo.

Per ritrovare margine: elimina dei file (eliminare un documento dalla base di conoscenza elimina il suo file) o passa a un piano superiore.

Per gli sviluppatori

Se chiami l'API admin, l'endpoint GET /api/admin/billing/state restituisce il tuo piano, il tuo saldo e lo stato della ricarica automatica; GET /api/admin/billing/storage-usage restituisce il tuo utilizzo di archiviazione e il suo limite. Una scrittura di file rifiutata per archiviazione piena risponde 507 Insufficient Storage.