REST Resource: phones.agentMessages

แหล่งข้อมูล: AgentMessage

ข้อความที่ตัวแทนส่งถึงผู้ใช้

การแสดง JSON 
{
  "name": string,
  "sendTime": string,
  "contentMessage": {
    object (AgentContentMessage)
  },

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

string

แพลตฟอร์ม RBM จะเป็นผู้ตั้งค่าช่องนี้ อย่าใส่ข้อมูลนี้เมื่อสร้างข้อความของตัวแทน ช่องนี้จะแก้ไขเป็น "phones/{E.164}/agentMessages/{messageId}" โดยที่ {E.164} คือหมายเลขโทรศัพท์ของผู้ใช้ในรูปแบบ E.164 และ {messageId} คือรหัสที่ตัวแทนกำหนดให้กับข้อความของตัวแทน
sendTime

string (Timestamp format)

ช่องนี้ตั้งค่าโดยแพลตฟอร์ม RBM อย่าใส่ข้อมูลนี้เมื่อสร้างข้อความของตัวแทน ช่องนี้จะแสดงเวลาที่ส่งข้อความถึงผู้ใช้

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
contentMessage

object (AgentContentMessage)

เนื้อหาของข้อความตัวแทน

ฟิลด์สหภาพ expiration

expiration ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
expireTime

string (Timestamp format)

ไม่บังคับ การประทับเวลาใน UTC ของเวลาที่ถือว่าทรัพยากรนี้หมดอายุ ระบบจะแสดงค่านี้ในเอาต์พุตหากมีการตั้งค่าหรือมีการตั้งค่าช่อง TTL

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
ttl

string (Duration format)

ไม่บังคับ อินพุตเท่านั้น ระยะเวลาก่อนที่ข้อความจะถูกเพิกถอนโดยอัตโนมัติ

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"

AgentContentMessage

เนื้อหาของข้อความที่ตัวแทนส่งถึงผู้ใช้

การแสดง JSON 
{
  "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.
}
ช่อง
suggestions[]

object (Suggestion)

รายการคำตอบที่แนะนำและการดำเนินการที่แนะนำซึ่งปรากฏเป็นรายการชิปคำแนะนำต่อจากข้อความตัวแทนที่เกี่ยวข้อง คำแนะนำสูงสุด 11 รายการ

ชิปจะแสดงเฉพาะเมื่อข้อความของตัวแทนที่เกี่ยวข้องเป็นข้อความล่าสุดในการสนทนา (รวมถึงทั้งข้อความของตัวแทนและผู้ใช้) ผู้ใช้สามารถแตะการตอบกลับที่แนะนำเพื่อส่งการตอบกลับแบบข้อความกลับไปยังตัวแทน หรือแตะการดำเนินการที่แนะนำเพื่อเริ่มการดำเนินการแบบเนทีฟในอุปกรณ์ สูงสุด 11 คำแนะนำ
ช่องการรวม content เนื้อหาของข้อความตัวแทน content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
text

string

ข้อความที่เข้ารหัส UTF-8 ความยาวไม่เกิน 3,072 อักขระ
fileName
(deprecated)

string

ชื่อที่ไม่ซ้ำกันของไฟล์ แพลตฟอร์ม RBM จะแสดงชื่อไฟล์เมื่อตัวแทนอัปโหลดไฟล์ เลิกใช้งานแล้ว โปรดใช้ uploadedRbmFile ด้านล่าง
uploadedRbmFile

object (UploadedRbmFile)

มีตัวระบุสำหรับไฟล์และภาพขนาดย่อที่อัปโหลดและแสดงโดยเซิร์ฟเวอร์ RBM
richCard

object (RichCard)

Rich Card แบบสแตนด์อโลน
contentInfo

object (ContentInfo)

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

แพลตฟอร์ม RBM จะแสดงเนื้อหาจากแคช แต่ตัวแทนสามารถบังคับให้แพลตฟอร์ม RBM ดึงข้อมูลเนื้อหาเวอร์ชันใหม่และรีเฟรชแคชได้

UploadedRbmFile

ข้อความที่มีข้อมูลไฟล์และภาพขนาดย่อ

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

string

ชื่อไฟล์ที่แสดงโดยแพลตฟอร์ม RBM เมื่ออัปโหลดไฟล์
thumbnailName

string

ชื่อของภาพปกที่แสดงโดยแพลตฟอร์ม RBM เมื่ออัปโหลดภาพปก

การ์ดริชมีเดีย

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

การแสดง JSON 
{

  // 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.
}
ช่อง
ฟิลด์สหภาพ card การ์ดเดี่ยวหรือภาพสไลด์การ์ด card ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
carouselCard

object (CarouselCard)

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

object (StandaloneCard)

การ์ดแบบสแตนด์อโลน

CarouselCard

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

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

enum (CarouselCard.CardWidth)

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

object (CardContent)

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

CarouselCard.CardWidth

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

Enum
CARD_WIDTH_UNSPECIFIED ไม่ได้ระบุ
SMALL 120 DP โปรดทราบว่าจะใช้สื่อแนวตั้งไม่ได้
MEDIUM 232 DP

CardContent

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

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

string

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

string

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

object (Media)

(ไม่บังคับ) สื่อ (รูปภาพ, GIF, วิดีโอ) ที่จะรวมไว้ในการ์ด
suggestions[]

object (Suggestion)

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

สื่อ

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

การแสดง JSON 
{
  "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.
}
ช่อง
height

enum (Media.Height)

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

string

ชื่อที่ไม่ซ้ำกันของไฟล์ที่แสดงโดยแพลตฟอร์ม RBM เมื่ออัปโหลดไฟล์ เลิกใช้งานแล้ว โปรดใช้ uploadedRbmFile ด้านล่าง
uploadedRbmFile

object (UploadedRbmFile)

มีตัวระบุสำหรับไฟล์และภาพขนาดย่อที่อัปโหลดและแสดงโดยเซิร์ฟเวอร์ RBM
contentInfo

object (ContentInfo)

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

แพลตฟอร์ม RBM จะแสดงเนื้อหาจากแคช แต่ตัวแทนสามารถบังคับให้แพลตฟอร์ม RBM ดึงข้อมูลเนื้อหาเวอร์ชันใหม่และรีเฟรชแคชได้

ContentInfo

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

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

string

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

string

(ไม่บังคับสำหรับไฟล์ภาพ เสียง และวิดีโอเท่านั้น) URL ที่เข้าถึงได้แบบสาธารณะของภาพปก ขนาดสูงสุด 100 KB

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

boolean

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

Media.Height

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

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

คำแนะนำ

การตอบกลับที่แนะนำหรือการดําเนินการที่แนะนําซึ่งรวมอยู่ในการ์ดริชมีเดียหรือภายในรายการชิปคําแนะนํา

การแสดง JSON 
{

  // 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.
}
ช่อง
ฟิลด์สหภาพ option การตอบกลับที่แนะนำหรือการดําเนินการที่แนะนํา option ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
reply

object (SuggestedReply)

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

object (SuggestedAction)

ผู้ใช้สามารถแตะการดําเนินการที่แนะนําเพื่อเริ่มการดําเนินการแบบเนทีฟที่เกี่ยวข้องในอุปกรณ์

SuggestedReply

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

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

string

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

string

เพย์โหลดที่เข้ารหัสฐาน 64 ที่ Agent ได้รับในเหตุการณ์ของผู้ใช้เมื่อผู้ใช้แตะการตอบกลับที่แนะนำ

SuggestedAction

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

การแสดง JSON 
{
  "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)
  },
  "composeAction": {
    object (ComposeAction)
  }
  // End of list of possible types for union field action.
}
ช่อง
text

