Halaman ini diterjemahkan oleh Cloud Translation API.

Model penagihan AS

Dokumen ini menguraikan model penagihan untuk lalu lintas RCS untuk bisnis pada operator AS.

Untuk informasi mengenai model penagihan standar (untuk lalu lintas non-AS), lihat FAQ Penagihan .
Untuk informasi mengenai pelaporan, lihat panduan Laporan penagihan dan log aktivitas .

Gambaran umum klasifikasi penagihan di AS

Setiap pesan yang dikirim ke atau dari nomor telepon AS secara otomatis diklasifikasikan ke dalam salah satu jenis berikut berdasarkan formatnya:

Pesan Kaya (dua arah)
Pesan Media Kaya (dua arah)

Beberapa jenis pesan dapat digabungkan menjadi satu sesi . Untuk informasi lebih lanjut tentang sesi, lihat Penagihan sesi (Pilot) .

Untuk spesifikasi detail, lihat bagian-bagian berikut.

Catatan tentang terminologi

Untuk menjelaskan arah lalu lintas pesan, operator AS biasanya menggunakan terminologi MT/MO. Istilah-istilah ini sesuai dengan terminologi A2P/P2A yang digunakan di seluruh dokumentasi RCS for Business:

MT (Mobile Terminated) adalah A2P (Application-to-Person) : Pesan yang dikirim oleh bisnis.
MO (Mobile Originated) adalah P2A (Person-to-Application) : Pesan atau tindakan yang diprakarsai oleh pengguna.

Penagihan acara Agen-ke-Orang (A2P/MT)

Bagian ini membahas logika penagihan untuk pesan yang dikirim oleh agen (yaitu, pesan A2P atau MT).

Pesan Kaya (A2P)

Suatu pesan diklasifikasikan sebagai Pesan Kaya (Rich Message) jika hanya berisi kombinasi elemen-elemen berikut:

Teks
Jawaban yang disarankan
Tindakan yang disarankan hanya untuk jenis berikut:
- Hubungi nomor
- Buka URL di browser standar, bukan di webview.

Logika penagihan untuk Pesan Kaya

Rich Message ditagih berdasarkan segmen.

Ukuran segmen : 1 segmen = 160 byte teks yang dikodekan UTF-8.
Perhitungan : Panjang total byte UTF-8 dari teks pesan dibagi dengan 160 dan selalu dibulatkan ke bilangan bulat terdekat.
Pengecualian : Teks dan data postback dalam balasan atau tindakan yang disarankan tidak termasuk dalam penghitungan segmen.
Contoh : Sebuah pesan teks berukuran 300 byte memiliki 2 segmen (300 / 160 = 1,875, dibulatkan menjadi 2).

Jumlah byte

Beberapa karakter Unicode (seperti emoji atau huruf beraksen) terdiri dari beberapa byte, sehingga jumlah total byte UTF mungkin berbeda dari jumlah karakter.

Untuk memeriksa jumlah byte pasti dari sebuah pesan, ketik atau tempelkan di bawah ini.

Pesan Media Kaya (A2P)

Suatu pesan diklasifikasikan sebagai Pesan Media Kaya (Rich Media Message) jika pesan tersebut memuat setidaknya salah satu dari hal-hal berikut:

Kartu kaya atau carousel (bahkan tanpa media)
Lampiran file media (gambar, video, audio)
Tindakan yang disarankan selain Menghubungi nomor atau Membuka URL dengan peramban, termasuk:

Logika penagihan untuk Pesan Media Kaya

Pesan Rich Media ditagih sebagai satu acara dengan tarif tetap.

Biaya penagihan tetap sama terlepas dari panjang teks, jumlah kartu, atau ukuran file media.
Segmentasi tidak berlaku.

Contoh respons API A2P

Contoh-contoh ini menunjukkan bidang richMessageClassification dalam respons panggilan API RBM yang berhasil untuk pesan yang dikirim oleh agen.

Contoh respons API untuk `RICH_MESSAGE`

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

Contoh respons API untuk `RICH_MEDIA_MESSAGE`

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

