Sign inGet Started
Inizia ora
Guide
Riferimento API
SDK
CLI
Knowledge Base
Changelog

Fatturazione e utilizzo

La fatturazione ha ambito organizzazione: il piano, il wallet e il flusso di fatture appartengono all'organizzazione. Questa pagina spiega come la fatturazione influenza un'integrazione: come viene misurato l'utilizzo, come leggere la situazione attuale e come il livello del piano imposta i limiti operativi entro cui opera la tua integrazione. Per le operazioni sull'account (dettagli sui prezzi, metodi di pagamento, imposte), consulta la Knowledge base: Piani e prezzi e Utilizzo, spesa e fatture.
La fatturazione è gestita da persone, non da integrazioni. Ogni operazione di fatturazione richiede lo scope org:billing, uno scope a livello di ruolo organizzazione che non può essere assegnato a una chiave API dello spazio di lavoro, quindi nessuna chiave bk_* può leggere i consumi, ricaricare il wallet o cambiare piano. Owner e admin di fatturazione svolgono queste operazioni nella sezione Billing and payments della dashboard; vedi Users, teams & roles per sapere chi detiene il ruolo. I cataloghi di piani, prodotti e prezzi sono l'eccezione: non richiedono autenticazione, pubblicano i prezzi su questo sito, e CLI e MCP possono leggere direttamente il catalogo dei piani. Questa guida spiega quindi l'effetto della fatturazione sulla tua integrazione e indica la pagina della dashboard che mostra ciascun dato. Quelle pagine (Overview, Usage, Invoices, Spend e Settings) sono trattate negli articoli della Knowledge base collegati nel testo.

Piani e livelli

La tua organizzazione sottoscrive un solo piano. L'abbonamento attuale, gli upgrade e la cancellazione si trovano nella pagina Billing overview. Ogni piano ha un tier (free, startup, growth o enterprise), ed è il tier a determinare i limiti operativi della tua integrazione:
  • Volume di invio incluso. Ogni piano include una quota mensile di invii email, misurata per destinatario: un messaggio a tre destinatari consuma tre invii. Nei piani a pagamento, gli invii oltre la quota vengono conteggiati come eccedenza fino a un tetto massimo; oltre il tetto, gli invii vengono rifiutati con un errore di limite fino al reset del periodo. Il piano Free non ha eccedenza: si ferma ai limiti mensili e giornalieri. Quote, limiti e tetto di eccedenza sono in Piani e prezzi.
  • I tetti di limitazione delle richieste crescono con il piano. I limiti partono da un valore base, il piano lo sostituisce con uno più alto, e un override per organizzazione li sostituisce entrambi, così i piani superiori alzano i tetti di invio e lettura. Il modello, il rate base di ogni gruppo e gli header sono descritti in Limiti delle richieste.
  • Limiti sulle risorse. Tetti come il numero di domini di invio, pool di IP e IP dedicati che la tua organizzazione può avere sono impostati per piano e regolabili per organizzazione. Se ne raggiungi uno, contatta il supporto anziché aggirarlo.
Gli upgrade si applicano immediatamente, rendendo disponibile l'intera nuova quota per il resto del periodo corrente. I downgrade e le cancellazioni hanno effetto alla fine del periodo di fatturazione corrente. Vedi Cambi di piano e rinnovi per la sequenza in caso di pagamento fallito e le altre regole di tempistica. Progetta le integrazioni per gestire gli errori quando un account supera la propria quota.

Misurazione dell'utilizzo

Ogni invio è conteggiato rispetto al periodo di fatturazione corrente della tua organizzazione. La pagina Usage della dashboard mostra la situazione in tempo reale per ogni prodotto, sulla finestra temporale con cui quel prodotto viene misurato: il periodo del piano per le email a consumo, il mese di calendario per il pay-as-you-go. I prodotti si fatturano in uno di due modi, e la differenza è ciò che la tua integrazione percepisce:
  • I prodotti a consumo hanno un volume incluso nel piano (invii email). La pagina mostra quanto del volume hai consumato e di quanto lo hai superato, così puoi vedere un overage accumularsi prima che venga fatturato.
  • I prodotti pay-as-you-go sono fatturati per singolo utilizzo su una tariffa a listino (SMS, WhatsApp). Un messaggio può addebitare il wallet due volte: la tariffa propria di Bird quando l'invio viene elaborato, e una tariffa di terze parti (un sovrapprezzo dell'operatore su SMS, la quota di Meta su WhatsApp) quando il messaggio viene recapitato. Leggi la suddivisione per messaggio da cost sul messaggio SMS o WhatsApp: transaction_amount è l'addebito di Bird e passthrough_amount la tariffa di terze parti.
La pagina copre ogni prodotto con un abbonamento o un utilizzo nel periodo corrente, e mostra i grafici con la suddivisione giornaliera, per paese e per dominio di invio per ciascuno di essi.
La pagina Usage nella dashboard di Bird: spesa totale con proiezione, conteggi invii per canale e grafici di utilizzo giornaliero

Il wallet

Ogni organizzazione ha un wallet: un saldo prepagato condiviso attraverso cui transita ogni addebito. Rinnovi del piano, overage e invii pay-as-you-go vengono tutti addebitati sul wallet; una carta salvata serve a ricaricarlo (ricariche manuali, ricarica automatica e copertura di un rinnovo che il saldo non può coprire). La pagina Spend della dashboard è il registro completo di crediti e addebiti: ogni movimento del wallet è tracciato in un unico posto, e ogni ricarica andata a buon fine produce una ricevuta permanente scaricabile come PDF dalla stessa sezione.
A livello operativo, il wallet è una dipendenza dell'invio pay-as-you-go: gli invii SMS e WhatsApp vengono rifiutati quando il saldo non può coprirli. SMS viene rifiutato alla API con un 402; un invio WhatsApp viene accettato e poi rifiutato quando Bird tenta di addebitarlo. Una tariffa al momento della consegna che il saldo non può coprire viene saltata anziché rifiutata, quindi il messaggio raggiunge comunque il destinatario. Per volumi transazionali, configura la ricarica automatica e un avviso di saldo basso nella pagina Billing overview, oppure monitora e genera alert dal tuo lato. Payment methods and wallet descrive entrambi i controlli della dashboard. Gli avvisi di saldo basso e le notifiche di pagamento fallito vengono inviati agli owner dell'organizzazione. Le email relative alle fatture vengono inviate alla lista di notifiche di fatturazione dell'organizzazione, se configurata, altrimenti all'owner dell'organizzazione. Configura quella lista in Settings > Organization. Usa un alias di team monitorato, in modo che le comunicazioni di fatturazione non dipendano dalla casella di posta di una singola persona.

Fatture

Le fatture vengono emesse per organizzazione, una per mese di calendario, e sono elencate nella pagina Invoices della dashboard, dove puoi aprirne una per vederne le voci o scaricarla come PDF. Le fatture riflettono lo stesso conteggio mostrato nella pagina Usage: l'addebito ricorrente del piano più eventuali overage a consumo e spesa pay-as-you-go del periodo. Per la struttura delle fatture, gli stati e le tempistiche di pagamento, vedi Usage, spend & invoices nella Knowledge base.

Prossimi passi

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Esplora la funzionalitàBird pricing
Ottieni un brief di implementazione