This document outlines the billing model for RCS for Business traffic on US
carriers.

> [!IMPORTANT]
> **Important:** US carriers set the price for the billable message types described in the following sections. They also determine the developer's final charge for sending RCS for Business messages. This document serves as an informative guide on how billable message types and events are defined in the US market. Billable simply means that an event is eligible for a charge. Carriers determine whether and how billable events are charged. For additional pricing or billing information, please contact the appropriate carrier representatives.

- For information about the standard billing model (for non-US traffic), see the [Billing FAQ](https://developers.google.com/business-communications/rcs-business-messaging/carriers/billing/rbm-billing-faq).
- For information about reporting, see the guide to [Billing reports and activity logs](https://developers.google.com/business-communications/rcs-business-messaging/carriers/billing/reports).

## Overview of US billing classifications

Every message to or from a US phone number is automatically classified into
one of the following types based on its format:

- Rich Message (bi-directional)
- Rich Media Message (bi-directional)

Multiple types of messages can be combined into a **session** . For more
information about sessions, see [Session billing (Pilot)](https://developers.google.com/business-communications/rcs-business-messaging/carriers/billing/us-billing-model#session-billing).

Refer to the following sections for detailed specifications.

### A note on terminology

To describe the direction of messaging traffic, US carriers typically
use MT/MO terminology. These terms correspond to the A2P/P2A terminology used
throughout the RCS for Business documentation:

- **MT (Mobile Terminated) is A2P (Application-to-Person)**: A message sent by the business.
- **MO (Mobile Originated) is P2A (Person-to-Application)**: A message or action initiated by the user.

## Agent-to-Person (A2P/MT) event billing

This section covers the billing logic for messages sent by an agent (that is,
A2P or MT messages).

### Rich Messages (A2P)

A message is classified as a Rich Message if it **only** contains a combination
of the following elements:

- Text
- [Suggested replies](https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send#replies)
- Suggested actions of the following types only:
  - [Dial a number](https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send#dial)
  - [Open URL](https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send#url) in the standard browser, not a webview

![Rich Message (A2P)](https://developers.google.com/static/business-communications/rcs-business-messaging/carriers/images/rich_message_a2p.png "Event classified as a Rich Message (A2P)")

#### Billing logic for Rich Messages

A Rich Message is billed based on segments.

- **Segment size**: 1 segment = 160 bytes of UTF-8 encoded text.
- **Calculation**: The total UTF-8 byte length of the message's text is divided by 160 and always rounded up to the nearest whole number.
- **Exclusions** : The text and postback data within suggested replies or actions are **not** included in the segment count.
- **Example**: A 300-byte text message has 2 segments (300 / 160 = 1.875, rounded up to 2).

#### Byte count

Some unicode characters (like emojis or accented letters) are multi-byte, so the
total UTF-byte count may differ from the character count.

To check the exact byte count of a message, type or paste it below.
<iframe src="https://developers.devsite.google/frame/business-communications/rcs-business-messaging/carriers/billing/us-billing-model_8d897ee1ec36d1f82898e359c868c7caa394595c21c9d6df97522e7c63d6db86.frame" class="framebox inherit-locale " allow="clipboard-write https://developers.devsite.google" allowfullscreen is-upgraded></iframe>

### Rich Media Messages (A2P)

A message is classified as a Rich Media Message if it contains **at least one**
of the following:

- A [rich card](https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send#rich-cards) or a [carousel](https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send#carousels) (even without media)
- A [media file attachment](https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send#media) (image, video, audio)
- A suggested action other than Dial a number or Open URL with browser, including:
  - [View location](https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send#view-location)
  - [Share location](https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send#share-location)
  - [Create calendar event](https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send#calendar)
  - [Open URL in a webview](https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send#webview)

![Rich Media Message (A2P)](https://developers.google.com/static/business-communications/rcs-business-messaging/carriers/images/rich_media_message_a2p.png "Event classified as a Rich Media Message (A2P)")

#### Billing logic for Rich Media Messages

A Rich Media Message is billed as a single, flat-rate event.

- The billing is the same regardless of the text length, number of cards, or size of the media file.
- Segmentation does not apply.

### A2P API response examples

These examples show the [`richMessageClassification`](https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/phones.agentMessages#richmessageclassification)
field in a successful RBM API call response for messages sent by the agent.

#### Example API response for a `RICH_MESSAGE`

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

#### Example API response for a `RICH_MEDIA_MESSAGE`

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

## Person-to-Agent (P2A/MO) event billing

This section covers billing for messages and actions initiated by a user (that
is, P2A or MO messages).

### Rich Messages (P2A)

A user message is classified as a Rich Message if it contains only text. This
includes both free-form text and the text that results from tapping a
[suggested reply](https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send#replies).
(Suggested replies may include a postback data identifier in the message
payload.)

![Rich Message (P2A)](https://developers.google.com/static/business-communications/rcs-business-messaging/carriers/images/rich_message_p2a.png "Event classified as a Rich Message (P2A)")

**Billing logic** : Billed based on segments. For details on segment count
calculations, see [Billing logic for Rich Messages](https://developers.google.com/business-communications/rcs-business-messaging/carriers/billing/us-billing-model#billing-rich-messages).

### Rich Media Messages (P2A)

A message is classified as a Rich Media Message if it contains an uploaded
file (image, video, audio).

![Rich Media Message (P2A)](https://developers.google.com/static/business-communications/rcs-business-messaging/carriers/images/rich_media_message_p2a.png "Event classified as a Rich Media Message (P2A)")

**Billing logic**: Billed as a single, flat-rate event. Segmentation does not
apply.

### Suggested Action Clicks

A user tap on any [suggested action](https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send#actions)
generates one billable event called a Suggested Action Click.
(Suggested actions may include a postback data identifier in the message
payload.)

**Billing logic**: Generates one billable event per click.

> [!NOTE]
> **Note:** A user's tap on a [suggested reply](https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send#replies) (which sends text) does not generate a Suggested Action Click. Instead, the resulting message is billable as a [Rich Message](https://developers.google.com/business-communications/rcs-business-messaging/carriers/billing/us-billing-model#us-rich-message).

### Special case: Share location

Location sharing is unique in that it generates two separate P2A billable
events:

- **The suggested action click** : The user's tap on the [Share location suggested action](https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send#share-location)
  generates one [Suggested Action Click](https://developers.google.com/business-communications/rcs-business-messaging/carriers/billing/us-billing-model#us-suggested-action-clicks) event.

- **The location message** : After the user selects a location from the map
  interface, a message with location coordinates is sent to the agent. This MO
  message generates a [Rich Message](https://developers.google.com/business-communications/rcs-business-messaging/carriers/billing/us-billing-model#us-rich-message) event with a segment count
  of one.

![Suggested Action Click - Share location](https://developers.google.com/static/business-communications/rcs-business-messaging/carriers/images/suggested_action_click.png "Share location: Event classified as a Suggested Action Click")

### P2A webhook response examples

These examples show the [`richMessageClassification`](https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/phones.agentMessages#richmessageclassification)
field in webhooks sent to the agent for user-initiated events.

#### Example webhook for a user-sent `RICH_MESSAGE`

    {
      "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
      }
    }

#### Example webhook for a user-sent `RICH_MEDIA_MESSAGE`

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

#### Example webhook for a `SUGGESTED_ACTION_CLICK`

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

#### Example webhook for a location message

This is the second billable event in the
[Share location flow](https://developers.google.com/business-communications/rcs-business-messaging/carriers/billing/us-billing-model#us-share-location), sent after the user shares their
location from the map.

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

## Session billing (Pilot)

While the existing US billing model charges for individual messages, the Session
billing pilot introduces a way to group entire user-to-brand and/or
brand-to-user conversations into a single billable event: either `p2a_session`
or `a2p_session`.

A **session** billable event is recorded and billable when specific interaction
thresholds are reached within a continuous 24-hour window. For more information,
see [What is a session and how it works](https://developers.google.com/business-communications/rcs-business-messaging/carriers/billing/us-billing-faq#session-billing).

![Session](https://developers.google.com/static/business-communications/rcs-business-messaging/carriers/images/session.png "Event classified as a Session")

## Technical and implementation notes

- **Segments are for billing purposes only**: Long messages are delivered as a single unit to the user's device. The segment count is a virtual calculation for billing purposes; it doesn't affect how messages are delivered or presented to the user.
- **Automatic classification**: The message classification is fully automatic based on message content and can't be manually overridden.
- **Rollout**: The US billing model was enabled across the RCS for Business platform on July 15, 2025. From this date onwards, Google's reporting and API responses reflect the new classifications.