Model penagihan AS

Dokumen ini menguraikan model penagihan untuk traffic RCS for Business di operator Amerika Serikat.

Ringkasan klasifikasi penagihan Amerika Serikat

Setiap pesan ke atau dari nomor telepon Amerika Serikat otomatis diklasifikasikan ke dalam salah satu dari tiga jenis berdasarkan formatnya:

  • Rich Message (dua arah)
  • Pesan Multimedia (dua arah)
  • Klik Tindakan yang Disarankan (dimulai pengguna)

Lihat bagian berikut untuk mengetahui spesifikasi mendetail.

Catatan tentang terminologi

Untuk mendeskripsikan arah lalu lintas pesan, operator AS biasanya menggunakan terminologi MT/MO. Istilah ini sesuai dengan terminologi A2P/P2A yang digunakan di seluruh dokumentasi RCS untuk Bisnis:

  • 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 dimulai oleh pengguna.

Penagihan acara Agent-to-Person (A2P/MT)

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

Rich Message (A2P)

Pesan diklasifikasikan sebagai Pesan Multimedia jika hanya berisi kombinasi elemen berikut:

Logika penagihan untuk Pesan Multimedia

Pesan Multimedia ditagih berdasarkan segmen.

  • Ukuran segmen: 1 segmen = 160 byte teks berenkode UTF-8.
  • Penghitungan: Panjang total byte UTF-8 dari teks pesan dibagi dengan 160 dan selalu dibulatkan ke atas ke bilangan bulat terdekat.
  • Pengecualian: Data teks dan postback dalam saran balasan atau tindakan tidak disertakan dalam jumlah segmen.
  • Contoh: Pesan teks 300 byte memiliki 2 segmen (300 / 160 = 1,875, dibulatkan menjadi 2).

Jumlah byte

Beberapa karakter Unicode (seperti emoji atau huruf beraksen) adalah multi-byte, sehingga jumlah total byte UTF mungkin berbeda dengan jumlah karakter.

Untuk memeriksa jumlah byte yang tepat dari sebuah pesan, ketik atau tempelkan di bawah.

Pesan Multimedia (A2P)

Pesan diklasifikasikan sebagai Pesan Media Rich jika berisi setidaknya satu hal berikut:

Logika penagihan untuk Pesan Multimedia

Pesan Multimedia ditagih sebagai satu peristiwa tarif tetap.

  • Penagihan akan sama, terlepas dari panjang teks, jumlah kartu, atau ukuran file media.
  • Segmentasi tidak berlaku.

Contoh respons A2P API

Contoh ini menunjukkan kolom richMessageClassification dalam respons panggilan RBM API 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 peristiwa Person-to-Agent (P2A/MO)

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

Rich Message (P2A)

Pesan pengguna diklasifikasikan sebagai Pesan Multimedia jika hanya berisi teks. Hal ini mencakup teks berformat bebas dan teks yang dihasilkan dari mengetuk balasan yang disarankan. (Balasan yang disarankan dapat menyertakan ID data postback dalam payload pesan.)

Logika penagihan: Ditagih berdasarkan segmen. Untuk mengetahui detail perhitungan jumlah segmen, lihat Logika penagihan untuk Pesan Multimedia.

Pesan Multimedia (P2A)

Pesan diklasifikasikan sebagai Pesan Multimedia jika berisi file yang diupload (gambar, video, audio).

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

Klik Tindakan yang Disarankan

Ketukan pengguna pada tindakan yang disarankan menghasilkan satu peristiwa yang dapat ditagih yang disebut Klik Tindakan yang Disarankan. (Tindakan yang disarankan dapat mencakup ID data postback dalam payload pesan.)

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

Kasus khusus: Berbagi lokasi

Berbagi lokasi unik karena menghasilkan dua peristiwa yang dapat ditagih P2A terpisah:

Contoh respons webhook P2A

Contoh ini menunjukkan kolom richMessageClassification di webhook yang dikirim ke agen untuk peristiwa yang dimulai 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 lokasinya dari peta.

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

Catatan teknis dan penerapan

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