Penagihan acara Person-to-Agent (P2A/MO)

Bagian ini mencakup penagihan untuk pesan dan tindakan yang diprakarsai oleh pengguna (yaitu, pesan P2A atau MO).

Pesan Kaya (P2A)

Pesan pengguna diklasifikasikan sebagai Pesan Kaya jika hanya berisi teks. Ini termasuk teks bebas dan teks yang dihasilkan dari mengetuk balasan yang disarankan . (Balasan yang disarankan dapat menyertakan pengidentifikasi data postback dalam muatan pesan.)

Logika penagihan : Ditagih berdasarkan segmen. Untuk detail tentang perhitungan jumlah segmen, lihat Logika penagihan untuk Pesan Kaya .

Pesan Media Kaya (P2A)

Sebuah pesan diklasifikasikan sebagai Pesan Media Kaya jika berisi file yang diunggah (gambar, video, audio).

Logika penagihan : Ditagih sebagai satu transaksi dengan tarif tetap. Segmentasi tidak berlaku.

Klik Tindakan yang Disarankan

Ketukan pengguna pada tindakan yang disarankan akan menghasilkan satu peristiwa yang dapat ditagih yang disebut Klik Tindakan yang Disarankan. (Tindakan yang disarankan dapat menyertakan pengidentifikasi data postback dalam muatan pesan.)

Logika penagihan : Menghasilkan satu peristiwa yang dapat ditagih per klik.

Fitur berbagi lokasi ini unik karena menghasilkan dua peristiwa penagihan P2A yang terpisah:

Klik tindakan yang disarankan : Ketukan pengguna pada tindakan yang disarankan "Bagikan lokasi" menghasilkan satu peristiwa Klik Tindakan yang Disarankan .
Pesan lokasi: Setelah pengguna memilih lokasi dari antarmuka peta, pesan berisi koordinat lokasi dikirim ke agen. Pesan MO ini menghasilkan peristiwa Rich Message dengan jumlah segmen satu.

Contoh respons webhook P2A

Contoh-contoh ini menunjukkan bidang richMessageClassification dalam webhook yang dikirim ke agen untuk peristiwa yang diprakarsai pengguna.

Contoh webhook untuk `RICH_MESSAGE` yang dikirim pengguna

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

Contoh webhook untuk `RICH_MEDIA_MESSAGE` yang dikirim pengguna.

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

Contoh webhook untuk `SUGGESTED_ACTION_CLICK`

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

Contoh webhook untuk pesan lokasi

Ini adalah peristiwa yang dapat ditagih kedua dalam alur Berbagi lokasi , yang dikirim setelah pengguna membagikan lokasi mereka dari peta.

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

Penagihan sesi (Pilot)

Meskipun model penagihan AS yang ada saat ini mengenakan biaya untuk setiap pesan individual, uji coba penagihan Sesi memperkenalkan cara untuk mengelompokkan seluruh percakapan pengguna-ke-merek dan/atau merek-ke-pengguna ke dalam satu peristiwa yang dapat ditagih: baik p2a_session atau a2p_session .

Suatu sesi yang dapat ditagih dicatat dan ditagih ketika ambang batas interaksi tertentu tercapai dalam jangka waktu 24 jam terus menerus. Untuk informasi lebih lanjut, lihat Apa itu sesi dan bagaimana cara kerjanya .

Catatan teknis dan implementasi

Segmen hanya untuk keperluan penagihan : Pesan panjang dikirim sebagai satu unit ke perangkat pengguna. Jumlah segmen adalah perhitungan virtual untuk keperluan penagihan; hal ini tidak memengaruhi cara pesan dikirim atau ditampilkan kepada pengguna.
Klasifikasi otomatis : Klasifikasi pesan sepenuhnya otomatis berdasarkan isi pesan dan tidak dapat diubah secara manual.
Peluncuran : Model penagihan AS diaktifkan di seluruh platform RCS for Business pada 15 Juli 2025. Mulai tanggal ini, pelaporan dan respons API Google mencerminkan klasifikasi baru tersebut.