На этой странице описаны файлы данных, которые RCS for Business создает, чтобы помочь операторам связи из США выполнять требования к выставлению счетов и аудиту в соответствии с американскими правилами RBM. Чтобы узнать больше о структуре RBM в США, посетите сайт usrbm.org.
Отчет об оплате – это агрегированный отчет о платных событиях, произошедших между запущенными агентами и пользователями. Оплачиваемое событие – это событие, за которое может быть списана плата. Операторы связи определяют, взимается ли плата за события, и если да, то каким образом. Все операторы связи США, которые активно используют RCS for Business, имеют доступ к отчетам об оплате.
Подробную информацию о модели классификации счетов в США можно найти в часто задаваемых вопросах об оплате в США.
Создание файлов
Подробнее о создании файлов…
Хранение файлов и доступ к ним
Подробнее о хранении файлов и доступе к ним…
Доступность файла
Подробнее о доступности файлов…
Отчеты об оплате
Отчеты об оплате – это записи платных событий, которые рассчитываются на основе категории платежей агента и типа отправляемых им сообщений. Отчеты об оплате доступны всем операторам, которые активно используют RCS для бизнеса.
Отчеты об оплате содержат конфиденциальную информацию, но не включают информацию, позволяющую идентифицировать личность, например MSISDN, хешированный MSISDN или уникальный идентификатор пользователя.
Платежные категории и оплачиваемые события
Чтобы понять, как рассчитывается стоимость агента, важно различать категории оплаты агента и платные события.
- Категория оплаты – это фиксированная классификация, которую вы выбираете при создании агента. Он определяет метод, по которому будет взиматься плата за использование агента: за сообщение (для агентов, не предназначенных для ведения диалогов) или за сеанс (для агентов, предназначенных для ведения диалогов).
- Оплачиваемые события – это взаимодействия между агентом RCS for Business и пользователем, которые отслеживаются для целей оплаты (например,
rich_message).
Платежные категории агентов в США
При создании агента владелец задает его категорию оплаты в зависимости от того, как агент будет взаимодействовать с пользователями. Платежная категория не ограничивает количество или тип сообщений, которые может отправлять агент. но определяет, как будет взиматься плата за сообщения агента. Две основные категории платежей описаны в таблице ниже.
| Платежная категория | Тип агента | Примеры использования | Способ оплаты |
|---|---|---|---|
| Не относящиеся к общению | Агенты, которые в основном отправляют односторонние сообщения. |
|
Плата взимается за каждое письмо, доставленное пользователю. |
| Разговорный | Агенты, предназначенные для обмена сообщениями с пользователями независимо от того, кто начал разговор. |
|
Оплата за сеанс. Если соблюдены критерии сеанса, все сообщения с расширенными возможностями и мультимедиа в течение 24 часов оплачиваются по единой ставке независимо от длины и сегментов. Оплата за сообщение. Если критерии сеанса не соблюдены или сообщение отправлено за пределами 24-часового окна сеанса, оно оплачивается отдельно по ставке за сообщение с расширенными возможностями или мультимедиа в соответствии с тарифной сеткой оператора. |
Разговорные и неразговорные агенты
Существует две категории оплаты агентов: относящиеся к разговору и не относящиеся к разговору.
Недиалоговые агенты оплачиваются за каждое сообщение, которое они отправляют пользователю.
- Эта категория лучше всего подходит для агентов, которые не ожидают частых ответов.
Разговорные агенты оплачиваются по единой ставке за сеанс. Сеанс начинается, когда пользователь отправляет сообщение, и включает все сообщения, которыми обмениваются в течение 24 часов, в том числе сообщение, которое запустило сеанс. За сообщения, которые не относятся к 24-часовому сеансу, с разговорных агентов может взиматься плата.
- Эта категория подходит для агентов, которые ведут с пользователями многоходовые диалоги.
Логика оплаты сеансов
В соответствии с моделью оплаты в США сеанс начинается с последовательности четырех сообщений с расширенными возможностями или мультимедийных сообщений (включая не менее двух сообщений, отправленных с мобильного устройства, и не менее одного сообщения, отправленного на мобильное устройство), которыми обмениваются в течение 24 часов с момента отправки первого сообщения в последовательности. После достижения этого порога все сообщения в течение 24 часов будут считаться одним сеансом. За все сообщения, которые не входят в сеанс или не запускают его, взимается плата по стандартному тарифу за сообщение для мультимедийных сообщений в соответствии с тарифным планом оператора.
На диаграмме ниже показан пример сеанса оплаты трафика приложений для бизнеса для разговорных агентов.
- MT (Mobile Terminated) – это сообщение, отправленное компанией.
- MO (Mobile Originated) – это сообщение или действие, инициированное пользователем.
Оплачиваемые события
Потоки сообщений классифицируются по источнику и направлению. Чтобы описать направление трафика сообщений, операторы связи в США обычно используют терминологию MT/MO. Эти термины соответствуют терминологии A2P/P2A, используемой в документации по RCS для бизнеса. Вот как соотносятся эти термины:
- A2P (Application-to-Person) – это MT (Mobile Terminated) – сообщение, отправленное компанией.
- P2A (от человека к приложению) – это исходящее сообщение (Mobile Originated, MO). Сообщение или действие, инициированное пользователем.
| Событие | Описание | Неразговорные агенты | Разговорные агенты |
|---|---|---|---|
a2p_rich_message |
Сообщение, отправленное агентом, которое содержит только текст, предложенные ответы или определенные предложенные действия (например, "Позвонить" или "Открыть URL в браузере"). | Всегда считается отдельным оплачиваемым событием. Оплата взимается за сообщение на основе сегментов (1 сегмент = 160 байт в кодировке UTF-8). |
Считается отдельным оплачиваемым событием, если не входит в сеанс. |
p2a_rich_message |
Сообщение, отправленное пользователем и содержащее только текст, введенный вручную или выбранный из готовых ответов. | Всегда считается отдельным оплачиваемым событием. Оплата за сообщение на основе сегментов. |
Считается отдельным оплачиваемым событием, если не входит в сеанс. |
a2p_rich_media_message |
Сообщение от агента, содержащее медиафайлы (изображения, видео, аудио), полезные подсказки, карусели или сложные действия, например "Посмотреть местоположение". | Всегда считается отдельным оплачиваемым событием. Оплата взимается за одно событие по фиксированной ставке независимо от размера и контента. |
Считается отдельным оплачиваемым событием, если не входит в сеанс. |
p2a_rich_media_message |
Сообщение, отправленное пользователем и содержащее загруженный медиафайл (изображение, видео или аудио). | Всегда считается отдельным оплачиваемым событием. Оплачивается как одно событие с фиксированной ставкой. |
Считается отдельным оплачиваемым событием, если не входит в сеанс. |
p2a_suggested_action |
Пользователь нажимает на любое предложенное действие (например, "Посмотреть местоположение"), которое не является готовым ответом. | Всегда считается отдельным оплачиваемым событием. Каждый клик создает одно оплачиваемое событие. |
Считается отдельным оплачиваемым событием и генерирует одно оплачиваемое событие на клик, если только не становится частью сеанса. |
a2p_session |
24-часовое окно взаимодействия, которое начинается, когда запускается триггер сеанса и первое сообщение отправляется с помощью машинного перевода. Подробнее о том, что такое сеанс и как он работает… | — Сеансы не применяются к чат-ботам. | После этого все сообщения, отправленные в течение 24 часов, будут оплачиваться в рамках одного сеанса. Любое событие, за которое взимается плата, в течение 24-часового сеанса будет связано с идентификатором платного события сеанса. |
p2a_session |
24-часовое окно взаимодействия, которое начинается, когда инициируется триггер сеанса и отправляется первое сообщение, идущее от оператора. Подробнее о сеансах и их работе… | — Сеансы не применяются к чат-ботам. | После этого все сообщения, отправленные в течение 24 часов, будут оплачиваться в рамках одного сеанса. Любое событие, за которое взимается плата, в течение 24-часового сеанса будет связано с идентификатором платного события сеанса. |
Создание отчетов об оплате
События, за которые взимается плата, создаются только агентами с трафиком, не относящимся к тестированию. Действия, совершенные с тестовых номеров телефонов, не показываются в платежных отчетах.
В этих отчетах предполагается, что события оплачиваются при доставке сообщений A2P, а не при их отправке. Недоставленное письмо или письмо, отправка которого была отменена до доставки, не считается событием, за которое взимается плата.
Формат отчета об оплате
Отчеты об оплате используют формат названия файла rbm_billable_events_YYYY-MM-DD.csv.
Дата в названии файла – это дата его создания.
Каждая строка в отчете – это запись, представляющая одно оплачиваемое событие.
Сеансы A2P/P2A представлены несколькими строками – по одной на каждое сообщение. В каждой строке, связанной с сеансом (имеющей одинаковое значение billing_event_id), в столбцах mt_messages и mo_messages будет указано общее количество сообщений MT и MO за весь 24-часовой период сеанса.
Файлы имеют кодировку UTF-8 без метки порядка байтов и используют символы перевода строки для обозначения конца строки. Первая строка каждого файла – это строка заголовка с названиями полей.
Каждая запись в отчете содержит следующую информацию о каждом оплачиваемом событии:
| Поле | Формат | Описание | Пример |
|---|---|---|---|
billing_event_id |
string | Сгенерированный идентификатор, который позволяет различать оплачиваемые события. У всех сообщений, относящихся к одному сеансу, будет одинаковый идентификатор |
63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type |
string | Тип события:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action |
p2a_rich_message |
agent_id |
string | Уникальный идентификатор агента, который участвовал в событии. | acme_342h23_agent@rbm.goog |
agent_owner |
string | Адрес электронной почты текущего владельца партнерского аккаунта, в котором был создан агент. | marketing@xyzaggregator.com |
billing_party |
string | Сторона, которая выставляет счета за события. | оператор |
max_duration_single_message |
число | Максимальное время (в часах), в течение которого пользователь может ответить на сообщение агента до закрытия окна начала разговора и классификации сообщения как события single_message. Неприменимо к модели США для отдельных расширенных сообщений. |
24 |
max_duration_a2p_conversation |
число | В рамках эксперимента с сеансами это окно длится 24 часа и отсчитывается с момента отправки первого сообщения в последовательности триггеров. Продолжительность указывается в часах. | 24 |
max_duration_p2a_conversation |
число | В рамках эксперимента с сеансами это окно длится 24 часа и отсчитывается с момента отправки первого сообщения в последовательности триггеров. | 24 |
start_time |
YYYY-mm-ddTHH:00:00Z | Дата и время начала события по UTC (ISO 8601). Для сеансов это временная метка первого сообщения в последовательности триггеров. A2P a2p_rich_message и a2p_rich_media_message, это время доставки сообщения пользователю.a2p_session это время, когда первое сообщение в чате было доставлено пользователю.P2A p2a_rich_message и p2a_rich_media_message, это время, когда пользователь отправил сообщение.p2a_session это время, когда пользователь отправил первое сообщение в чате. |
2025-05-20T08:00:00Z |
duration |
число | Продолжительность относится только к сеансам и измеряется в минутах. Если событие не относится к сеансу, значение равно 0. | 45 |
mt_messages |
число | Количество сообщений, отправленных на мобильные устройства (A2P), в событии. Для сеансов каждая строка с одинаковым значением billing_event_id показывает общее количество сообщений, переведенных машинным способом, за весь сеанс. |
5 |
mo_messages |
число | Количество сообщений, отправленных с мобильного устройства (P2A), в событии. Для сеансов в каждой строке с одинаковым значением billing_event_id показывается общее количество сообщений, отправленных с мобильного устройства, за весь сеанс. |
3 |
size_kilobytes |
число | Размер всех файлов, прикрепленных к письмам в событии, округленный до ближайшего килобайта (1 КБ равен 1024 байтам). | 912 |
agent_name |
string | Название агента, участвовавшего в событии. | ACME Brand |
owner_name |
string | Имя текущего владельца аккаунта партнера, в котором был создан агент. | XYZ Aggregator |
segment_count |
число | Рассчитанное количество сегментов для событий a2p_rich_message events и p2a_rich_message (1 сегмент равен 160 байтам в кодировке UTF-8). Если событие не относится к перечисленным, значение равно 0. |
5 |
session_type |
string | Тип сеанса:a2p_sessionp2a_session |
a2p_session |
Пример отчета об оплате
Пример отчета доступен для скачивания:
Типичный размер файла
Размер ежедневного отчета активного партнера RCS for Business зависит от того, насколько активно он использовал сеть оператора.