string

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

string

เพย์โหลด (ที่เข้ารหัส Base64) ที่ส่งไปยังตัวแทนในเหตุการณ์ของผู้ใช้ซึ่งเกิดขึ้นเมื่อผู้ใช้แตะการดําเนินการที่แนะนํา ยาวไม่เกิน 2,048 อักขระ
fallbackUrl

string

(ไม่บังคับ) URL สำรองที่จะใช้ในกรณีที่ไคลเอ็นต์ไม่รองรับการดำเนินการที่แนะนำ URL สำรองจะเปิดในหน้าต่างเบราว์เซอร์ใหม่ ต้องเป็น URI ที่ถูกต้องตามที่ระบุไว้ใน RFC 3986 ยาวไม่เกิน 2,048 อักขระ
ฟิลด์สหภาพ action การดำเนินการแบบเนทีฟที่เริ่มต้นในอุปกรณ์เมื่อผู้ใช้แตะการดำเนินการที่แนะนำ action จะเป็นได้เพียงอย่างใดอย่างหนึ่งต่อไปนี้
dialAction

object (DialAction)

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

object (ViewLocationAction)

เปิดแอปแผนที่เริ่มต้นของผู้ใช้และเลือกสถานที่ที่ตัวแทนระบุ หรือค้นหารอบๆ สถานที่ตั้งของผู้ใช้ตามคำค้นหาที่ตัวแทนระบุ
createCalendarEventAction

