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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "expireTime": string,
  "ttl": string
  // End of mutually exclusive fields.
}
Alanlar
name

string

Bu alan, RCS for Business platformu tarafından ayarlanır. Temsilci mesajı oluştururken bu alanı eklemeyin. Alan, "phones/{E.164}/agentMessages/{messageId}" değerini çözümler. 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. Temsilci mesajı oluştururken bu alanı eklemeyin. Bu alan, mesajın 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)

Temsilci mesajının içeriği.

messageTrafficType

enum (MessageTrafficType)

Mesaj trafiği türü.

richMessageClassification

object (RichMessageClassification)

Yalnızca çıkış. Mesajı 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 bayt cinsinden toplam yük boyutu. Yük, mesaj metni veya öneriler hariç olmak üzere bir RCS for Business mesajındaki tüm ekleri (video, resim, PDF vb.) sayar. Şu anda bu alan 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 bilgileri. Şu anda bu alan yalnızca ABD telefon numaraları için doldurulmaktadır.

Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
expireTime

string (Timestamp format)

İsteğe bağlı. Bu kaynağın süresinin dolduğu kabul edildiği zaman damgası (UTC). Mesaj gönderildikten en az altı saniye sonra olmalıdır. Gönderimden sonraki altı saniyeden daha kısa bir gelecekteki zaman damgası belirtilirse platform bunu otomatik olarak altı saniyeye ayarlar. İleti gönderme zamanında veya öncesinde olan tüm zaman damgaları 400 INVALID_ARGUMENT hatası döndürür. İstekte expireTime veya ttl ayarlanmışsa bu değer çıkışta döndürülür ve değerde yapılan tüm ayarlamaları yansıtı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ş. Bir mesajın otomatik olarak iptal edilmeden önce geçerli olacağı süre. Minimum değer altı saniyedir. Altı saniyeden kısa pozitif bir süre belirtilirse platform, süreyi otomatik olarak altı saniyeye ayarlar ve ayarlanan değeri yanıtın expireTime alanına yansıtır. Pozitif olmayan süreler (sıfır veya daha az) 400 INVALID_ARGUMENT hatası döndürür.

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

Birbirini hariç tutan alanların sonu.

AgentContentMessage

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "text": string,
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "richCard": {
    object (RichCard)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of mutually exclusive fields.
}
Alanlar
suggestions[]

object (Suggestion)

İlgili temsilci mesajından sonra öneri çipleri listesi olarak görünen önerilen yanıtların ve önerilen işlemlerin 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 bir yanıta dokunabilir veya cihazda yerel bir işlem başlatmak için önerilen bir işleme dokunabilir.

İki tür öneri deseni vardır: kalıcı ve geçici. Daha fazla bilgi için Öneriler başlıklı makaleyi inceleyin.

Temsilci mesajının içeriği. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
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 lehine kullanımdan kaldırılmıştır.

uploadedRbmFile

object (UploadedRbmFile)

RCS for Business sunucusuna yüklenen ve bu sunucu tarafından sunulan bir dosya ve küçük resim için tanımlayıcılar 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 bir dosya hakkındaki bilgiler.

RCS for Business platformu, içeriği bir önbellekten sunar ancak bir temsilci, RCS for Business platformunu içeriğin yeni bir sürümünü getirmeye ve önbelleği yenilemeye zorlayabilir.

Birbirini hariç tutan alanların sonu.

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 dosya adı.

thumbnailName

string

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

RichCard

Temsilciden kullanıcıya gönderilen bağımsız bir zengin kart veya zengin kartlardan oluşan bir bant.

JSON gösterimi
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "carouselCard": {
    object (CarouselCard)
  },
  "standaloneCard": {
    object (StandaloneCard)
  }
  // End of mutually exclusive fields.
}
Alanlar
Bağımsız kart veya kart bandı. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
carouselCard

object (CarouselCard)

Kart bandı.

standaloneCard

object (StandaloneCard)

Bağımsız kart.

Birbirini hariç tutan alanların sonu.

CarouselCard

Kart bandı.

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

enum (CarouselCard.CardWidth)

Dönen banttaki kartların genişliği.

cardContents[]

object (CardContent)

Döngüdeki her kartın içerik listesi. Ruloda en az 2, en fazla 10 kart olabilir.

CarouselCard.CardWidth

Dönen 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ığı. Maksimum 200 karakter.

description

string

(İsteğe bağlı) Kartın açıklaması. Maksimum 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 dahil edilecek önerilerin listesi. En fazla 4 öneri.

Medya

Zengin kart içindeki medya dosyası.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of mutually exclusive fields.
}
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 kart için iOS uyumluluğu amacıyla HEIGHT_UNSPECIFIED yerine TALL kullanın.

contentDescription

string

