Questa pagina è stata tradotta dall'API Cloud Translation.

Modello di fatturazione statunitense

Questo documento descrive il modello di fatturazione per il traffico RCS for Business sugli operatori statunitensi.

Per informazioni sul modello di fatturazione standard (per il traffico non statunitense), consulta le domande frequenti sulla fatturazione.
Per informazioni sui report, consulta la guida ai report sulla fatturazione e ai log attività.

Panoramica delle classificazioni di fatturazione negli Stati Uniti

Ogni messaggio inviato o ricevuto da un numero di telefono statunitense viene classificato automaticamente in uno dei tre tipi in base al formato:

Messaggio avanzato (bidirezionale)
Messaggio rich media (bidirezionale)
Clic su azione suggerita (avviata dall'utente)

Per le specifiche dettagliate, consulta le sezioni seguenti.

Una nota sulla terminologia

Per descrivere la direzione del traffico di messaggistica, gli operatori statunitensi in genere utilizzano la terminologia MT/MO. Questi termini corrispondono alla terminologia A2P/P2A utilizzata in tutta la documentazione di RCS for Business:

MT (Mobile Terminated) è A2P (Application-to-Person): un messaggio inviato dall'attività.
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 illustra la logica di fatturazione per i messaggi inviati da un agente (ovvero, messaggi A2P o MT).

Messaggi formattati (A2P)

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

Testo
Risposte suggerite
Azioni suggerite solo dei seguenti tipi:
- Comporre un numero
- Apri URL nel browser standard, non in una webview

Logica di fatturazione per i messaggi avanzati

Un messaggio avanzato viene fatturato in base ai segmenti.

Dimensioni segmento: 1 segmento = 160 byte di testo codificato UTF-8.
Calcolo: la lunghezza totale in byte UTF-8 del testo del messaggio viene divisa per 160 e sempre arrotondata per eccesso al numero intero più vicino.
Esclusioni: i dati di testo e postback all'interno di 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 a 2).

Conteggio dei byte

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

Per controllare il conteggio esatto dei byte di un messaggio, digitalo o incollalo di seguito.

Messaggi rich media (A2P)

Un messaggio viene classificato come messaggio rich media se contiene almeno uno dei seguenti elementi:

Una scheda interattiva o un carosello (anche senza contenuti multimediali)
Un allegato di file multimediali (immagine, video, audio)
Un'azione suggerita diversa da Chiama un numero o Apri URL con il browser, tra cui:

Logica di fatturazione per i messaggi rich media

Un messaggio rich media viene fatturato come un singolo evento a tariffa fissa.

La fatturazione è la stessa indipendentemente dalla lunghezza del testo, dal numero di schede o dalle dimensioni del file multimediale.
La segmentazione non si applica.

Esempi di risposte dell'API A2P

Questi esempi mostrano il campo richMessageClassification in una risposta corretta alla chiamata all'API RBM per i messaggi inviati dall'agente.

Esempio di risposta dell'API per un `RICH_MESSAGE`

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

Esempio di risposta dell'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 riguarda la fatturazione di messaggi e azioni avviati da un utente (ovvero messaggi P2A o MO).

Messaggi formattati (P2A)

Un messaggio utente viene classificato come Rich Message se contiene solo testo. Sono inclusi sia il testo in formato libero sia il testo risultante dal tocco di una risposta suggerita. (Le risposte suggerite potrebbero includere un identificatore di dati di postback nel payload del messaggio.)

Logica di fatturazione: fatturazione basata sui segmenti. Per informazioni dettagliate sui calcoli del conteggio dei segmenti, consulta Logica di fatturazione per i messaggi avanzati.

Messaggi rich media (P2A)

Un messaggio viene classificato come messaggio rich media se contiene un file caricato (immagine, video, audio).

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

Clic sulle azioni suggerite

Un tocco dell'utente su una qualsiasi azione suggerita genera un evento fatturabile chiamato clic su azione suggerita. (Le azioni suggerite potrebbero includere un identificatore dei dati postback nel payload del messaggio.)

Logica di fatturazione: genera un evento fatturabile per clic.

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

Clic sull'azione suggerita: il tocco dell'utente sull'azione suggerita Condividi posizione genera un evento Clic sull'azione suggerita.
Il messaggio di posizione:dopo che l'utente seleziona una posizione dall'interfaccia della mappa, viene inviato all'agente un messaggio con le coordinate della posizione. Questo messaggio MO genera un evento Rich Message con un conteggio dei segmenti pari a uno.

Esempi di risposte webhook P2A

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

Webhook di esempio 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
  }
}

Webhook di esempio 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"
  }
}

Webhook di esempio per un `SUGGESTED_ACTION_CLICK`

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

Webhook di esempio per un messaggio di posizione

Si tratta del secondo evento fatturabile 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
    }
}

Note tecniche e sull'implementazione

I segmenti vengono utilizzati solo a fini di fatturazione: i messaggi lunghi vengono inviati come singola unità al dispositivo dell'utente. Il conteggio dei segmenti è un calcolo virtuale a fini di fatturazione; non influisce sul modo in cui i messaggi vengono recapitati o presentati all'utente.
Classificazione automatica: la classificazione dei messaggi è completamente automatica in base ai contenuti dei messaggi e 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 questa data, i report e le risposte API di Google riflettono le nuove classificazioni.