Modello di fatturazione statunitense

Questo documento illustra il modello di fatturazione per il traffico RCS for Business sulle reti degli operatori statunitensi.

Importante: gli operatori statunitensi stabiliscono il prezzo per le tipologie di messaggi a pagamento descritte nelle sezioni seguenti. Determinano inoltre l'importo finale addebitato allo sviluppatore per l'invio di messaggi RCS for Business. Questo documento funge da guida informativa su come vengono definiti i tipi di messaggi e gli eventi a pagamento nel mercato statunitense. Per "a pagamento" si intende semplicemente che un evento è soggetto a un addebito. Gli operatori stabiliscono se e come vengono addebitati gli eventi a pagamento. Per ulteriori informazioni su prezzi o fatturazione, si prega di contattare i rappresentanti dell'operatore competente.

• Per informazioni sul modello di fatturazione standard (per il traffico non statunitense), consultare le FAQ sulla fatturazione .
• Per informazioni sulla creazione di report, consultare la guida ai report di fatturazione e ai registri delle attività .

Panoramica delle classificazioni di fatturazione negli Stati Uniti

Ogni messaggio inviato o ricevuto da un numero di telefono statunitense viene automaticamente classificato in una delle seguenti tipologie in base al suo formato:

• Messaggio ricco (bidirezionale)
• Messaggio multimediale (bidirezionale)

È possibile combinare diversi tipi di messaggi in una sessione . Per ulteriori informazioni sulle sessioni, vedere Fatturazione delle sessioni (Pilot) .

Per le specifiche dettagliate, fare riferimento alle sezioni seguenti.

Una nota sulla terminologia

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 in tutta la documentazione RCS for Business:

• MT (Mobile Terminated) è A2P (Application-to-Person) : un messaggio inviato dall'azienda.
• MO (Mobile Originated) è P2A (Person-to-Application) : un messaggio o un'azione avviata dall'utente.

Fatturazione degli eventi da agente a persona (A2P/MT)

Questa sezione descrive la logica di fatturazione per i messaggi inviati da un agente (ovvero, messaggi A2P o MT).

Messaggi Rich (A2P)

Un messaggio viene classificato come messaggio ricco (Rich Message) se contiene solo una combinazione dei seguenti elementi:

• Testo
• Risposte suggerite
• Si suggeriscono solo le seguenti azioni:
  • Componi un numero
  • Apri l'URL nel browser standard, non in una webview.

Logica di fatturazione per i messaggi avanzati

Un messaggio formattato (Rich Message) viene fatturato in base ai segmenti.

• Dimensione del segmento : 1 segmento = 160 byte di testo codificato in UTF-8.
• Calcolo : La lunghezza totale del testo del messaggio in byte UTF-8 viene divisa per 160 e il risultato viene sempre arrotondato per eccesso al numero intero più vicino.
• Esclusioni : il testo e i dati di postback presenti nelle risposte o azioni suggerite non sono inclusi nel conteggio dei segmenti.
• Esempio : un messaggio di testo di 300 byte ha 2 segmenti (300 / 160 = 1,875, arrotondato per eccesso a 2).

Conteggio dei byte

Alcuni caratteri Unicode (come le emoji o le lettere accentate) sono multibyte, quindi il conteggio totale dei byte UTF potrebbe differire dal conteggio dei caratteri.

Per verificare il numero esatto di byte di un messaggio, digitalo o incollalo qui sotto.

Messaggi multimediali (A2P)

Un messaggio viene classificato come messaggio multimediale (Rich Media Message) se contiene almeno uno dei seguenti elementi:

• Una carta ricca o un carosello (anche senza media)
• Allegato di un file multimediale (immagine, video, audio)
• Un'azione suggerita diversa da "Chiama un numero" o "Apri l'URL con il browser" include:
  • Visualizza la posizione
  • Condividi la posizione
  • Crea evento del calendario
  • Apri l'URL in una visualizzazione web

Logica di fatturazione per i messaggi multimediali

Un messaggio multimediale (Rich Media Message) viene fatturato come un singolo evento a tariffa fissa.

• La fatturazione rimane invariata indipendentemente dalla lunghezza del testo, dal numero di schede o dalle dimensioni del file multimediale.
• La segmentazione non è applicabile.

Esempi di risposta API A2P

Questi esempi mostrano il campo richMessageClassification in una risposta di chiamata API RBM andata a buon fine per i messaggi inviati dall'agente.

Esempio di risposta API per un RICH_MESSAGE

{
  "name": "...",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "contentMessage": {
     ...
  },
  "richMessageClassification": {
    "classificationType": "RICH_MESSAGE",
    "segmentCount": 5
  }
}