İsteğe bağlı. Erişilebilirlik için medya içeriğini açıklayarak alternatif metin sağlar. En fazla 200 karakterlik düz metin desteklenir.

Medya içeriği Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
fileName
(deprecated)

string

Dosya yüklendiğinde RCS for Business platformu tarafından döndürülen benzersiz dosya adı. Aşağıdaki uploadedRbmFile lehine kullanımdan kaldırılmıştır.

uploadedRbmFile

object (UploadedRbmFile)

RCS for Business sunucusuna yüklenen ve bu sunucu tarafından sunulan bir dosya ve küçük resim için tanımlayıcılar içerir.

contentInfo

object (ContentInfo)

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

RCS for Business platformu, içeriği bir önbellekten sunar ancak bir temsilci, RCS for Business platformunu içeriğin yeni bir sürümünü getirmeye ve önbelleği yenilemeye zorlayabilir.

Birbirini hariç tutan alanların sonu.

ContentInfo

İçerik bilgilerini barındıran mesaj.

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

string

Dosyanın herkes tarafından erişilebilen URL'si. RCS for Business platformu, dosyayı getirirken HTTP üstbilgilerindeki content-type alanından dosyanın MIME türünü belirler. URL'den gelen HTTP yanıtında content-type alanı 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 URL'si. Maksimum boyut 100 kB'tır.

Küçük resim URL'si sağlamazsanız RCS for Business platformu, kullanıcının cihazı dosyayı indirene kadar boş bir yer tutucu küçük resim gösterir. Kullanıcının ayarına bağlı olarak dosya 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

Bu ayar belirlenirse 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 kart veya öneri çipi listesinde yer alan önerilen yanıt ya da önerilen işlem.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "reply": {
    object (SuggestedReply)
  },
  "action": {
    object (SuggestedAction)
  }
  // End of mutually exclusive fields.
}
Alanlar
suggestionDisplay

enum (Suggestion.SuggestionDisplay)

İsteğe bağlı. Önerinin görüntülenme davranışını kontrol eder. Yalnızca Google Mesajlar istemcilerine (sürüm 20260225.00 veya sonraki sürümler) gönderilen düz metin mesajları için geçerlidir. Bu alan yalnızca düz metin kısa mesajlarla ilişkili bağımsız önerilerde ayarlanmalıdır. Bu alan, zengin kartlardaki önerilere veya dosya aktarımları içeren bağımsız önerilere uygulanırsa sunucu mesajı reddeder. Bu ayar yalnızca Google Mesajlar için serileştirilir ve diğer istemciler (ör. iOS veya Samsung) tarafından yoksayılır.

Önerilen yanıt veya önerilen işlem. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
reply

object (SuggestedReply)

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

action

object (SuggestedAction)

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

Birbirini hariç tutan alanların sonu.

SuggestedReply

Dokunulduğunda metin yanıtını temsilciye geri gönderir.

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

string

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

postbackData

string

Kullanıcı önerilen yanıtı dokunduğunda temsilcinin bir kullanıcı etkinliğinde 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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dialAction": {
    object (DialAction)
  },
  "viewLocationAction": {
    object (ViewLocationAction)
  },
  "createCalendarEventAction": {
    object (CreateCalendarEventAction)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "shareLocationAction": {
    object (ShareLocationAction)
  }
  // End of mutually exclusive fields.
}
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 temsilciye gönderilecek yük (base64 kodlu). En fazla 2.048 karakter.

fallbackUrl

string

(İsteğe bağlı) İstemci, önerilen bir işlemi desteklemiyorsa kullanılacak yedek URL. Yedek URL'ler yeni tarayıcı pencerelerinde açılır. RFC 3986'da tanımlandığı şekilde geçerli bir URI olmalıdır. En fazla 2.048 karakter.

Kullanıcı önerilen işleme dokunduğunda cihazda başlatılan yerel işlem. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
dialAction

object (DialAction)

Kullanıcının varsayılan numara çevirici uygulamasını, temsilci tarafından belirtilen telefon numarası doldurulmuş olarak 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 sorgu doğrultusunda kullanıcının konumu etrafında arama yapar.

createCalendarEventAction

object (CreateCalendarEventAction)

Kullanıcının varsayılan takvim uygulamasını açar ve temsilci tarafından belirtilen etkinlik verileri önceden doldurulmuş olarak yeni takvim etkinliği akışını 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 kayıtlı bir uygulaması varsa 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.

Birbirini hariç tutan alanların sonu.

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 sorgu doğrultusunda kullanıcının konumu etrafında arama yapar.

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

object (LatLng)

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

label

string

(İsteğe bağlı) latLong'a bırakılan raptiyenin etiketi.

query

string