object (CreateCalendarEventAction)

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

object (OpenUrlAction)

เปิดแอปเว็บเบราว์เซอร์เริ่มต้นของผู้ใช้ไปยัง URL ที่ระบุ หากผู้ใช้ติดตั้งแอปที่ลงทะเบียนไว้เป็นเครื่องจัดการเริ่มต้นสำหรับ URL ไว้ แอปนี้จะเปิดขึ้นแทน และระบบจะใช้ไอคอนของแอปนั้นใน UI การดําเนินการที่แนะนํา
shareLocationAction

object (ShareLocationAction)

เปิดเครื่องมือเลือกตำแหน่งของแอป RCS เพื่อให้ผู้ใช้เลือกตำแหน่งที่จะส่งไปยังตัวแทนได้
composeAction

object (ComposeAction)

เขียนและส่งข้อความไปยังปลายทางที่กำหนดไว้ล่วงหน้าโดยแชทบ็อต

DialAction

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

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

string

หมายเลขโทรศัพท์ในรูปแบบ E.164 เช่น +12223334444

ViewLocationAction

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

การแสดง JSON 
{
  "latLong": {
    object (LatLng)
  },
  "label": string,
  "query": string
}
ช่อง
latLong

object (LatLng)

(ไม่บังคับ) ละติจูดและลองจิจูดของสถานที่ที่ระบุ
label

string

(ไม่บังคับ) ป้ายกำกับของหมุดถูกวางที่ละติจูด/ลองจิจูด
query

string

(ไม่บังคับ ใช้ได้เฉพาะในไคลเอ็นต์ Android Messages) ตัวแทนสามารถระบุสตริงการค้นหาแทนการระบุ latLong (และป้ายกำกับได้หากต้องการ) สําหรับแอปแผนที่เริ่มต้นที่รองรับฟังก์ชันการค้นหา (รวมถึง Google Maps) การแตะการดําเนินการที่แนะนํานี้จะทําให้การค้นหาสถานที่ตั้งเป็นศูนย์กลางที่ตําแหน่งปัจจุบันของผู้ใช้ หากคำค้นหามีความเฉพาะเจาะจงมากพอ ตัวแทนจะใช้คำค้นหาดังกล่าวเพื่อเลือกสถานที่ใดก็ได้ในโลก

ตัวอย่างเช่น การตั้งค่าสตริงการค้นหาเป็น "Growing Tree Bank" จะแสดงสถานที่ตั้งของ Growing Tree Bank ทั้งหมดในบริเวณใกล้เคียงของผู้ใช้ การตั้งค่าสตริงการค้นหาเป็น "1600 Amphitheater Parkway, Mountain View, CA 94043" จะเลือกที่อยู่นั้นๆ โดยไม่คำนึงถึงตำแหน่งของผู้ใช้

LatLng

