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

Fatturazione e utilizzo

La fatturazione ha ambito organizzazione: i piani dei prodotti, 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 i piani incidono sui limiti operativi. 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 Utenti, team e ruoli 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

Ogni prodotto ha un proprio piano, scelto in modo indipendente: un'organizzazione può avere contemporaneamente un piano SMS a pagamento, un piano Realtime e il piano Email Free, e lasciare Voice in pay-as-you-go. Ogni piano ha un livello (ad esempio free, startup, growth o scale) e uno di due comportamenti finanziari. Un piano di finanziamento aggiunge un deposito mensile al wallet condiviso e addebita l'utilizzo dal primo invio; un piano di capacità acquista un utilizzo incluso e non aggiunge nulla al wallet. Piani e prezzi spiega entrambi, e la pagina Billing overview elenca i piani attuali della tua organizzazione.

Il piano determina il comportamento operativo della tua integrazione:

  • I limiti delle richieste aumentano con il livello. Ogni piano imposta i valori delle policy del proprio prodotto, come sms_send o whatsapp_send, e i livelli superiori impostano valori più alti. Senza un piano, si applica il valore predefinito della policy. Un override attivo a livello di organizzazione ha la precedenza su qualsiasi piano. Vedi come viene risolto il tuo limite.
  • Le quote aumentano con il livello. I piani impostano conteggi come le chiamate Voice simultanee, le connessioni Realtime, i domini di invio, gli IP dedicati e gli endpoint webhook. Quando raggiungi una quota, la nuova risorsa, chiamata o connessione viene rifiutata con un errore specifico, distinto da una risposta 429 di limitazione delle richieste.
  • I volumi inclusi terminano ai limiti del piano. Il piano Email Free si ferma ai limiti mensili e giornalieri, e un piano Realtime si ferma ai limiti di connessioni e di messaggi giornalieri. I piani Email a pagamento non hanno volume incluso: ogni invio viene addebitato sul wallet.

Per leggere i valori pubblicati di qualsiasi piano senza autenticazione, elenca il catalogo dei piani con bird billing plans list --commercial-product sms. Ogni piano restituisce financial_behavior, rate_limits e quotas. La tabella di confronto nella pagina dei prezzi di ciascun prodotto mostra questi valori accanto ai valori predefiniti pay-as-you-go: confrontali lì prima di fare un upgrade per ottenere più capacità.

Gli upgrade si applicano quando il pagamento va a buon fine, quindi i nuovi limiti arrivano a metà periodo senza cambiare la data di rinnovo. I downgrade e le cancellazioni hanno effetto alla fine del periodo corrente, e un rinnovo non pagato riporta quel prodotto al piano gratuito o ai limiti pay-as-you-go. Vedi Cambi di piano e rinnovi per le regole di tempistica. Progetta le integrazioni per gestire gli errori di limite quando un piano cambia o un volume incluso si esaurisce.

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 conteggiano l'utilizzo rispetto al volume incluso in un piano (invii email sul piano Email Free o su un piano Email legacy). La pagina mostra quanto del volume hai consumato e, su un piano legacy con eccedenza, di quanto lo hai superato.
  • I prodotti pay-as-you-go sono fatturati per singolo utilizzo su una tariffa a listino (SMS, WhatsApp, Voice e le email su un piano Email a pagamento), alla tariffa del piano quando il piano ne prevede una. 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 transitano gli addebiti di utilizzo. Gli invii pay-as-you-go, gli abbonamenti aggiuntivi e i rinnovi dei piani Email legacy vengono addebitati sul wallet. I piani funding lo alimentano: ogni deposito mensile pagato viene aggiunto per intero e può pagare qualsiasi prodotto. Anche una carta salvata lo alimenta tramite ricariche manuali e ricarica automatica, e paga direttamente i rinnovi dei piani. 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. Metodi di pagamento e 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: i canoni dei piani di capacità, gli addebiti e le eccedenze dei piani legacy e la spesa pay-as-you-go del periodo. Il deposito di un piano di finanziamento è una ricarica del wallet con una propria ricevuta; l'utilizzo che copre compare in fattura. Per la struttura delle fatture, gli stati e le tempistiche di pagamento, vedi Utilizzo, spesa e fatture nella Knowledge base.

Prossimi passi