Kaynak: Mesaj
Temsilci ile kullanıcı arasındaki görüşmede yer alan bir mesaj.
JSON gösterimi |
---|
{ "name": string, "messageId": string, "representative": { object ( |
Alanlar | |
---|---|
name |
Mesajın, Business Messages tarafından ayarlanan adı. "conversation/{conversationId}/messages/{messageId}" olarak çözümlenir; burada {conversationId} ileti dizisinin benzersiz kimliği, {messageId} ise iletinin benzersiz kimliğidir. |
messageId |
Zorunlu. Mesajın temsilci tarafından atanan benzersiz tanımlayıcısı. Bir ileti, önceki iletiyle aynı |
representative |
Mesajı gönderen temsilciyle (insan veya chatbot) ilgili ayrıntılar. |
suggestions[] |
İlişkili mesajın ardından öneri çiplerinden oluşan bir liste olarak görünen önerilen yanıtların listesi. Maksimum 13 öneri. Çipler yalnızca ilişkili mesaj, görüşmedeki en son mesaj olduğunda (hem temsilci hem de kullanıcı mesajları dahil) gösterilir. Kullanıcı, önerilen bir yanıta dokunarak kısa mesajı temsilciye gönderebilir. |
fallback |
İsteğe bağlı. Kullanıcının cihazı ileti türünü veya içeriği desteklemiyorsa görüntülenen yedek metin. Maksimum 3.072 karakter. |
containsRichText |
İsteğe bağlı. |
content alanı. Bir iletinin içeriği. content şunlardan yalnızca biri olabilir: |
|
text |
Kısa mesaj. Maksimum 3.072 karakter. |
image |
Resim mesajı. |
richCard |
Zengin Kart mesajı. |
Resim
Bir resim.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
content alanı. Resim içeriği. content şunlardan yalnızca biri olabilir: |
|
contentInfo |
Görselin URL'si ve küçük resminin URL'si de dahil olmak üzere bir görsel hakkında bilgiler. |
ContentInfo
İçerik bilgilerini içeren ileti.
JSON gösterimi |
---|
{ "fileUrl": string, "thumbnailUrl": string, "forceRefresh": boolean, "altText": string } |
Alanlar | |
---|---|
fileUrl |
Dosyanın herkese açık URL'si. Platform, dosyayı getirdiğinde dosyanın MIME türünü HTTP üstbilgilerindeki içerik türü alanından belirler. İçerik türü alanı, URL'den gelen HTTP yanıtında mevcut ve doğru olmalıdır. Maksimum 5 MB. Desteklenen içerik türleri: resim/jpeg, resim/jpg, resim/png, resim/webp |
thumbnailUrl |
İsteğe bağlı. Küçük resmin herkes tarafından erişilebilen URL'si. Küçük resim URL'si sağlamazsanız platform, kullanıcının cihazı dosyayı indirene kadar boş bir yer tutucu küçük resim gösterir. En fazla 25 KB. Desteklenen içerik türleri: resim/jpeg, resim/jpg, resim/png, resim/webp |
forceRefresh |
Ayarlanırsa platform, dosyanın (ve/veya küçük resmin) önbelleğe alınmış kopyalarını almış olsa bile belirtilen URL'lerden dosyayı ve küçük resmi getirir. |
altText |
Erişilebilirlik amacıyla medyayla ilgili ayrıntıları açıklayan metin. |
RichCard
Bağımsız bir zengin kart veya aracıdan kullanıcıya gönderilen zengin kart bandı.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
card alanı. Olası zengin kart türleri. card şunlardan yalnızca biri olabilir: |
|
standaloneCard |
Bağımsız kart. |
carouselCard |
Kart bandı. |
StandaloneCard
Bağımsız kart.
JSON gösterimi |
---|
{
"cardContent": {
object ( |
Alanlar | |
---|---|
cardContent |
Kart içeriği. |
CardContent
Kart içeriği.
JSON gösterimi |
---|
{ "title": string, "description": string, "media": { object ( |
Alanlar | |
---|---|
title |
İsteğe bağlı. Kartın başlığı. Maksimum 200 karakter. |
description |
İsteğe bağlı. Kartın açıklaması. Maksimum 2.000 karakter. |
media |
İsteğe bağlı. Karta eklenecek medya. |
suggestions[] |
İsteğe bağlı. Karta dahil edilecek önerilerin listesi. Maksimum 4 öneri. |
Medya
Zengin kart içindeki bir medya dosyası.
JSON gösterimi |
---|
{ "height": enum ( |
Alanlar | |
---|---|
height |
Zengin kart içindeki medyanın yüksekliği. |
content alanı. Medya içeriği. content şunlardan yalnızca biri olabilir: |
|
contentInfo |
Dosyanın URL'si ve dosyanın küçük resminin URL'si de dahil olmak üzere dosya hakkında bilgiler. |
Boy
Medya yüksekliği
Sıralamalar | |
---|---|
HEIGHT_UNSPECIFIED |
Belirtilmedi. |
SHORT |
112 DP |
MEDIUM |
168 DP. |
TALL |
264 DPY. Kart genişliği SMALL olarak ayarlandığında zengin kart ruloları için kullanılamaz. |
Öneri
Çip listesindeki bir öneri.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
option alanı. Önerilen yanıt. option şunlardan yalnızca biri olabilir: |
|
reply |
Kullanıcının belirtilen metinle yanıt vermesi için öneri. |
action |
Cihazda yerel bir işlem başlatan önerilen işlem. |
liveAgentRequest |
Canlı müşteri temsilcisinin görüşmeye katılma isteği. |
authenticationRequest |
Kimlik doğrulama akışını başlatma isteği. |
SuggestedReply
Dokunulduğunda kısa mesajı temsilciye geri gönderir.
JSON gösterimi |
---|
{ "text": string, "postbackData": string } |
Alanlar | |
---|---|
text |
Önerilen yanıtta gösterilen ve kullanıcı dokunduğunda temsilciye gönderilen metin. Maksimum 25 karakter |
postbackData |
Bir kullanıcı önerilen yanıta dokunduğunda temsilcinin aldığı dize. Maksimum 2.048 karakter. |
SuggestedAction
Dokunulduğunda, cihazda ilgili yerel işlemi başlatır.
JSON gösterimi |
---|
{ "text": string, "postbackData": string, // Union field |
Alanlar | |
---|---|
text |
Önerilen işlemde gösterilen metin. Maksimum 25 karakter |
postbackData |
Bir kullanıcı önerilen işleme dokunduğunda temsilcinin aldığı dize. Maksimum 2.048 karakter. |
action alanı. Kullanıcı önerilen işleme dokunduğunda cihazda başlatılan yerel işlem. action şunlardan yalnızca biri olabilir: |
|
openUrlAction |
Belirtilen URL'yi açar. |
dialAction |
Kullanıcının varsayılan numara çevirici uygulamasını açar. |
OpenUrlAction
Belirtilen URL'yi açar.
JSON gösterimi |
---|
{ "url": string } |
Alanlar | |
---|---|
url |
URL |
DialAction
Belirtilen telefon numarası doldurulmuş olarak kullanıcının varsayılan numara çevirici uygulamasını açar.
JSON gösterimi |
---|
{ "phoneNumber": string } |
Alanlar | |
---|---|
phoneNumber |
Zorunlu. RFC 3966 biçiminde belirtilen, belirtilen telefon numarası. Örneğin, "+1-201-555-0123". |
LiveAgentRequest
Bu türde alan yok.
Dokunulduğunda, canlı müşteri temsilcisinin görüşmeye katılması için istek gönderir.
AuthenticationRequest
Bir görüşmenin kimliğini doğrulama isteği.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
authentication_type alanı. Kimlik doğrulama türü. authentication_type şunlardan yalnızca biri olabilir: |
|
oauth |
OAuth aracılığıyla kimlik doğrulama ayrıntıları. |
OAuth
OAuth aracılığıyla kimlik doğrulama ayrıntıları.
JSON gösterimi |
---|
{ "clientId": string, "codeChallenge": string, "scopes": [ string ], "codeChallengeMethod": string } |
Alanlar | |
---|---|
clientId |
Zorunlu. Yetkilendirme isteyen uygulamanın kimliği. |
codeChallenge |
Zorunlu. Erişim jetonlarını değiştirmek için kullanılan kod sorgulaması. |
scopes[] |
Zorunlu. İsteğin kapsamlarını belirten bir dizi. |
codeChallengeMethod |
İsteğe bağlı. Kod sorgulamasını oluşturmak için kullanılan kod sorgulama yöntemi. Bu parametre atlanırsa sunucu |
CarouselCard
Kart bandı.
JSON gösterimi |
---|
{ "cardWidth": enum ( |
Alanlar | |
---|---|
cardWidth |
Banttaki kartların genişliği. |
cardContents[] |
Banttaki her kart için içerik listesi. Bantta en az 2 ve en fazla 10 kart olabilir. |
CardWidth
Banttaki kartların genişliği.
Sıralamalar | |
---|---|
CARD_WIDTH_UNSPECIFIED |
Belirtilmedi |
SMALL |
136 DP. Uzun medya dahil edilemiyor. |
MEDIUM |
280 DP |
Yöntemler |
|
---|---|
|
Bir temsilciden kullanıcıya mesaj gönderir. |
|
Bir temsilciden kullanıcıya mesaj için makbuz gönderir. |