Model rozliczeniowy w Stanach Zjednoczonych

W tym dokumencie opisujemy model rozliczeń za ruch RCS dla firm w sieciach operatorów w Stanach Zjednoczonych.

Omówienie klasyfikacji rozliczeń w Stanach Zjednoczonych

Każda wiadomość wysłana na numer telefonu w Stanach Zjednoczonych lub z niego jest automatycznie klasyfikowana jako jeden z 3 typów na podstawie formatu:

  • Wiadomość multimedialna (dwukierunkowa)
  • Wiadomość w formacie rich media (dwukierunkowa)
  • Kliknięcie sugerowanego działania (zainicjowane przez użytkownika)

Szczegółowe specyfikacje znajdziesz w sekcjach poniżej.

Uwaga dotycząca terminologii

Aby opisać kierunek ruchu wiadomości, amerykańscy operatorzy zwykle używają terminologii MT/MO. Te terminy odpowiadają terminologii A2P/P2A używanej w dokumentacji RCS dla firm:

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

Płatności za zdarzenia typu Agent-to-Person (A2P/MT)

W tej sekcji opisujemy logikę rozliczeń wiadomości wysyłanych przez agenta (czyli wiadomości A2P lub MT).

Wiadomości multimedialne (A2P)

Wiadomość jest klasyfikowana jako Rich Message, jeśli zawiera tylko kombinację tych elementów:

Logika rozliczeń w przypadku wiadomości z elementami multimedialnymi

Opłata za wiadomość z elementami multimedialnymi jest naliczana na podstawie segmentów.

  • Rozmiar segmentu: 1 segment = 160 bajtów tekstu zakodowanego w 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 postback w sugerowanych odpowiedziach lub działaniach nie są uwzględniane w liczbie segmentów.
  • Przykład: SMS o długości 300 bajtów ma 2 segmenty (300 / 160 = 1,875, zaokrąglone w górę do 2).

Liczba bajtów

Niektóre znaki Unicode (np. emotikony lub litery z akcentami) są wielobajtowe, więc łączna liczba bajtów UTF może się różnić 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ść z multimediami, jeśli zawiera co najmniej jeden z tych elementów:

Logika rozliczeń w przypadku wiadomości multimedialnych

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

  • Opłaty są takie same niezależnie od długości tekstu, liczby kart czy rozmiaru pliku multimedialnego.
  • Podział na segmenty nie ma zastosowania.

Przykłady odpowiedzi interfejsu API A2P

Te przykłady pokazują pole richMessageClassification w odpowiedzi na prawidłowe wywołanie interfejsu RBM API w przypadku wiadomości wysłanych przez agenta.

Przykładowa odpowiedź interfejsu API dla RICH_MESSAGE

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

Przykładowa odpowiedź interfejsu API dla RICH_MEDIA_MESSAGE

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

Rozliczenia za zdarzenia typu Person-to-Agent (P2A/MO)

Ta sekcja dotyczy płatności za wiadomości i działania zainicjowane przez użytkownika (czyli wiadomości P2A lub MO).

Wiadomości multimedialne (P2A)

Wiadomość użytkownika jest klasyfikowana jako wiadomość z elementami multimedialnymi, jeśli zawiera tylko tekst. Obejmuje to zarówno tekst wpisany w polu tekstowym, jak i tekst, który pojawi się po kliknięciu sugerowanej odpowiedzi. (Sugerowane odpowiedzi mogą zawierać w ładunku wiadomości identyfikator danych zwrotnych).

Logika rozliczeń: rozliczenia na podstawie segmentów. Szczegółowe informacje o obliczaniu liczby segmentów znajdziesz w artykule Logika rozliczeń w przypadku wiadomości z elementami multimedialnymi.

Wiadomości multimedialne (P2A)

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

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

Kliknięcia sugerowanych działań

Kliknięcie przez użytkownika dowolnego sugerowanego działania generuje jedno zdarzenie podlegające rozliczeniu o nazwie „Kliknięcie sugerowanego działania”. (Sugerowane działania mogą obejmować identyfikator danych wywołania zwrotnego w ładunku wiadomości).

Logika rozliczeń: generuje 1 zdarzenie podlegające rozliczeniu na kliknięcie.

Przypadek szczególny: udostępnianie lokalizacji

Lokalizacja udostępniania jest wyjątkowa, ponieważ generuje 2 osobne zdarzenia podlegające opłacie P2A:

Przykłady odpowiedzi webhooka P2A

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

Przykładowy webhook dla wiadomości RICH_MESSAGE wysł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 wysł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 przepływie udostępniania lokalizacji, wysyłane po udostępnieniu przez użytkownika lokalizacji z mapy.

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

Uwagi techniczne i związane z implementacją

  • Segmenty służą tylko do celów rozliczeniowych: długie wiadomości są dostarczane na urządzenie użytkownika jako jedna jednostka. Liczba segmentów jest wirtualnym obliczeniem na potrzeby rozliczeń. Nie ma wpływu na sposób dostarczania ani wyświetlania wiadomości użytkownikowi.
  • Klasyfikacja automatyczna: klasyfikacja wiadomości jest w pełni automatyczna i oparta na treści wiadomości. Nie można jej zastąpić ręcznie.
  • Wdrożenie: model rozliczeń w Stanach Zjednoczonych został włączony na platformie RCS Business Messaging 15 lipca 2025 r. Od tego dnia raporty i odpowiedzi interfejsu API Google będą odzwierciedlać nowe klasyfikacje.