ออบเจ็กต์ที่แสดงคู่ละติจูด/ลองจิจูด ค่านี้จะแสดงเป็นคู่ของค่าคู่เพื่อแสดงองศาละติจูดและลองจิจูด วัตถุนี้ต้องเป็นไปตามมาตรฐาน WGS84 เว้นแต่จะระบุไว้เป็นอย่างอื่น ค่าต้องอยู่ในช่วงมาตรฐาน

การแสดง JSON 
{
  "latitude": number,
  "longitude": number
}
ช่อง
latitude

number

ละติจูด หน่วยเป็นองศา โดยต้องอยู่ในช่วง [-90.0, +90.0]
longitude

number

ลองจิจูดเป็นองศา โดยต้องอยู่ในช่วง [-180.0, +180.0]

CreateCalendarEventAction

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

การแสดง JSON 
{
  "startTime": string,
  "endTime": string,
  "title": string,
  "description": string
}
ช่อง
startTime

string (Timestamp format)

เวลาเริ่มต้นของกิจกรรม

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
endTime

string (Timestamp format)

เวลาสิ้นสุดกิจกรรม

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
title

string

ชื่อกิจกรรม ยาวไม่เกิน 100 อักขระ
description

string

คำอธิบายกิจกรรม สูงสุด 500 อักขระ

OpenUrlAction

เปิดแอปเว็บเบราว์เซอร์เริ่มต้นของผู้ใช้ไปยัง URL ที่ระบุ หากผู้ใช้ติดตั้งแอปที่ลงทะเบียนไว้เป็นเครื่องจัดการเริ่มต้นสำหรับ URL ไว้ แอปนี้จะเปิดขึ้นแทน และระบบจะใช้ไอคอนของแอปนั้นใน UI การดําเนินการที่แนะนํา

การแสดง JSON 
{
  "url": string,
  "application": enum (OpenUrlApplication),
  "webviewViewMode": enum (WebviewViewMode),
  "description": string
}
ช่อง
url

string

URL ต้องเป็น URI ที่ถูกต้องตามที่ระบุไว้ใน RFC 3986 ยาวไม่เกิน 2,048 อักขระ
application

enum (OpenUrlApplication)

URL เปิดแอปพลิเคชัน เบราว์เซอร์ หรือ WebView หากต้องการตรวจสอบว่าอุปกรณ์ของผู้ใช้รองรับโหมด WebView หรือไม่ ให้เรียกใช้การตรวจสอบความสามารถก่อน ดูรายละเอียดได้ในเอกสารประกอบที่ https://developers.google.com/business-communications/rcs-business-messaging/guides/build/capabilities
webviewViewMode

enum (WebviewViewMode)

โหมดดูสําหรับ WebView
description

string

คำอธิบายการช่วยเหลือพิเศษสำหรับ WebView

OpenUrlApplication

ประเภทแอปพลิเคชันเปิด URL

Enum
OPEN_URL_APPLICATION_UNSPECIFIED หากไม่ได้ระบุ ระบบจะใช้เบราว์เซอร์เพื่อเปิด
BROWSER ใช้เบราว์เซอร์เพื่อเปิด URL
WEBVIEW เปิด URL ในหน้าต่างเว็บวิวที่ผสานรวม

WebviewViewMode

ประเภทโหมดมุมมองของ WebView

Enum
WEBVIEW_VIEW_MODE_UNSPECIFIED ไม่ได้ระบุ ต้องระบุโหมดดูเพื่อใช้ WebView
FULL ต้องมีการวางซ้อนแบบเต็มหน้าจอที่มีการสนทนากับแชทบ็อตที่ติดป้ายกำกับไว้ในแถบสถานะ
HALF ต้องใช้การวางซ้อนครึ่งหน้าจอ
TALL ต้องใช้การวางซ้อนหน้าจอ 3 ใน 4 ส่วน

ShareLocationAction

ประเภทนี้ไม่มีช่อง

เปิดเครื่องมือเลือกตำแหน่งของแอป RCS เพื่อให้ผู้ใช้เลือกตำแหน่งที่จะส่งกลับไปยังตัวแทนได้

ComposeAction

