Модель выставления счетов в США

В этом документе описывается модель биллинга для трафика RCS for Business у операторов связи США.

Обзор классификаций счетов в США

Каждое сообщение, отправленное на номер телефона в США или отправленное с него, автоматически классифицируется по одному из трех типов в зависимости от формата:

  • Расширенное сообщение (двунаправленное)
  • 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)

Сообщение классифицируется как расширенное, если оно содержит только комбинацию следующих элементов:

Логика выставления счетов за Rich Messages

Тарификация расширенного сообщения осуществляется на основе сегментов.

  • Размер сегмента : 1 сегмент = 160 байт текста в кодировке UTF-8.
  • Расчет : общая длина текста сообщения в байтах UTF-8 делится на 160 и всегда округляется до ближайшего целого числа.
  • Исключения : текст и данные обратной связи в предлагаемых ответах или действиях не включаются в количество сегментов.
  • Пример : текстовое сообщение размером 300 байт состоит из 2 сегментов (300 / 160 = 1,875, округлено до 2).

Количество байтов

Некоторые символы Unicode (например, эмодзи или буквы с диакритическими знаками) являются многобайтовыми, поэтому общее количество байт UTF может отличаться от количества символов.

Чтобы проверить точное количество байтов в сообщении, введите или вставьте его ниже.

Мультимедийные сообщения (A2P)

Сообщение классифицируется как мультимедийное, если оно содержит хотя бы один из следующих элементов:

Логика выставления счетов за мультимедийные сообщения

Сообщение 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 отражают новые классификации.