(İsteğe bağlı) 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 merkeze alan bir konum araması yapılır. Sorgu yeterince spesifikse temsilciler bu sorguyu kullanarak dünyadaki herhangi bir konumu seçebilir.

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

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem ve boylam derecelerini temsil eden bir çift double değeri olarak ifade edilir. Aksi belirtilmedikçe bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklarda olmalıdır.

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

number

Derece cinsinden enlem. [-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 temsilci tarafından belirtilen etkinlik verileri önceden doldurulmuş olarak yeni takvim etkinliği akışını başlatır.

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

string (Timestamp format)

Etkinlik 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ı. Maksimum 500 karakter.

OpenUrlAction

Kullanıcının varsayılan web tarayıcısı uygulamasını belirtilen URL'ye açar. Kullanıcının URL için varsayılan işleyici olarak kayıtlı bir uygulaması varsa 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. Başka şemalar (ör. tel:, mailto:, sms:) kullanan API istekleri, bu tarihten sonra 400 Hatalı İstek 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, uygulama, tarayıcı veya web görünümü açar. Kullanıcının cihazının webview modunu destekleyip desteklemediğini kontrol etmek için önce özellik kontrolü yapın. Ayrıntılar için belgelere bakın: https://developers.google.com/business-communications/rcs-business-messaging/guides/build/capabilities.

webviewViewMode

enum (WebviewViewMode)

Web görünümü için görüntüleme modu.

description

string

Web görünümü 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 bir web görünümü penceresinde açma

WebviewViewMode

Webview'un görüntüleme modunun türü.

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

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ülenme davranışı.

Sıralamalar
SUGGESTION_DISPLAY_UNSPECIFIED

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

  • Bağımsız düz metin mesajları için Google Mesajlar: Yeni mesajlar gönderildikten veya alındıktan sonra öneriler kaybolur.
  • Bağımsız düz metin mesajları için iOS: Ö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 ayarının yapılması 400 hatasına neden olur.
PERSISTENT Görüşmeye yeni mesajlar eklense bile öneri, mesaj balonunda görünmeye devam eder.

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 zengin kartın object(CardContent) öğesi 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 hizalanır.

MessageTrafficType

Desteklenen mesaj trafiği türleri. Numaralandırma, diğer trafik türlerini destekleyecek şekilde genişletilecek. Temsilci kullanım alanı, kullanılacak trafik türü için rehberlik sağlayabilir ancak aralarındaki ilişkiyle ilgili API yaptırımı yoktur.

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 amaçlı temsilciler için varsayılan bir değer sağlanmaz. Trafik türü manuel olarak ayarlanmalıdır (ör. İŞLEM, PROMOSYON).
AUTHENTICATION Kimlik doğrulama mesajları için (OTP temsilcisi kullanım alanı için önerilir).
TRANSACTION İşlem mesajları için (işlem veya çok kullanımlı temsilci kullanım alanları için önerilir).
PROMOTION Tanıtım mesajları için (Tanıtım amaçlı veya çok kullanımlı temsilci kullanım alanları için önerilir).
SERVICEREQUEST Kullanıcının almayı kabul ettiği hizmetlerle ilgili mesajlar için (OTP, işlem, tanıtım veya çok amaçlı temsilci kullanım alanları için önerilir).
ACKNOWLEDGEMENT Kullanıcının e-posta listesinden çıkma isteğini onaylayan mesajlar için (OTP, işlem amaçlı, tanıtım amaçlı veya çok amaçlı temsilci kullanım alanları için önerilir).

RichMessageClassification

Yalnızca ABD'deki faturalandırma 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

İleti metni için 160 baytlık segmentlerin sayısı (her zaman yukarı yuvarlanır).

Yalnızca metin içeriğinin toplam UTF-8 bayt uzunluğundan hesaplanır. Önerilen yanıtlar veya işlemlerden elde edilen 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'deki faturalandırma için: Mesajın faturalandırma sınıflandırmasını belirtir.

Önemli: ABD'deki operatörler, bu sayfada açıklanan faturalandırılabilir mesaj türlerinin fiyatını belirler. ABD'deki operatörler, geliştiricinin RCS for Business mesajları göndermek için ödeyeceği nihai ücreti de belirler. Fiyatlandırma veya faturalandırma hakkında 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 Mesaj, aşağıdaki koşullarda RICH olarak sınıflandırılır: 1. Zengin kartlar içermez. 2. Dosya eki içermez. 3. İçerdiği önerilen işlemler, çevirme 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 "Çevir" ya da "URL'yi tarayıcıda aç" dışında önerilen işlemler içeren mesajlar buna dahildir.
SUGGESTED_ACTION_CLICK Kullanıcının önerilen bir eyleme (önerilen yanıta 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. A2P mesajları için geçerli değildir.

Yöntemler

create

Temsilciden kullanıcıya mesaj gönderir.

delete

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