WelcomeMessage

คําทักทายที่แสดงต่อผู้ใช้เมื่อเข้าสู่การสนทนากับตัวแทนเป็นครั้งแรก

การแสดง JSON
{

  // Union field content can be only one of the following:
  "text": string,
  "richText": string,
  "image": {
    object (Image)
  },
  "richCard": {
    object (RichCard)
  }
  // End of list of possible types for union field content.
}
ช่อง
ฟิลด์การรวม content เนื้อหาของข้อความต้อนรับ content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
text

string

SMS ความยาวสูงสุด 1,000 อักขระ

richText

string

Rich Text Format ในการจัดรูปแบบมาร์กดาวน์ที่ถูกต้อง

image

object (Image)

ข้อความรูปภาพ

richCard

object (RichCard)

ข้อความ Rich Card โดยอาจเป็นการ์ดเดี่ยวหรือภาพสไลด์ก็ได้

รูปภาพ

รูปภาพ

การแสดง JSON
{

  // Union field content can be only one of the following:
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
ช่อง
ฟิลด์การรวม content เนื้อหารูปภาพ content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
contentInfo

object (ContentInfo)

ข้อมูลเกี่ยวกับรูปภาพ รวมถึง URL ของรูปภาพและ URL ของรูปภาพขนาดย่อ

ContentInfo

ข้อความที่มีข้อมูลเนื้อหา

การแสดง JSON
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "forceRefresh": boolean,
  "altText": string
}
ช่อง
fileUrl

string

URL ของไฟล์ที่เข้าถึงได้แบบสาธารณะ แพลตฟอร์มจะกำหนดประเภท MIME ของไฟล์จากช่องประเภทเนื้อหาในส่วนหัว HTTP เมื่อแพลตฟอร์มดึงไฟล์ ต้องมีฟิลด์ content-type อยู่และถูกต้องในการตอบกลับ HTTP จาก URL

สูงสุด 5 MB

ประเภทเนื้อหาที่รองรับ: รูปภาพ/jpeg, รูปภาพ/jpg, รูปภาพ/png, รูปภาพ/webp

thumbnailUrl

string

ไม่บังคับ URL ของภาพขนาดย่อที่เข้าถึงได้แบบสาธารณะ

หากไม่ระบุ URL ของภาพขนาดย่อ แพลตฟอร์มจะแสดงภาพขนาดย่อที่ว่างเปล่าของตัวยึดตำแหน่งจนกว่าอุปกรณ์ของผู้ใช้จะดาวน์โหลดไฟล์

ไม่เกิน 25 KB

ประเภทเนื้อหาที่รองรับ: รูปภาพ/jpeg, รูปภาพ/jpg, รูปภาพ/png, รูปภาพ/webp

forceRefresh

boolean

หากตั้งค่าไว้ แพลตฟอร์มจะดึงข้อมูลไฟล์และภาพขนาดย่อจาก URL ที่ระบุ แม้ว่าแพลตฟอร์มจะแคชสำเนาไฟล์ (และ/หรือภาพขนาดย่อ) ไว้ก็ตาม

altText

string

ข้อความที่อธิบายรายละเอียดเกี่ยวกับสื่อเพื่อวัตถุประสงค์ในการช่วยเหลือพิเศษ

RichCard

การ์ดริชมีเดียแบบสแตนด์อโลนหรือภาพสไลด์ของการ์ดริชมีเดียที่ส่งจาก Agent ไปยังผู้ใช้

การแสดง JSON
{

  // Union field card can be only one of the following:
  "standaloneCard": {
    object (StandaloneCard)
  },
  "carouselCard": {
    object (CarouselCard)
  }
  // End of list of possible types for union field card.
}
ช่อง
ฟิลด์การรวม card ประเภทของการ์ดริชมีเดีย card ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
standaloneCard

object (StandaloneCard)

บัตรสแตนด์อโลน

carouselCard

object (CarouselCard)

ภาพสไลด์ของการ์ด

StandaloneCard

บัตรสแตนด์อโลน

การแสดง JSON
{
  "cardContent": {
    object (CardContent)
  }
}
ช่อง
cardContent

object (CardContent)

เนื้อหาการ์ด

CardContent

เนื้อหาการ์ด

การแสดง JSON
{
  "title": string,
  "description": string,
  "media": {
    object (Media)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ]
}
ช่อง
title

string

ไม่บังคับ ชื่อการ์ด สูงสุด 200 อักขระ

description

string

ไม่บังคับ คำอธิบายของการ์ด สูงสุด 2,000 อักขระ

media

object (Media)

ไม่บังคับ สื่อที่จะรวมไว้ในการ์ด

suggestions[]

object (Suggestion)

ไม่บังคับ รายการคำแนะนำที่จะรวมไว้ในการ์ด แนะนำได้สูงสุด 4 รายการ

สื่อ

ไฟล์สื่อภายในการ์ดริชมีเดีย

