REST Resource: phones.agentMessages

Kaynak: AgentMessage

Temsilciden kullanıcıya gönderilen mesaj.

JSON gösterimi 
{
  "name": string,
  "sendTime": string,
  "contentMessage": {
    object (AgentContentMessage)
  },
  "messageTrafficType": enum (MessageTrafficType),
  "richMessageClassification": {
    object (RichMessageClassification)
  },
  "totalPayloadSizeBytes": string,
  "carrier": string,

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
Alanlar
name

string

Bu alan, RCS for Business platformu tarafından ayarlanır. Aracı mesajı oluştururken bu bilgiyi eklemeyin. Alan, "phones/{E.164}/agentMessages/{messageId}" olarak çözümlenir. Burada {E.164}, kullanıcının E.164 biçimindeki telefon numarası, {messageId} ise temsilci mesajının temsilci tarafından atanan kimliğidir.
sendTime

string (Timestamp format)

Bu alan, RCS for Business platformu tarafından ayarlanır. Aracı mesajı oluştururken bu bilgiyi eklemeyin. Bu alan, iletinin kullanıcıya gönderildiği zamanı gösterir.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
contentMessage

object (AgentContentMessage)

Aracı mesajının içeriği.
messageTrafficType

enum (MessageTrafficType)

Mesaj trafiği türü.
richMessageClassification

object (RichMessageClassification)

Yalnızca çıkış. İletiyi ABD faturalandırma modeline göre sınıflandırır. Her sınıflandırma türüyle ilgili ayrıntılar için ABD faturalandırma modeli kılavuzuna bakın. Bu alan yalnızca ABD telefon numaraları için doldurulur.
totalPayloadSizeBytes

string (int64 format)

Yalnızca çıkış. İletinin toplam yük boyutu (bayt cinsinden). Yük, mesajın metni veya öneriler hariç olmak üzere, bir RCS for Business mesajındaki tüm ekleri (video, resim, PDF vb.) kapsar. Bu alan şu anda yalnızca ABD telefon numaraları için doldurulmaktadır.
carrier

string

Yalnızca çıkış. Google RCS arka uçlarına göre, kullanıcının telefon numarasının ait olduğu operatör bilgisi. Bu alan şu anda yalnızca ABD telefon numaraları için doldurulmaktadır.

expiration birleşik alanı.

expiration aşağıdakilerden yalnızca biri olabilir:
expireTime

string (Timestamp format)

İsteğe bağlı. Bu kaynağın geçerliliğinin sona erdiği zamanı gösteren UTC zaman damgası. Bu değer, ayarlanmışsa veya TTL alanı ayarlanmışsa çıkışta sağlanır.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
ttl

string (Duration format)

İsteğe bağlı. Yalnızca giriş. İletinin otomatik olarak iptal edilmeden önce ne kadar süre boyunca geçerli olacağı.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

AgentContentMessage

Temsilciden kullanıcıya gönderilen mesajın içeriği.

JSON gösterimi 
{
  "suggestions": [
    {
      object (Suggestion)
    }
  ],

  // Union field content can be only one of the following:
  "text": string,
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "richCard": {
    object (RichCard)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
Alanlar
suggestions[]

object (Suggestion)

İlgili temsilci mesajının ardından öneri çipleri listesi olarak gösterilen önerilen yanıtlar ve önerilen işlemler listesi. En fazla 11 öneri.

Çipler yalnızca ilişkili temsilci mesajı, görüşmedeki en son mesaj olduğunda (hem temsilci hem de kullanıcı mesajları dahil) gösterilir. Kullanıcı, metin yanıtını temsilciye geri göndermek için önerilen yanıtlardan birine dokunabilir veya cihazda yerel bir işlem başlatmak için önerilen eylemlerden birine dokunabilir.

İki tür öneri kalıbı vardır: kalıcı ve geçici. Daha fazla bilgi için Öneriler başlıklı makaleyi inceleyin.
content birleşik alanı. Aracı mesajının içeriği content yalnızca aşağıdakilerden biri olabilir:
text

string

UTF-8 olarak kodlanmış metin. En fazla 3.072 karakter.
fileName
(deprecated)

string

Dosyanın benzersiz adı. RCS for Business platformu, bir temsilci dosya yüklediğinde dosya adı döndürür. Aşağıdaki uploadedRbmFile yerine kullanımdan kaldırıldı.
uploadedRbmFile

object (UploadedRbmFile)

İşletmeler için RCS sunucusuna yüklenen ve bu sunucu tarafından sunulan bir dosya ile küçük resmin tanımlayıcılarını içerir.
richCard

object (RichCard)

Bağımsız bir zengin kart.
contentInfo

object (ContentInfo)

Dosyanın URL'si ve dosyanın küçük resminin URL'si dahil olmak üzere dosya hakkında bilgiler.

İşletmeler için RCS platformu, içeriği önbellekten sunar ancak bir ajan, İşletmeler için RCS platformunu içeriğin yeni bir sürümünü getirmeye ve önbelleği yenilemeye zorlayabilir.

UploadedRbmFile

Dosya ve küçük resim bilgilerini içeren mesaj

JSON gösterimi 
{
  "fileName": string,
  "thumbnailName": string
}
Alanlar
fileName

string

Dosya yüklendiğinde RCS for Business platformu tarafından döndürülen dosyanın adı.
thumbnailName

string

Küçük resmin adı. Küçük resim yüklendiğinde RCS for Business platformu tarafından döndürülür.

RichCard

Temsilciden kullanıcıya gönderilen bağımsız bir zengin kart veya zengin kart bandı.

JSON gösterimi 
{

  // Union field card can be only one of the following:
  "carouselCard": {
    object (CarouselCard)
  },
  "standaloneCard": {
    object (StandaloneCard)
  }
  // End of list of possible types for union field card.
}
Alanlar
card birleşik alanı. Bağımsız kart veya kart bandı. card aşağıdakilerden yalnızca biri olabilir:
carouselCard

object (CarouselCard)

Kart bandı.
standaloneCard

object (StandaloneCard)

Bağımsız kart.

CarouselCard

Kart bandı.

JSON gösterimi 
{
  "cardWidth": enum (CarouselCard.CardWidth),
  "cardContents": [
    {
      object (CardContent)
    }
  ]
}
Alanlar
cardWidth

enum (CarouselCard.CardWidth)

Banttaki kartların genişliği.
cardContents[]

object (CardContent)

Seçmeli listedeki her kartın içerik listesi. Bir karusel en az 2, en fazla 10 kart içerebilir.

CarouselCard.CardWidth

Banttaki kartların genişliği.

Sıralamalar
CARD_WIDTH_UNSPECIFIED Belirtilmedi.
SMALL 120 DP.
MEDIUM 232 DP.

CardContent

Kart içeriği

JSON gösterimi 
{
  "title": string,
  "description": string,
  "media": {
    object (Media)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ]
}
Alanlar
title

string

(İsteğe bağlı) Kartın başlığı. En fazla 200 karakter.
description

string

(İsteğe bağlı) Kartın açıklaması. En fazla 2.000 karakter.
media

object (Media)

(İsteğe bağlı) Karta eklenecek medya (resim, GIF, video, PDF).
suggestions[]

object (Suggestion)

(İsteğe bağlı) Karta eklenecek öneri listesi. En fazla 4 öneri.

Medya

Zengin kart içindeki bir medya dosyası.

JSON gösterimi 
{
  "height": enum (Media.Height),

  // Union field content can be only one of the following:
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
Alanlar
height

enum (Media.Height)

Dikey düzene sahip bir zengin karttaki medyanın yüksekliği. Yatay düzene sahip bağımsız bir kartta yükseklik özelleştirilemez ve bu alan yoksayılır.
content birleşik alanı. Medya içeriği content aşağıdakilerden yalnızca biri olabilir:
fileName
(deprecated)

string

Dosyanın yüklenmesi sırasında RCS for Business platformu tarafından döndürülen, dosyanın benzersiz adı. Aşağıdaki uploadedRbmFile lehine kullanımdan kaldırıldı.
uploadedRbmFile

object (UploadedRbmFile)

İşletmeler için RCS sunucusuna yüklenen ve bu sunucu tarafından sunulan bir dosya ile küçük resmin tanımlayıcılarını içerir.
contentInfo

object (ContentInfo)

Dosyanın URL'si ve küçük resminin URL'si de dahil olmak üzere dosyayla ilgili bilgiler.

İşletmeler için RCS platformu, içeriği önbellekten sunar ancak bir ajan, İşletmeler için RCS platformunu içeriğin yeni bir sürümünü getirmeye ve önbelleği yenilemeye zorlayabilir.

ContentInfo

İçerik bilgilerini içeren mesaj

JSON gösterimi 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "forceRefresh": boolean
}
Alanlar
fileUrl

string

Dosyanın herkese açık olarak erişilebilen URL'si. İşletmeler için RCS platformu, dosyayı getirdiğinde HTTP üstbilgilerindeki content-type alanından dosyanın MIME türünü belirler. İçerik türü alanı, URL'den gelen HTTP yanıtında bulunmalı ve doğru olmalıdır. Önerilen maksimum dosya boyutu 100 MB'tır.

Not: Dosya URL'lerindeki yönlendirmeler desteklenmez. Yönlendirme gerekiyorsa lütfen CreateFileRequest'i kullanın.
thumbnailUrl

string

(İsteğe bağlı, yalnızca resim, ses ve video dosyaları için) Küçük resmin herkese açık olarak erişilebilen URL'si. Maksimum boyut 100 KB.

Küçük resim URL'si sağlamazsanız kullanıcının cihazı dosyayı indirene kadar RCS for Business platformunda boş bir yer tutucu küçük resim gösterilir. Dosya, kullanıcının ayarlarına bağlı olarak otomatik olarak indirilmeyebilir ve kullanıcının bir indirme düğmesine dokunması gerekebilir.

Not: Dosya URL'lerindeki yönlendirmeler desteklenmez. Yönlendirme gerekiyorsa lütfen CreateFileRequest'i kullanın.
forceRefresh

boolean

Ayarlanmışsa RCS for Business platformu, dosyanın (ve/veya küçük resmin) önbelleğe alınmış kopyaları olsa bile dosyayı ve küçük resmi belirtilen URL'lerden getirir.

Media.Height

Medya yüksekliği

Sıralamalar
HEIGHT_UNSPECIFIED Belirtilmedi.
SHORT 112 DP.
MEDIUM 168 DP.
TALL 264 DP.

Öneri

Zengin kartta veya öneri çipi listesinde yer alan önerilen yanıt ya da önerilen işlem.

JSON gösterimi 
{
  "suggestionDisplay": enum (Suggestion.SuggestionDisplay),

  // Union field option can be only one of the following:
  "reply": {
    object (SuggestedReply)
  },
  "action": {
    object (SuggestedAction)
  }
  // End of list of possible types for union field option.
}
Alanlar
suggestionDisplay

enum (Suggestion.SuggestionDisplay)

İsteğe bağlı. Önerinin görüntüleme davranışını kontrol eder. Yalnızca Google Mesajlar istemcilerine (20260225.00 veya sonraki sürümler) gönderilen düz metin iletiler için geçerlidir. Bu alan yalnızca düz metin mesajlarıyla ilişkili bağımsız önerilerde ayarlanmalıdır. Bu alan, zengin kartlardaki önerilere veya dosya aktarımlarıyla birlikte sunulan bağımsız önerilere uygulanırsa sunucu iletiyi reddeder. Bu ayar yalnızca Google Mesajlar için serileştirilir. Diğer istemciler (ör. iOS veya Samsung) tarafından yoksayılır.
option birleşik alanı. Önerilen yanıt veya önerilen işlem. option aşağıdakilerden yalnızca biri olabilir:
reply

object (SuggestedReply)

Kullanıcılar, metin yanıtını temsilciye geri göndermek için önerilen yanıtlardan birine dokunabilir.
action

object (SuggestedAction)

Kullanıcılar, cihazda ilgili yerel işlemi başlatmak için önerilen bir işleme dokunabilir.

SuggestedReply

Dokunulduğunda metin yanıtını tekrar ajana gönderir.

JSON gösterimi 
{
  "text": string,
  "postbackData": string
}
Alanlar
text

string

Önerilen yanıtta gösterilen ve kullanıcı dokunduğunda tekrar temsilciye gönderilen metin. En fazla 25 karakter uzunluğunda olabilir.
postbackData

string

Kullanıcı, önerilen yanıta dokunduğunda kullanıcının etkinliğinde aracının aldığı base64 kodlu yük.

SuggestedAction

Dokunulduğunda cihazda ilgili yerel işlemi başlatır.

JSON gösterimi 
{
  "text": string,
  "postbackData": string,
  "fallbackUrl": string,

  // Union field action can be only one of the following:
  "dialAction": {
    object (DialAction)
  },
  "viewLocationAction": {
    object (ViewLocationAction)
  },
  "createCalendarEventAction": {
    object (CreateCalendarEventAction)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "shareLocationAction": {
    object (ShareLocationAction)
  }
  // End of list of possible types for union field action.
}
Alanlar
text

string

Önerilen işlemde gösterilen metin. En fazla 25 karakter uzunluğunda olabilir.
postbackData

string

Kullanıcı, önerilen işleme dokunduğunda ortaya çıkan kullanıcı etkinliğinde ajana gönderilecek yük (base64 kodlu). En fazla 2.048 karakter.
fallbackUrl

string

(İsteğe bağlı) Bir istemci önerilen işlemi desteklemiyorsa kullanılacak yedek URL. Yedek URL'ler yeni tarayıcı pencerelerinde açılır. RFC 3986'da tanımlandığı gibi geçerli bir URI olmalıdır. En fazla 2.048 karakter.
action birleşik alanı. Kullanıcı, önerilen işleme dokunduğunda cihazda başlatılan yerel işlem. action aşağıdakilerden yalnızca biri olabilir:
dialAction

object (DialAction)

Kullanıcının varsayılan numara çevirici uygulamasını, temsilci tarafından belirtilen telefon numarası doldurulmuş şekilde açar.
viewLocationAction

object (ViewLocationAction)

Kullanıcının varsayılan harita uygulamasını açar ve temsilci tarafından belirtilen konumu seçer veya temsilci tarafından belirtilen bir sorguyla kullanıcının konumunun çevresinde arama yapar.
createCalendarEventAction

object (CreateCalendarEventAction)

Kullanıcının varsayılan takvim uygulamasını açar ve yeni takvim etkinliği akışını, aracı tarafından belirtilen etkinlik verileri önceden doldurulmuş şekilde başlatır.
openUrlAction

object (OpenUrlAction)

Kullanıcının varsayılan web tarayıcısı uygulamasını belirtilen URL'de açar. Kullanıcının, URL için varsayılan işleyici olarak kaydedilmiş bir uygulaması yüklüyse bunun yerine bu uygulama açılır ve önerilen işlem kullanıcı arayüzünde bu uygulamanın simgesi kullanılır.
shareLocationAction

object (ShareLocationAction)

Kullanıcının temsilciye göndereceği konumu seçebilmesi için RCS uygulamasının konum seçicisini açar.

DialAction

Kullanıcının varsayılan numara çevirici uygulamasını, temsilci tarafından belirtilen telefon numarası doldurulmuş olarak açar.

JSON gösterimi 
{
  "phoneNumber": string
}
Alanlar
phoneNumber

string

E.164 biçimindeki telefon numarası (ör. +12223334444).

ViewLocationAction

Kullanıcının varsayılan harita uygulamasını açar ve temsilci tarafından belirtilen konumu seçer veya temsilci tarafından belirtilen bir sorguyla kullanıcının konumunun çevresinde arama yapar.

JSON gösterimi 
{
  "latLong": {
    object (LatLng)
  },
  "label": string,
  "query": string
}
Alanlar
latLong

object (LatLng)

(İsteğe bağlı) Belirtilen konumun enlemi ve boylamı.
label

string

(İsteğe bağlı) latLong'da bırakılan iğnenin etiketi.
query

string

(İsteğe bağlıdır ve yalnızca Android Mesajlar istemcilerinde desteklenir) Temsilci, latLong (ve isteğe bağlı olarak bir etiket) belirtmek yerine bir sorgu dizesi belirtebilir. Arama işlevini destekleyen varsayılan harita uygulamalarında (Google Haritalar dahil) bu önerilen işleme dokunulduğunda, kullanıcının mevcut konumunu merkez alan bir konum araması yapılır. Sorgu yeterince spesifikse temsilciler, dünyadaki herhangi bir konumu seçmek için bu sorguyu kullanabilir.

Örneğin, sorgu dizesini "Altın Akçe Bankası" olarak ayarladığınızda kullanıcının yakınındaki tüm Altın Akçe Bankası konumları gösterilir. Sorgu dizesini "1600 Amphitheater Parkway, Mountain View, CA 94043" olarak ayarladığınızda, kullanıcının konumundan bağımsız olarak bu adres seçilir.

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem derecelerini ve boylam derecelerini temsil eden bir çift çift sayı olarak ifade edilir. Aksi belirtilmediği sürece bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.

JSON gösterimi 
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Enlem (derece cinsinden). [-90.0, +90.0] aralığında olmalıdır.
longitude

number

Derece cinsinden boylam. [-180.0, +180.0] aralığında olmalıdır.

CreateCalendarEventAction

Kullanıcının varsayılan takvim uygulamasını açar ve yeni takvim etkinliği akışını, aracı tarafından belirtilen etkinlik verileri önceden doldurulmuş şekilde başlatır.

JSON gösterimi 
{
  "startTime": string,
  "endTime": string,
  "title": string,
  "description": string
}
Alanlar
startTime

string (Timestamp format)

Etkinliğin başlangıç zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Etkinlik bitiş zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
title

string

Etkinlik adı. En fazla 100 karakter.
description

string

Etkinlik açıklaması. En fazla 500 karakter.

OpenUrlAction

Kullanıcının varsayılan web tarayıcısı uygulamasını belirtilen URL'de açar. Kullanıcının, URL için varsayılan işleyici olarak kaydedilmiş bir uygulaması yüklüyse bunun yerine bu uygulama açılır ve önerilen işlem kullanıcı arayüzünde bu uygulamanın simgesi kullanılır.

JSON gösterimi 
{
  "url": string,
  "application": enum (OpenUrlApplication),
  "webviewViewMode": enum (WebviewViewMode),
  "description": string
}
Alanlar
url

string

Açılacak URL. 1 Kasım 2025'ten itibaren URL şeması https:// veya http:// olmalıdır. Bu tarihten sonra diğer şemaları (ör. tel:, mailto:, sms:) kullanan API istekleri 400 Bad Request hatasıyla reddedilecek. URL, RFC 3986'da tanımlandığı şekilde geçerli bir URI olmalıdır. En fazla 2.048 karakter.
application

enum (OpenUrlApplication)

URL açma uygulaması, tarayıcı veya web görünümü. Kullanıcının cihazının web görünümü modunu destekleyip desteklemediğini kontrol etmek için önce bir özellik kontrolü yapın. Ayrıntılar için dokümanlara bakın: https://developers.google.com/business-communications/rcs-business-messaging/guides/build/capabilities.
webviewViewMode

enum (WebviewViewMode)

WebView için görüntüleme modu.
description

string

WebView için erişilebilirlik açıklaması.

OpenUrlApplication

URL açma uygulamasının türü

Sıralamalar
OPEN_URL_APPLICATION_UNSPECIFIED Belirtilmedi, açmak için tarayıcı kullanılacak.
BROWSER URL'yi açmak için tarayıcıyı kullanın.
WEBVIEW URL'yi entegre web görünümü penceresinde açma

WebviewViewMode

Web görünümünün görünüm modunun türü.

Sıralamalar
WEBVIEW_VIEW_MODE_UNSPECIFIED Belirtilmedi. WebView'ı kullanmak için bir görünüm modu belirtilmelidir.
FULL Durum çubuğunda Chatbot görüşmesi etiketli tam ekran yer paylaşımı gerektirir.
HALF Yarım ekran yer paylaşımı gerektirir.
TALL Ekranın dörtte üçünü kaplayan bir ekran yer paylaşımı gerekir.

ShareLocationAction

Bu türde alan yok.

Kullanıcının temsilciye geri göndereceği konumu seçebilmesi için RCS uygulamasının konum seçicisini açar.

Suggestion.SuggestionDisplay

Bağımsız metin önerilerinin görüntüleme davranışı.

Sıralamalar
SUGGESTION_DISPLAY_UNSPECIFIED

İstemciler varsayılan görüntüleme davranışını etkinleştirir:

  • Bağımsız düz metin mesajları için Google Mesajlar: Öneriler, yeni mesajlar gönderildikten veya alındıktan sonra kaybolur.
  • iOS'te bağımsız düz metin mesajları için: Öneriler yalnızca kullanıcı dokunduktan sonra kaybolur.
  • Zengin kartlar için tüm istemciler: Öneriler her zaman kalıcıdır. Zengin kartlarda suggestionDisplay ayarlanırsa 400 hatası oluşur.
PERSISTENT Öneri, görüşmeye yeni mesajlar eklense bile mesaj balonunda sürekli olarak görünür.

StandaloneCard

Bağımsız kart

JSON gösterimi 
{
  "cardOrientation": enum (StandaloneCard.CardOrientation),
  "thumbnailImageAlignment": enum (StandaloneCard.ThumbnailImageAlignment),
  "cardContent": {
    object (CardContent)
  }
}
Alanlar
cardOrientation

enum (StandaloneCard.CardOrientation)

Kartın yönü.
thumbnailImageAlignment

enum (StandaloneCard.ThumbnailImageAlignment)

Yatay düzene sahip bağımsız kartlar için resim önizleme hizalaması.
cardContent

object (CardContent)

Kart içeriği.

StandaloneCard.CardOrientation

Kartın yönü.

Sıralamalar
CARD_ORIENTATION_UNSPECIFIED Belirtilmedi.
HORIZONTAL

Yatay düzen.

Yatay bir zengin kartın object(CardContent) alanı media alanını içeriyorsa en az bir title, description veya suggestions[] alanı da içermelidir.
VERTICAL Dikey düzen.

StandaloneCard.ThumbnailImageAlignment

Yatay düzene sahip bağımsız kartlar için resim önizleme hizalaması.

Sıralamalar
THUMBNAIL_IMAGE_ALIGNMENT_UNSPECIFIED Belirtilmedi.
LEFT Dosya önizlemesi sola hizalanır.
RIGHT Dosya önizlemesi sağa hizalanmış.

MessageTrafficType

Desteklenen mesaj trafiği türleri. Enum, ek trafik türlerini destekleyecek şekilde genişletilecek.

Sıralamalar
MESSAGE_TRAFFIC_TYPE_UNSPECIFIED Varsayılan davranış: Mesaj trafiği türü, temsilcinin kullanım alanına göre belirlenir. İleti içeriğine göre trafik türünü gerektiği şekilde güncelleyin. Çok kullanımlı aracıların varsayılan değeri yoktur. Trafik türü manuel olarak ayarlanmalıdır (ör. TRANSACTION, PROMOTION).
AUTHENTICATION OTP aracısı kullanım alanındaki kimlik doğrulama mesajları için.
TRANSACTION İşlem veya çok kullanımlı aracı kullanım alanlarındaki işlem mesajları için.
PROMOTION Tanıtım veya çok amaçlı aracı kullanım alanlarındaki tanıtım amaçlı mesajlar için.
SERVICEREQUEST Kullanıcının almayı kabul ettiği hizmetlerle ilgili mesajlar için. OTP, İşlem, Tanıtım veya Çok Kullanımlı aracı kullanım alanlarında kullanılır.
ACKNOWLEDGEMENT Kullanıcının e-posta listesinden çıkma isteğini onaylayan iletiler için. OTP, İşlem, Tanıtım veya Çok Kullanımlı aracı kullanım alanlarında kullanılır.

RichMessageClassification

Yalnızca ABD faturalandırması için: Faturalandırma için kullanılan mesaj sınıflandırmalarıyla ilgili ayrıntılar.

JSON gösterimi 
{
  "classificationType": enum (RichMessageClassificationType),
  "segmentCount": integer
}
Alanlar
classificationType

enum (RichMessageClassificationType)
segmentCount

integer

İletinin metni için 160 baytlık segmentlerin sayısıdır ve her zaman yukarı yuvarlanır.

Yalnızca metin içeriğinin toplam UTF-8 bayt uzunluğuna göre hesaplanır. Önerilen yanıtlardan veya işlemlerden gelen veriler hariç tutulur.

Örneğin, 300 bayt uzunluğundaki bir kısa mesajın segmentCount değeri 2'dir.

Bu alan yalnızca RICH_MESSAGE türleri için doldurulur.

RichMessageClassificationType

Yalnızca ABD faturalandırması için: Mesajın faturalandırma sınıflandırmasını belirtir.

Önemli: Bu sayfada açıklanan faturalandırılabilir mesaj türlerinin fiyatı ABD'deki operatörler tarafından belirlenir. ABD'deki operatörler, geliştiricinin RCS for Business mesajları gönderme konusundaki nihai ücretini de belirler. Fiyatlandırma veya faturalandırma ile ilgili daha fazla bilgi için lütfen ilgili operatör temsilcileriyle iletişime geçin.

Sıralamalar
RICH_MESSAGE_CLASSIFICATION_TYPE_UNSPECIFIED Belirtilmedi
RICH_MESSAGE İleti, aşağıdaki koşullarda ZENGİN olarak sınıflandırılır: 1. Zengin kart içermez. 2. Dosya ekleri içermez. 3. İçerdiği tüm önerilen işlemler, bir arama işlemi veya web görünümü kullanmayan bir URL açma işlemi olmalıdır.
RICH_MEDIA_MESSAGE RICH_MESSAGE ölçütlerini karşılamayan tüm mesajlar. Zengin kart, medya dosyası veya "Numara çevir" ya da "URL'yi tarayıcıda aç" dışında önerilen bir eylem içeren mesajlar bu kapsamdadır.
SUGGESTED_ACTION_CLICK Kullanıcının önerilen bir eyleme (önerilen yanıt değil) dokunmasını temsil eder. Bu sınıflandırma yalnızca kullanıcı işlemleri için geçerlidir ve yalnızca bir webhook'un UserMessage yükünde görünür. Bu durum, A2P mesajları için geçerli değildir.

Yöntemler

create

 Temsilciden kullanıcıya mesaj gönderir.

delete

 Gönderilen ancak henüz teslim edilmemiş bir temsilci mesajını iptal eder.