Model rozliczeniowy w Stanach Zjednoczonych

W dokumencie tym opisano model rozliczeń za ruch RCS for Business w sieciach operatorów amerykańskich.

Przegląd klasyfikacji rozliczeń w USA

Każda wiadomość wysyłana na numer telefonu w USA lub odbierana z niego jest automatycznie klasyfikowana do jednego z poniższych typów na podstawie formatu:

  • Bogata wiadomość (dwukierunkowa)
  • Komunikat multimedialny (dwukierunkowy)

W sesji można łączyć wiele typów wiadomości. Więcej informacji na temat sesji znajdziesz w artykule Rozliczanie sesji (pilot) .

Szczegółowe specyfikacje można znaleźć w poniższych sekcjach.

Uwaga dotycząca terminologii

Do opisu kierunku ruchu komunikatów, operatorzy amerykańscy zazwyczaj używają terminologii MT/MO. Terminy te odpowiadają terminologii A2P/P2A używanej w dokumentacji RCS for Business:

  • MT (Mobile Terminated) to protokół A2P (Application-to-Person) : wiadomość wysyłana przez firmę.
  • MO (Mobile Originated) to P2A (Person-to-Application) : wiadomość lub działanie inicjowane przez użytkownika.

Rozliczanie zdarzeń w modelu A2P/MT (Agent-to-Person)

W tej sekcji omówiono logikę rozliczeń dla wiadomości wysłanych przez agenta (czyli wiadomości A2P lub MT).

Bogate wiadomości (A2P)

Wiadomość jest klasyfikowana jako bogata wiadomość, jeżeli zawiera wyłącznie kombinację następujących elementów:

Logika rozliczeń dla bogatych wiadomości

Rozliczenie za wiadomość Rich Message odbywa się na podstawie segmentów.

  • Rozmiar segmentu : 1 segment = 160 bajtów tekstu zakodowanego w formacie UTF-8.
  • Obliczenia : Całkowita długość tekstu wiadomości w bajtach UTF-8 jest dzielona przez 160 i zawsze zaokrąglana w górę do najbliższej liczby całkowitej.
  • Wykluczenia : Tekst i dane zwrotne zawarte w sugerowanych odpowiedziach lub działaniach nie są wliczane do liczby segmentów.
  • Przykład : Wiadomość tekstowa o rozmiarze 300 bajtów składa się z 2 segmentów (300 / 160 = 1,875, zaokrąglone do 2).

Liczba bajtów

Niektóre znaki Unicode (np. emoji czy litery akcentowane) są wielobajtowe, więc całkowita liczba bajtów UTF może różnić się od liczby znaków.

Aby sprawdzić dokładną liczbę bajtów wiadomości, wpisz ją lub wklej poniżej.

Wiadomości multimedialne (A2P)

Wiadomość jest klasyfikowana jako wiadomość multimedialna, jeżeli zawiera co najmniej jeden z następujących elementów:

Logika rozliczeń dla wiadomości multimedialnych

Wiadomość multimedialna jest rozliczana jako pojedyncze zdarzenie o stałej stawce.

  • Rozliczenie jest takie samo bez względu na długość tekstu, liczbę kart i rozmiar pliku multimedialnego.
  • Segmentacja nie ma zastosowania.

Przykłady odpowiedzi API A2P

Poniższe przykłady pokazują pole richMessageClassification w pomyślnej odpowiedzi na wywołanie interfejsu API RBM dla wiadomości wysłanych przez agenta.

Przykładowa odpowiedź API dla komunikatu RICH_MESSAGE 

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

Przykładowa odpowiedź API dla komunikatu RICH_MEDIA_MESSAGE 

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

Rozliczanie zdarzeń typu „osoba do agenta” (P2A/MO)

W tej sekcji omówiono kwestie rozliczeń za wiadomości i działania inicjowane przez użytkownika (czyli wiadomości P2A lub MO).

Bogate wiadomości (P2A)

Wiadomość użytkownika jest klasyfikowana jako wiadomość bogatsza (Rich Message), jeśli zawiera wyłącznie tekst. Dotyczy to zarówno tekstu w dowolnej formie, jak i tekstu uzyskanego po kliknięciu sugerowanej odpowiedzi . (Sugerowane odpowiedzi mogą zawierać identyfikator danych postback w treści wiadomości).

Logika rozliczeń : Rozliczanie na podstawie segmentów. Szczegółowe informacje na temat obliczania liczby segmentów można znaleźć w sekcji „Logika rozliczeń dla wiadomości Rich Messages” .

Wiadomości multimedialne (P2A)

Wiadomość jest klasyfikowana jako wiadomość multimedialna, jeśli zawiera przesłany plik (obraz, wideo, dźwięk).

Logika rozliczeń : Rozliczane jako pojedyncze zdarzenie o stałej stawce. Segmentacja nie ma zastosowania.

Sugerowane kliknięcia akcji

Kliknięcie przez użytkownika dowolnej sugerowanej akcji generuje jedno zdarzenie podlegające rozliczeniu, zwane kliknięciem sugerowanej akcji. (Sugerowane akcje mogą zawierać identyfikator danych zwrotnych w treści wiadomości).

Logika rozliczeń : generuje jedno zdarzenie podlegające rozliczeniu za każde kliknięcie.

Przypadek szczególny: Udostępnij lokalizację

Lokalizacja udostępniania jest wyjątkowa, ponieważ generuje dwa oddzielne zdarzenia podlegające rozliczeniu P2A:

Przykłady odpowiedzi webhooka P2A

Poniższe przykłady pokazują pole richMessageClassification w webhookach wysyłanych do agenta w przypadku zdarzeń zainicjowanych przez użytkownika.

Przykładowy webhook dla RICH_MESSAGE wysyłanej przez użytkownika 

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

Przykładowy webhook dla wiadomości RICH_MEDIA_MESSAGE wysyłanej przez użytkownika 

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

Przykładowy webhook dla SUGGESTED_ACTION_CLICK 

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

Przykładowy webhook dla wiadomości o lokalizacji

Jest to drugie zdarzenie podlegające rozliczeniu w ramach przepływu udostępniania lokalizacji , wysyłane po udostępnieniu przez użytkownika swojej lokalizacji z mapy.

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

Rozliczanie sesji (pilot)

Podczas gdy obowiązujący w USA model rozliczeń obejmuje opłaty za pojedyncze wiadomości, pilotażowy model rozliczeń za sesje wprowadza sposób grupowania całych konwersacji użytkownik-marka i/lub marka-użytkownik w jedno zdarzenie podlegające rozliczeniu: p2a_session lub a2p_session .

Zdarzenie podlegające rozliczeniu za sesję jest rejestrowane i rozliczane po osiągnięciu określonych progów interakcji w ciągu 24 godzin. Więcej informacji znajdziesz w artykule Czym jest sesja i jak działa .

Notatki techniczne i wdrożeniowe

  • Segmenty służą wyłącznie do celów rozliczeniowych : długie wiadomości są dostarczane do urządzenia użytkownika jako pojedyncza jednostka. Liczba segmentów jest wirtualnym obliczeniem na potrzeby rozliczeń i nie wpływa na sposób dostarczania ani prezentowania wiadomości użytkownikowi.
  • Klasyfikacja automatyczna : Klasyfikacja wiadomości odbywa się całkowicie automatycznie na podstawie ich zawartości i nie można jej zmienić ręcznie.
  • Wdrożenie : Model rozliczeń w USA został włączony na platformie RCS for Business 15 lipca 2025 r. Od tej daty raportowanie Google i odpowiedzi interfejsu API odzwierciedlają nowe klasyfikacje.