Questa pagina descrive i file di dati che RCS for Business crea per assistere gli operatori statunitensi nelle attività di fatturazione e audit previste dal quadro normativo US RBM. Per ulteriori informazioni sul quadro normativo US RBM, è possibile consultare il sito usrbm.org .
Il report di fatturazione è un report aggregato degli eventi fatturabili tra agenti e utenti abilitati. Fatturabile significa semplicemente che un evento è idoneo a generare un addebito. Gli operatori telefonici determinano se e come vengono addebitati gli eventi fatturabili. Tutti gli operatori telefonici statunitensi che utilizzano attivamente RCS for Business hanno accesso ai report di fatturazione.
Per maggiori dettagli sul modello di classificazione della fatturazione negli Stati Uniti, consultare le FAQ sulla fatturazione negli Stati Uniti .
Generazione file
Per ulteriori informazioni, vedere Generazione file .
Archiviazione e accesso ai file
Per ulteriori informazioni, consultare la sezione Archiviazione e accesso ai file .
Disponibilità dei file
Per ulteriori informazioni, consultare la sezione Disponibilità dei file .
Rapporti di fatturazione
I report di fatturazione sono registrazioni di eventi fatturabili , calcolati in base alla categoria di fatturazione dell'agente e al tipo di messaggi inviati. I report di fatturazione sono disponibili per tutti gli operatori che utilizzano attivamente RCS for Business.
I report di fatturazione contengono informazioni riservate, ma nessuna informazione personale identificabile (PII) dell'utente, come MSISDN, MSISDN crittografato o qualsiasi altro identificativo univoco dell'utente.
Categorie di fatturazione rispetto agli eventi fatturabili
La distinzione tra categorie di fatturazione degli agenti ed eventi fatturabili è fondamentale per comprendere come viene calcolata la fatturazione del vostro agente.
- La categoria di fatturazione è una classificazione fissa che si sceglie al momento della creazione dell'agente. Determina la modalità di fatturazione dell'agente: per messaggio (agenti non conversazionali) o per sessione (agenti conversazionali).
- Gli eventi fatturabili sono interazioni tra un agente RCS for Business e un utente che vengono tracciate a fini di fatturazione (ad esempio,
rich_message).
Categorie di fatturazione degli agenti statunitensi
Quando si crea un agente, il proprietario ne imposta la categoria di fatturazione in base a come l'agente interagirà con gli utenti. La categoria di fatturazione non limita il numero o il tipo di messaggi che un agente può inviare, ma determina le modalità di fatturazione dei messaggi. Le due principali categorie di fatturazione sono descritte nella tabella seguente.
| Categoria di fatturazione | Tipo di agente | Esempi di casi d'uso | Metodo di fatturazione |
|---|---|---|---|
| Non conversazionale | Agenti che inviano principalmente messaggi unidirezionali. |
| Addebito per ogni messaggio recapitato all'utente. |
| Conversazionale | Agenti progettati per scambi bidirezionali con gli utenti, indipendentemente da chi avvia la conversazione. |
| Fatturazione a sessione : se i criteri della sessione vengono soddisfatti, tutti i messaggi multimediali e rich message all'interno della finestra temporale di 24 ore della sessione vengono fatturati a una tariffa fissa, indipendentemente dalla durata o dal numero di segmenti. Fatturazione per messaggio : se i criteri di sessione non vengono soddisfatti o se un messaggio cade al di fuori della finestra di sessione di 24 ore, il messaggio viene fatturato singolarmente a una tariffa per messaggio per i contenuti multimediali o rich media in base al listino prezzi del singolo operatore. |
Agenti conversazionali contro agenti non conversazionali
Esistono due categorie di fatturazione per gli agenti: conversazioni e non conversazioni.
Gli agenti non conversazionali vengono fatturati per ogni messaggio che consegnano all'utente.
- Questa categoria è ideale per gli agenti che non si aspettano risposte frequenti.
Gli agenti conversazionali vengono fatturati a una tariffa fissa per sessione (o sessioni) a condizione che una sessione venga attivata e includa tutti i messaggi scambiati entro un periodo di 24 ore, compresi i messaggi che hanno attivato la sessione. Gli agenti conversazionali possono comunque addebitare costi per i messaggi che non fanno parte di una sessione di 24 ore.
- Questa categoria è ideale per gli agenti che intrattengono conversazioni a più turni con gli utenti.
Logica di fatturazione della sessione
Secondo il modello di fatturazione statunitense, una sessione viene attivata da una sequenza di 4 messaggi rich o rich media (inclusi almeno 2 messaggi MO e almeno 1 messaggio MT) scambiati entro 24 ore dal primo messaggio della sequenza di attivazione. Una volta raggiunta questa soglia, tutti i messaggi scambiati entro tale intervallo di 24 ore vengono fatturati come un'unica sessione . Eventuali messaggi che non rientrano in tale intervallo o che non attivano una sessione vengono fatturati alla tariffa standard per messaggio per i messaggi rich o rich media, secondo il listino prezzi del singolo operatore.
Il diagramma seguente mostra un esempio di sessione di fatturazione A2P per agenti conversazionali.
- MT (Mobile Terminated) è un messaggio inviato dall'azienda.
- MO (Mobile Originated) è un messaggio o un'azione avviata dall'utente.
Eventi fatturabili
I flussi di messaggistica sono classificati in base alla loro origine e direzione. Per descrivere la direzione del traffico di messaggistica, gli operatori statunitensi utilizzano in genere la terminologia MT/MO . Questi termini corrispondono alla terminologia A2P/P2A utilizzata nella documentazione di RCS for Business. Ecco una breve spiegazione di come questi termini si allineano:
- A2P (Application-to-Person) è MT (Mobile Terminated) : un messaggio inviato dall'azienda.
- P2A (Person-to-Application) è MO (Mobile Originated) : un messaggio o un'azione avviata dall'utente.
| Evento | Descrizione | Agenti non conversazionali | Agenti conversazionali |
|---|---|---|---|
a2p_rich_message | Un messaggio inviato dall'agente contenente solo testo, risposte suggerite o azioni specifiche suggerite (comporre un numero, aprire un URL nel browser). | Sempre trattato come un evento fatturabile singolarmente. Fatturazione a messaggio in base ai segmenti (1 segmento equivale a 160 byte UTF-8). | Viene considerato un evento fatturabile singolarmente, a meno che non diventi parte di una sessione. |
p2a_rich_message | Un messaggio inviato dall'utente contenente solo testo libero o testo generato toccando un suggerimento di risposta. | Sempre trattato come un evento fatturabile singolarmente. Fatturazione per messaggio in base ai segmenti. | Viene considerato un evento fatturabile singolarmente, a meno che non diventi parte di una sessione. |
a2p_rich_media_message | Un messaggio inviato dall'agente contenente contenuti multimediali (immagini, video, audio), schede interattive, caroselli o azioni complesse come "Visualizza posizione". | Sempre trattato come un evento fatturabile singolarmente. Fatturabile come un singolo evento a tariffa fissa, indipendentemente dalle dimensioni o dal contenuto. | Viene considerato un evento fatturabile singolarmente, a meno che non diventi parte di una sessione. |
p2a_rich_media_message | Un messaggio inviato dall'utente contenente un file multimediale caricato (immagine, video, audio). | Sempre trattato come un evento fatturabile singolarmente. Fatturabile come singolo evento a tariffa fissa. | Viene considerato un evento fatturabile singolarmente, a meno che non diventi parte di una sessione. |
p2a_suggested_action | L'utente tocca un'azione suggerita (ad esempio, "Visualizza posizione") che non sia una risposta suggerita. | Sempre trattato come un evento fatturabile singolarmente. Genera un evento fatturabile per ogni clic. | Viene trattato come un evento fatturabile individuale e genera un evento fatturabile per ogni clic, a meno che non diventi parte di una sessione. |
a2p_session | Una finestra di interazione di 24 ore che inizia quando viene attivato un trigger di sessione e il primo messaggio è MT. Per ulteriori informazioni, vedere Che cos'è una sessione e come funziona . | Non applicabile. Le sessioni non si applicano agli agenti non conversazionali. | Una volta attivata, tutti i messaggi inviati nell'arco delle 24 ore sono coperti da un'unica tariffa di sessione. A ogni evento fatturabile all'interno della sessione di 24 ore verrà assegnato l'ID dell'evento fatturabile della sessione stessa. |
p2a_session | Una finestra di interazione di 24 ore che inizia quando viene attivato un trigger di sessione e il primo messaggio è MO. Per ulteriori informazioni, vedere Che cos'è una sessione e come funziona . | Non applicabile. Le sessioni non si applicano agli agenti non conversazionali. | Una volta attivata, tutti i messaggi inviati nell'arco delle 24 ore sono coperti da un'unica tariffa di sessione. A ogni evento fatturabile all'interno della sessione di 24 ore verrà assegnato l'ID dell'evento fatturabile della sessione stessa. |
Generazione di report di fatturazione
Solo gli agenti con traffico non di test generano eventi fatturabili. L'attività proveniente da numeri di telefono di test non viene visualizzata nei report di fatturazione.
Questi report presuppongono che gli eventi siano fatturabili quando i messaggi A2P vengono recapitati, non quando vengono inviati. Un messaggio non recapitato o annullato prima della consegna non genera un evento fatturabile.
Formato del report di fatturazione
I report di fatturazione utilizzano il formato del nome file rbm_billable_events_YYYY-MM-DD.csv . La data nel nome del file corrisponde alla data di generazione del file.
Ogni riga del report rappresenta un singolo evento fatturabile. Le sessioni A2P/P2A sono rappresentate da più righe, una per ogni messaggio scambiato. Ogni riga associata a una sessione (che condivide lo stesso billing_event_id ) riporterà il numero totale di messaggi MT e MO per l'intera finestra temporale di 24 ore della sessione nelle colonne mt_messages e mo_messages .
Ogni record nel report contiene le seguenti informazioni per ogni evento fatturabile.
| Campo | Formato | Descrizione | Esempio |
|---|---|---|---|
billing_event_id | corda | ID generato che identifica l'evento fatturabile. Tutti i messaggi che fanno parte di una sessione avranno lo stesso | 63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type | corda | Tipo di evento:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action | p2a_rich_message |
agent_id | corda | Identificativo univoco dell'agente che ha partecipato all'evento. | acme_342h23_agent@rbm.goog |
agent_owner | corda | Indirizzo email dell'attuale titolare dell'account partner in cui è stato creato l'agente. | marketing@xyzaggregator.com |
billing_party | corda | Parte che emette la fattura per gli eventi. | vettore |
max_duration_single_message | numero | Tempo massimo (in ore) consentito a un utente per rispondere a un messaggio di un agente prima che la finestra di avvio della conversazione si chiuda e il messaggio venga classificato come evento single_message . Non applicabile al modello statunitense per i messaggi multimediali individuali. | 24 |
max_duration_a2p_conversation | numero | Per il progetto pilota sulle sessioni, ciò riflette la finestra temporale di 24 ore della sessione, misurata a partire dal primo messaggio nella sequenza di attivazione. La durata è misurata in ore. | 24 |
max_duration_p2a_conversation | numero | Per il progetto pilota sulle sessioni, ciò riflette la finestra temporale di 24 ore della sessione, misurata a partire dal primo messaggio nella sequenza di attivazione. | 24 |
start_time | AAAA-mm-ggTHH:00:00Z | La data e l'ora UTC di inizio dell'evento (ISO 8601). Per le sessioni, si tratta del timestamp del primo messaggio nella sequenza di attivazione. A2P a2p_rich_message e a2p_rich_media_message , questo è il momento in cui il messaggio viene recapitato all'utente.a2p_session , questo è il momento in cui il primo messaggio della conversazione viene recapitato all'utente.P2A p2a_rich_message e p2a_rich_media_message , questo è il momento in cui il messaggio viene inviato dall'utente.p2a_session , questo è il momento in cui l'utente invia il primo messaggio della conversazione. | 2025-05-20T08:00:00Z |
duration | numero | La durata si riferisce esclusivamente alle sessioni ed è misurata in minuti. Quando l'evento non fa parte di una sessione, il valore è 0. | 45 |
mt_messages | numero | Numero di messaggi terminati su dispositivo mobile (A2P) nell'evento. Per le sessioni, ogni riga che condivide lo stesso billing_event_id mostra il numero totale di messaggi MT nell'intera sessione. | 5 |
mo_messages | numero | Numero di messaggi originati da dispositivi mobili (P2A) nell'evento. Per le sessioni, ogni riga che condivide lo stesso billing_event_id mostra il numero totale di messaggi MO nell'intera sessione. | 3 |
size_kilobytes | numero | Dimensione di tutti i file allegati ai messaggi nell'evento, arrotondata al kilobyte più vicino (1 kB equivale a 1024 byte). | 912 |
agent_name | corda | Nome dell'agente che ha partecipato all'evento. | ACME Brand |
owner_name | corda | Nome del titolare attuale dell'account partner in cui è stato creato l'agente. | XYZ Aggregator |
segment_count | numero | Il conteggio dei segmenti calcolato per a2p_rich_message events e p2a_rich_message (1 segmento equivale a 160 byte UTF-8). Se l'evento non rientra in una delle categorie menzionate, il valore è 0. | 5 |
session_type | corda | Tipo di sessione:a2p_sessionp2a_session | a2p_session |
Esempio di report di fatturazione
È possibile scaricare un esempio di report:
Dimensioni tipiche del file
La dimensione di un report giornaliero proveniente da un partner RCS for Business attivo dipende dalla quantità di attività che ha generato sulla rete dell'operatore.