เขียนและส่งข้อความไปยังปลายทางที่กำหนดไว้ล่วงหน้าโดยแชทบ็อต หากต้องการตรวจสอบว่าอุปกรณ์ของผู้ใช้รองรับการดำเนินการนี้หรือไม่ ให้เรียกใช้การตรวจสอบความสามารถก่อน ดูรายละเอียดได้ในเอกสารประกอบที่ https://developers.google.com/business-communications/rcs-business-messaging/guides/build/capabilities

การแสดง JSON 
{

  // Union field action can be only one of the following:
  "composeTextMessage": {
    object (ComposeAction.ComposeTextMessage)
  },
  "composeRecordingMessage": {
    object (ComposeAction.ComposeRecordingMessage)
  }
  // End of list of possible types for union field action.
}
ช่อง

ฟิลด์สหภาพ action

action ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
composeTextMessage

object (ComposeAction.ComposeTextMessage)

เขียนและส่งข้อความ
composeRecordingMessage

object (ComposeAction.ComposeRecordingMessage)

เริ่มบันทึกและส่งข้อความเสียงหรือวิดีโอ

ComposeAction.ComposeTextMessage

เขียนและส่งข้อความ

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

string

หมายเลขโทรศัพท์ปลายทางที่แชทบ็อตกรอกไว้ล่วงหน้า
text

string

ร่างเพื่อไปยังช่องข้อความสำหรับส่ง

ComposeAction.ComposeRecordingMessage

เริ่มบันทึกและส่งข้อความเสียงหรือวิดีโอ

การแสดง JSON 
{
  "phoneNumber": string,
  "type": enum (ComposeRecordingActionType)
}
ช่อง
phoneNumber

string

แชทบ็อตที่กรอกหมายเลขโทรศัพท์ปลายทางไว้ล่วงหน้า
type

enum (ComposeRecordingActionType)

ประเภทของการดำเนินการบันทึก

ComposeRecordingActionType

ประเภทของการดำเนินการบันทึกการเขียน

Enum
COMPOSE_RECORDING_ACTION_TYPE_UNSPECIFIED ไม่ได้ระบุ
ACTION_TYPE_AUDIO ประเภทเสียง
ACTION_TYPE_VIDEO ประเภทวิดีโอ

StandaloneCard

การ์ดสแตนด์อโลน

การแสดง JSON 
{
  "cardOrientation": enum (StandaloneCard.CardOrientation),
  "thumbnailImageAlignment": enum (StandaloneCard.ThumbnailImageAlignment),
  "cardContent": {
    object (CardContent)
  }
}
ช่อง
cardOrientation

enum (StandaloneCard.CardOrientation)

การวางแนวของการ์ด
thumbnailImageAlignment

enum (StandaloneCard.ThumbnailImageAlignment)

การจัดแนวตัวอย่างรูปภาพสําหรับการ์ดสแตนด์อโลนที่มีเลย์เอาต์แนวนอน
cardContent

object (CardContent)

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

StandaloneCard.CardOrientation

การวางแนวของการ์ด

Enum
CARD_ORIENTATION_UNSPECIFIED ไม่ได้ระบุ
HORIZONTAL

เลย์เอาต์แนวนอน

หาก object(CardContent) ของริชการ์ดแนวนอนมีช่อง media จะต้องมีช่อง title, description หรือ suggestions[] อย่างน้อย 1 ช่องด้วย
VERTICAL เลย์เอาต์แนวตั้ง

StandaloneCard.ThumbnailImageAlignment

การจัดแนวตัวอย่างรูปภาพสําหรับการ์ดสแตนด์อโลนที่มีเลย์เอาต์แนวนอน

Enum
THUMBNAIL_IMAGE_ALIGNMENT_UNSPECIFIED ไม่ได้ระบุ
LEFT ตัวอย่างไฟล์จะจัดแนวไปทางซ้าย
RIGHT ตัวอย่างไฟล์จะจัดชิดขวา

เมธอด

create

 ส่งข้อความจากตัวแทนถึงผู้ใช้

delete

 เพิกถอนข้อความของตัวแทนที่ส่งแล้วแต่ยังไม่ได้นำส่ง