Esempio di risposta API per un RICH_MEDIA_MESSAGE

{
  "name": "...",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "contentMessage": {
     ...
  },
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

Fatturazione degli eventi da persona ad agente (P2A/MO)

Questa sezione tratta la fatturazione dei messaggi e delle azioni avviate da un utente (ovvero, messaggi P2A o MO).

Messaggi multimediali (P2A)

Un messaggio utente viene classificato come messaggio formattato (Rich Message) se contiene solo testo. Ciò include sia il testo libero sia il testo risultante dalla selezione di una risposta suggerita . (Le risposte suggerite possono includere un identificatore di dati di postback nel payload del messaggio.)

Logica di fatturazione : la fatturazione si basa sui segmenti. Per i dettagli sul calcolo del numero di segmenti, consultare la sezione "Logica di fatturazione per i messaggi formattali" .

Messaggi multimediali (P2A)

Un messaggio viene classificato come messaggio multimediale (Rich Media Message) se contiene un file caricato (immagine, video, audio).

Logica di fatturazione : Fatturazione come evento unico a tariffa fissa. La segmentazione non si applica.

Clic sulle azioni suggerite

Il tocco di un utente su una qualsiasi azione suggerita genera un evento fatturabile chiamato "Clic su azione suggerita". (Le azioni suggerite possono includere un identificatore di dati di postback nel payload del messaggio.)

Logica di fatturazione : genera un evento fatturabile per ogni clic.

Nota: il tocco dell'utente su una risposta suggerita (che invia testo) non genera un clic su un'azione suggerita. Il messaggio risultante viene invece fatturato come messaggio formattato .

Caso speciale: condivisione della posizione

La condivisione della posizione è unica in quanto genera due eventi fatturabili P2A separati:

• L'evento Clic sull'azione suggerita : il tocco dell'utente sull'azione suggerita Condividi posizione genera un evento Clic sull'azione suggerita .

• Messaggio di posizione: Dopo che l'utente ha selezionato una posizione dall'interfaccia della mappa, viene inviato all'agente un messaggio contenente le coordinate della posizione. Questo messaggio MO genera un evento Rich Message con un conteggio di segmenti pari a uno.

Esempi di risposta al webhook P2A

Questi esempi mostrano il campo richMessageClassification nei webhook inviati all'agente per gli eventi avviati dall'utente.

Esempio di webhook per un RICH_MESSAGE inviato dall'utente

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "text": "Hello, world!",
  "richMessageClassification": {
    "classificationType": "RICH_MESSAGE",
    "segmentCount": 1
  }
}

Esempio di webhook per un RICH_MEDIA_MESSAGE inviato dall'utente

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "userFile": "...",
  "payload": "...",
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

Esempio di webhook per un SUGGESTED_ACTION_CLICK

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "suggestionResponse": {
        "text": "Click here",
        "postbackData": "...",
        "type": "ACTION"
    },
    "richMessageClassification": {
        "classificationType": "SUGGESTED_ACTION_CLICK"
    }
}

Esempio di webhook per un messaggio di posizione

Questo è il secondo evento a pagamento nel flusso di condivisione della posizione , inviato dopo che l'utente ha condiviso la propria posizione dalla mappa.

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "location": {
      "latitude": 37.422000,
      "longitude": -122.084056
    },
    "richMessageClassification": {
        "classificationType": "RICH_MESSAGE",
        "segmentCount": 1
    }
}

Fatturazione della sessione (Pilot)

Mentre l'attuale modello di fatturazione statunitense addebita il costo dei singoli messaggi, il progetto pilota di fatturazione a sessione introduce un modo per raggruppare intere conversazioni tra utente e marchio e/o tra marchio e utente in un unico evento fatturabile: p2a_session o a2p_session .

Un evento di sessione fatturabile viene registrato e addebitato quando vengono raggiunte specifiche soglie di interazione entro un intervallo continuativo di 24 ore. Per ulteriori informazioni, consulta la sezione "Che cos'è una sessione e come funziona" .

Note tecniche e di implementazione

• I segmenti sono utilizzati esclusivamente a fini di fatturazione : i messaggi lunghi vengono recapitati come un'unica unità al dispositivo dell'utente. Il conteggio dei segmenti è un calcolo virtuale a fini di fatturazione e non influisce sulla modalità di recapito o di visualizzazione dei messaggi all'utente.
• Classificazione automatica : la classificazione dei messaggi è completamente automatica e si basa sul contenuto del messaggio; non può essere modificata manualmente.
• Implementazione : il modello di fatturazione statunitense è stato attivato sulla piattaforma RCS for Business il 15 luglio 2025. A partire da tale data, i report e le risposte API di Google riflettono le nuove classificazioni.