ABD faturalandırma modeli

Bu belgede, ABD'deki operatörlerdeki İşletmeler için RCS trafiğinin faturalandırma modeli açıklanmaktadır.

ABD faturalandırma sınıflandırmalarına genel bakış

ABD telefon numarasına gönderilen veya bu numaradan gelen her mesaj, biçimine göre otomatik olarak üç türden birine sınıflandırılır:

  • Zengin Mesaj (iki yönlü)
  • Rich Media Mesajı (iki yönlü)
  • Önerilen İşlem Tıklaması (kullanıcı tarafından başlatılan)

Ayrıntılı özellikler için aşağıdaki bölümlere bakın.

Terminoloji hakkında not

ABD'deki operatörler, mesajlaşma trafiğinin yönünü açıklamak için genellikle MT/MO terminolojisini kullanır. Bu terimler, İşletmeler İçin RCS belgelerinde kullanılan A2P/P2A terminolojisine karşılık gelir:

  • MT (Mobile Terminated), A2P (Application-to-Person): İşletme tarafından gönderilen mesaj.
  • MO (Mobile Originated) is P2A (Person-to-Application): Kullanıcı tarafından başlatılan bir ileti veya işlem.

Temsilciden kişiye (A2P/MT) etkinlik faturalandırması

Bu bölümde, bir temsilci tarafından gönderilen iletilerin (yani A2P veya MT iletileri) faturalandırma mantığı açıklanmaktadır.

Zengin Mesajlar (A2P)

Bir mesajın Rich Message olarak sınıflandırılması için yalnızca aşağıdaki öğelerin bir kombinasyonunu içermesi gerekir:

Zengin Mesajlar için faturalandırma mantığı

Zengin mesajlar, segmentlere göre faturalandırılır.

  • Segment boyutu: 1 segment = 160 bayt UTF-8 kodlu metin.
  • Hesaplama: Mesaj metninin toplam UTF-8 bayt uzunluğu 160'a bölünür ve her zaman en yakın tam sayıya yuvarlanır.
  • Hariç tutulanlar: Önerilen yanıtlardaki veya işlemlerdeki metin ve geri gönderme verileri, segment sayımına dahil edilmez.
  • Örnek: 300 baytlık bir kısa mesaj 2 segmentten oluşur (300 / 160 = 1,875, 2'ye yuvarlanır).

Bayt sayısı

Bazı Unicode karakterleri (ör. emoji'ler veya aksanlı harfler) çok baytlıdır. Bu nedenle, toplam UTF-8 bayt sayısı karakter sayısından farklı olabilir.

Bir mesajın tam bayt sayısını kontrol etmek için mesajı aşağıya yazın veya yapıştırın.

Rich Media Mesajları (A2P)

Bir mesajın zengin medya mesajı olarak sınıflandırılması için aşağıdakilerden en az birini içermesi gerekir:

Rich Media Mesajları için faturalandırma mantığı

Rich Media Mesajı, tek bir sabit ücretli etkinlik olarak faturalandırılır.

  • Metin uzunluğu, kart sayısı veya medya dosyasının boyutu ne olursa olsun faturalandırma aynıdır.
  • Segmentasyon geçerli değildir.

A2P API yanıtı örnekleri

Bu örneklerde, aracı tarafından gönderilen mesajlar için başarılı bir RBM API çağrısı yanıtındaki richMessageClassification alanı gösterilmektedir.

RICH_MESSAGE için örnek API yanıtı

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

RICH_MEDIA_MESSAGE için örnek API yanıtı

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

Kişiden temsilciye (P2A/MO) etkinlik faturalandırması

Bu bölümde, kullanıcı tarafından başlatılan mesajlar ve işlemlerin (yani P2A veya MO mesajları) faturalandırılması ele alınmaktadır.

Zengin Mesajlar (P2A)

Yalnızca metin içeren kullanıcı mesajları, zengin mesaj olarak sınıflandırılır. Bu kapsamda hem serbest biçimli metin hem de önerilen yanıta dokunarak elde edilen metin yer alır. (Önerilen yanıtlarda, mesaj yükünde geri gönderme verisi tanımlayıcısı bulunabilir.)

Faturalandırma mantığı: Segmentlere göre faturalandırılır. Segment sayısı hesaplamalarıyla ilgili ayrıntılar için Zengin Mesajlar için Faturalandırma Mantığı başlıklı makaleyi inceleyin.

Rich Media Mesajları (P2A)

Yüklenen bir dosya (resim, video, ses) içeren mesajlar, Rich Media Mesajı olarak sınıflandırılır.

Faturalandırma mantığı: Tek bir sabit ücretli etkinlik olarak faturalandırılır. Segmentasyon geçerli değildir.

Önerilen işlem tıklamaları

Kullanıcının herhangi bir önerilen eyleme dokunması, Önerilen Eylem Tıklaması adı verilen bir faturalandırılabilir etkinlik oluşturur. (Önerilen işlemler, ileti yükünde bir geri gönderme verileri tanımlayıcısı içerebilir.)

Faturalandırma mantığı: Tıklama başına bir faturalandırılabilir etkinlik oluşturur.

Özel durum: Konum paylaşma

Konum paylaşımı, iki ayrı P2A faturalandırılabilir etkinlik oluşturması açısından benzersizdir:

  • Önerilen eylem tıklaması: Kullanıcının Konum paylaşma önerilen eylemine dokunması bir önerilen eylem tıklaması etkinliği oluşturur.

  • Konum mesajı: Kullanıcı, harita arayüzünden bir konum seçtikten sonra temsilciye konum koordinatlarını içeren bir mesaj gönderilir. Bu MO mesajı, bir segment sayısına sahip bir Rich Message etkinliği oluşturur.

P2A webhook yanıtı örnekleri

Bu örneklerde, kullanıcı tarafından başlatılan etkinlikler için aracıya gönderilen webhook'lardaki richMessageClassification alanı gösterilmektedir.

Kullanıcı tarafından gönderilen RICH_MESSAGE için örnek webhook

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

Kullanıcı tarafından gönderilen RICH_MEDIA_MESSAGE için örnek webhook

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

SUGGESTED_ACTION_CLICK için örnek web kancası

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

Konum mesajı için örnek webhook

Bu, kullanıcının konumunu haritadan paylaştıktan sonra gönderilen konum paylaşma akışındaki ikinci faturalandırılabilir etkinliktir.

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

Teknik notlar ve uygulama notları

  • Segmentler yalnızca faturalandırma amaçlıdır: Uzun mesajlar, kullanıcının cihazına tek bir birim olarak teslim edilir. Segment sayısı, faturalandırma amacıyla yapılan sanal bir hesaplamadır. İletilerin kullanıcıya nasıl teslim edildiğini veya sunulduğunu etkilemez.
  • Otomatik sınıflandırma: İleti sınıflandırması, ileti içeriğine göre tamamen otomatik olarak yapılır ve manuel olarak geçersiz kılınamaz.
  • Kullanıma sunulma: ABD faturalandırma modeli, 15 Temmuz 2025'te RCS Business Messaging platformunda etkinleştirildi. Bu tarihten itibaren Google'ın raporları ve API yanıtları yeni sınıflandırmaları yansıtır.