การแสดง JSON
{
  "height": enum (Height),

  // Union field content can be only one of the following:
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
ช่อง
height

enum (Height)

ความสูงของสื่อภายในการ์ดริชมีเดีย

ฟิลด์การรวม content เนื้อหาสื่อ content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
contentInfo

object (ContentInfo)

ข้อมูลเกี่ยวกับไฟล์ ซึ่งรวมถึง URL ของไฟล์และ URL ภาพขนาดย่อของไฟล์

ส่วนสูง

ความสูงของสื่อ

Enum
HEIGHT_UNSPECIFIED ไม่ได้ระบุ
SHORT 112 DP
MEDIUM 168 DP
TALL 264 DP ใช้ไม่ได้กับภาพสไลด์การ์ดริชมีเดียเมื่อตั้งค่าความกว้างของการ์ดเป็น SMALL

คำแนะนำ

คำแนะนำภายในรายการชิป

การแสดง JSON
{

  // Union field option can be only one of the following:
  "reply": {
    object (SuggestedReply)
  },
  "action": {
    object (SuggestedAction)
  },
  "liveAgentRequest": {
    object (LiveAgentRequest)
  },
  "authenticationRequest": {
    object (AuthenticationRequest)
  }
  // End of list of possible types for union field option.
}
ช่อง
ฟิลด์การรวม option คำตอบที่แนะนำ option ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
reply

object (SuggestedReply)

คำแนะนำให้ผู้ใช้ตอบกลับด้วยข้อความที่ระบุ

action

object (SuggestedAction)

การดำเนินการที่แนะนำที่เริ่มการดำเนินการดั้งเดิมในอุปกรณ์

liveAgentRequest

object (LiveAgentRequest)

คําขอให้ตัวแทนแบบเรียลไทม์เข้าร่วมการสนทนา

authenticationRequest

object (AuthenticationRequest)

คำขอเพื่อเริ่มขั้นตอนการตรวจสอบสิทธิ์

SuggestedReply

เมื่อแตะแล้ว ระบบจะส่งข้อความตอบกลับไปยังตัวแทน

การแสดง JSON
{
  "text": string,
  "postbackData": string
}
ช่อง
text

string

ข้อความที่แสดงในการตอบกลับที่แนะนำและส่งไปยังตัวแทนเมื่อผู้ใช้แตะคำตอบ สูงสุด 25 อักขระ

postbackData

string

สตริงที่ตัวแทนได้รับเมื่อผู้ใช้แตะการตอบกลับที่แนะนำ สูงสุด 2,048 อักขระ

SuggestedAction

เมื่อแตะ จะเป็นการเริ่มการทำงานดั้งเดิมที่เกี่ยวข้องในอุปกรณ์

การแสดง JSON
{
  "text": string,
  "postbackData": string,

  // Union field action can be only one of the following:
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "dialAction": {
    object (DialAction)
  }
  // End of list of possible types for union field action.
}
ช่อง
text

string

ข้อความที่แสดงในการดำเนินการที่แนะนำ สูงสุด 25 อักขระ

postbackData

string

สตริงที่ตัวแทนได้รับเมื่อผู้ใช้แตะการดำเนินการที่แนะนำ สูงสุด 2,048 อักขระ

ฟิลด์การรวม action การดำเนินการแบบเนทีฟที่เริ่มต้นในอุปกรณ์เมื่อผู้ใช้แตะการดำเนินการที่แนะนำ action ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
openUrlAction

object (OpenUrlAction)

เปิด URL ที่ระบุ

dialAction

object (DialAction)

เปิดแอปโทรศัพท์เริ่มต้นของผู้ใช้

OpenUrlAction

เปิด URL ที่ระบุ

การแสดง JSON
{
  "url": string
}
ช่อง
url

string

URL

DialAction

เปิดแอปโทรศัพท์เริ่มต้นของผู้ใช้ที่มีการกรอกหมายเลขโทรศัพท์ที่ระบุ

การแสดง JSON
{
  "phoneNumber": string
}
ช่อง
phoneNumber

string

ต้องระบุ หมายเลขโทรศัพท์ที่ระบุในรูปแบบ RFC 3966 เช่น "+1-201-555-0123"

LiveAgentRequest

เมื่อแตะ ระบบจะส่งคำขอให้ตัวแทนแบบเรียลไทม์เข้าร่วมการสนทนา

AuthenticationRequest

คำขอตรวจสอบสิทธิ์การสนทนา

การแสดง JSON
{

  // Union field authentication_type can be only one of the following:
  "oauth": {
    object (Oauth)
  }
  // End of list of possible types for union field authentication_type.
}
ช่อง
ฟิลด์การรวม authentication_type ประเภทการตรวจสอบสิทธิ์ authentication_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
oauth

object (Oauth)

รายละเอียดสำหรับการตรวจสอบสิทธิ์ผ่าน OAuth

OAuth

รายละเอียดสำหรับการตรวจสอบสิทธิ์ผ่าน OAuth

การแสดง JSON
{
  "clientId": string,
  "codeChallenge": string,
  "scopes": [
    string
  ],
  "codeChallengeMethod": string
}
ช่อง
clientId

string

ต้องระบุ รหัสของแอปพลิเคชันที่ขอสิทธิ์

codeChallenge

string

ต้องระบุ การพิสูจน์โค้ดที่ใช้เพื่อแลกเปลี่ยนโทเค็นเพื่อการเข้าถึง

scopes[]

string

ต้องระบุ อาร์เรย์ที่ระบุขอบเขตของคำขอ

codeChallengeMethod

string

ไม่บังคับ วิธีการทดสอบโค้ดที่ใช้สร้างระบบทดสอบโค้ด หากละเว้นพารามิเตอร์นี้ เซิร์ฟเวอร์จะถือว่า plain

CarouselCard

ภาพสไลด์ของการ์ด

การแสดง JSON
{
  "cardWidth": enum (CardWidth),
  "cardContents": [
    {
      object (CardContent)
    }
  ]
}
ช่อง
cardWidth

enum (CardWidth)

ความกว้างของการ์ดในภาพสไลด์

cardContents[]

object (CardContent)

รายการเนื้อหาของการ์ดแต่ละใบในภาพสไลด์ ภาพสไลด์มีการ์ดอย่างน้อย 2 ใบและได้สูงสุด 10 ใบ

CardWidth

ความกว้างของการ์ดในภาพสไลด์

Enum
CARD_WIDTH_UNSPECIFIED ไม่ได้ระบุ
SMALL 136 DP ใส่สื่อที่สูงไม่ได้
MEDIUM 280 DP