В этом документе описывается модель биллинга для трафика RCS for Business у операторов связи США.
- Информацию о стандартной модели биллинга (для трафика за пределами США) см. в разделе FAQ по биллингу .
- Информацию об отчетах см. в руководстве по отчетам о счетах и журналам активности .
Обзор классификаций счетов в США
Каждое сообщение, отправленное на номер телефона в США или отправленное с него, автоматически классифицируется по одному из трех типов в зависимости от формата:
- Расширенное сообщение (двунаправленное)
- Rich Media Message (двунаправленное)
- Щелкните предлагаемое действие (инициированное пользователем)
Подробные характеристики смотрите в следующих разделах.
Примечание по терминологии
Для описания направления трафика сообщений американские операторы связи обычно используют терминологию MT/MO. Эти термины соответствуют терминологии A2P/P2A, используемой в документации RCS for Business:
- MT (Mobile Terminated) — это A2P (Application-to-Person) : сообщение, отправленное компанией.
- MO (Mobile Originated) — это P2A (Person-to-Application) : сообщение или действие, инициированное пользователем.
Биллинг событий «от агента к человеку» (A2P/MT)
В этом разделе рассматривается логика выставления счетов за сообщения, отправленные агентом (то есть сообщения A2P или MT).
Расширенные сообщения (A2P)
Сообщение классифицируется как расширенное, если оно содержит только комбинацию следующих элементов:
- Текст
- Предлагаемые ответы
- Предлагаются только действия следующих типов:
- Набрать номер
- Откройте URL в стандартном браузере, а не в веб-браузере.
Логика выставления счетов за Rich Messages
Тарификация расширенного сообщения осуществляется на основе сегментов.
- Размер сегмента : 1 сегмент = 160 байт текста в кодировке UTF-8.
- Расчет : общая длина текста сообщения в байтах UTF-8 делится на 160 и всегда округляется до ближайшего целого числа.
- Исключения : текст и данные обратной связи в предлагаемых ответах или действиях не включаются в количество сегментов.
- Пример : текстовое сообщение размером 300 байт состоит из 2 сегментов (300 / 160 = 1,875, округлено до 2).
Количество байтов
Некоторые символы Unicode (например, эмодзи или буквы с диакритическими знаками) являются многобайтовыми, поэтому общее количество байт UTF может отличаться от количества символов.
Чтобы проверить точное количество байтов в сообщении, введите или вставьте его ниже.
Мультимедийные сообщения (A2P)
Сообщение классифицируется как мультимедийное, если оно содержит хотя бы один из следующих элементов:
- Расширенная карта или карусель (даже без медиа)
- Вложение медиа-файла (изображение, видео, аудио)
- Предлагаемое действие, отличное от «Набрать номер» или «Открыть URL в браузере», в том числе:
Логика выставления счетов за мультимедийные сообщения
Сообщение Rich Media тарифицируется как единое событие с фиксированной ставкой.
- Тарификация одинакова независимо от длины текста, количества карточек или размера медиафайла.
- Сегментация не применяется.
Примеры ответов API A2P
В этих примерах показано поле richMessageClassification в успешном ответе на вызов RBM API для сообщений, отправленных агентом.
Пример ответа API для RICH_MESSAGE
{
"name": "...",
"sendTime": "2025-05-22T20:03:35.474764Z",
"contentMessage": {
...
},
"richMessageClassification": {
"classificationType": "RICH_MESSAGE",
"segmentCount": 5
}
}
Пример ответа API для RICH_MEDIA_MESSAGE
{
"name": "...",
"sendTime": "2025-05-22T20:03:35.474764Z",
"contentMessage": {
...
},
"richMessageClassification": {
"classificationType": "RICH_MEDIA_MESSAGE"
}
}
Биллинг событий Person-to-Agent (P2A/MO)
В этом разделе рассматривается выставление счетов за сообщения и действия, инициированные пользователем (то есть сообщения P2A или MO).
Расширенные сообщения (P2A)
Пользовательское сообщение классифицируется как расширенное, если оно содержит только текст. Это включает как текст в свободной форме, так и текст, полученный при нажатии на предложенный ответ . (Предложенные ответы могут включать идентификатор данных обратной связи в полезной нагрузке сообщения.)
Логика выставления счетов : выставление счетов на основе сегментов. Подробнее о расчёте количества сегментов см. в разделе «Логика выставления счетов для расширенных сообщений» .
Мультимедийные сообщения (P2A)
Сообщение классифицируется как мультимедийное, если оно содержит загруженный файл (изображение, видео, аудио).
Логика выставления счетов : оплачивается как единое событие с фиксированной ставкой. Сегментация не применяется.
Предлагаемые действия: клики
Нажатие пользователем любого предлагаемого действия генерирует одно оплачиваемое событие, называемое «Клик по предложенному действию». (Предлагаемые действия могут включать идентификатор данных обратной передачи в полезной нагрузке сообщения.)
Логика выставления счетов : создает одно оплачиваемое событие за каждый клик.
Особый случай: поделиться местоположением
Функция совместного использования местоположения уникальна тем, что она генерирует два отдельных платных события P2A:
Щелчок по предложенному действию : нажатие пользователем кнопки «Поделиться местоположением» генерирует одно событие «Щелчок по предложенному действию» .
Сообщение о местоположении: после того, как пользователь выбирает местоположение на карте, агенту отправляется сообщение с координатами местоположения. Это сообщение MO генерирует событие Rich Message с количеством сегментов, равным одному.
Примеры ответов веб-перехватчиков P2A
В этих примерах показано поле richMessageClassification в веб-перехватчиках, отправляемых агенту для событий, инициированных пользователем.
Пример вебхука для отправленного пользователем 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
}
}
Пример вебхука для отправленного пользователем 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"
}
}
Пример вебхука для SUGGESTED_ACTION_CLICK
{
"agentId": "...",
"senderPhoneNumber": "...",
"messageId": "...",
"sendTime": "...",
"suggestionResponse": {
"text": "Click here",
"postbackData": "...",
"type": "ACTION"
},
"richMessageClassification": {
"classificationType": "SUGGESTED_ACTION_CLICK"
}
}
Пример веб-хука для сообщения о местоположении
Это второе оплачиваемое событие в потоке «Поделиться местоположением» , отправляемое после того, как пользователь поделился своим местоположением на карте.
{
"agentId": "...",
"senderPhoneNumber": "...",
"messageId": "...",
"sendTime": "...",
"location": {
"latitude": 37.422000,
"longitude": -122.084056
},
"richMessageClassification": {
"classificationType": "RICH_MESSAGE",
"segmentCount": 1
}
}
Технические и реализационные примечания
- Сегменты предназначены только для целей биллинга : длинные сообщения доставляются на устройство пользователя как единое целое. Количество сегментов — это виртуальный расчёт для целей биллинга; оно не влияет на способ доставки или отображения сообщений пользователю.
- Автоматическая классификация : классификация сообщений полностью автоматическая и основана на их содержании, и ее нельзя изменить вручную.
- Внедрение : модель выставления счетов в США была активирована на платформе RCS for Business 15 июля 2025 г. С этой даты отчеты Google и ответы API отражают новые классификации.