หน้านี้ได้รับการแปลโดย Cloud Translation API

สร้างอินเทอร์เฟซ Google Chat

หน้านี้จะแสดงภาพรวมของวิธีสร้างอินเทอร์เฟซผู้ใช้ (UI) สำหรับส่วนเสริมของ Google Workspace ที่ขยาย Google Chat

หากต้องการสร้างอินเทอร์เฟซสำหรับแอป Chat คุณต้องใช้คอมโพเนนต์ส่วนเสริมต่อไปนี้

ทริกเกอร์: วิธีที่ผู้ใช้ Google Chat สามารถเรียกใช้ แอปใน Chat เช่น การเพิ่มแอปไปยังพื้นที่ทำงานหรือการส่ง ข้อความไปยังแอป
ออบเจ็กต์เหตุการณ์: ข้อมูลที่แอป Chat ได้รับจากทริกเกอร์หรือการโต้ตอบ UI
การดำเนินการ: วิธีที่แอป Chat สามารถ ตอบสนองต่อการโต้ตอบ เช่น การส่งข้อความหรือการแสดง อินเทอร์เฟซผู้ใช้แบบการ์ด

แอป Chat จะได้รับออบเจ็กต์เหตุการณ์จากทริกเกอร์ "เพิ่มลงในพื้นที่ทำงาน" — **รูปที่ 1**: เมื่อผู้ใช้เพิ่ม แอป Chat ลงในพื้นที่ทำงาน ทริกเกอร์**เพิ่มลงในพื้นที่ทำงาน**จะเริ่มทำงานและส่งออบเจ็กต์เหตุการณ์ หากต้องการ ตอบกลับด้วยข้อความ แอป Chat จะจัดการออบเจ็กต์เหตุการณ์ และแสดงผลการดำเนินการที่สร้างข้อความ

แอป Chat สามารถสร้างและแสดงการ์ดในอินเทอร์เฟซต่อไปนี้ได้

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

ทริกเกอร์

ส่วนนี้อธิบายทริกเกอร์ที่ส่วนเสริมของ Google Workspace ใช้ใน Chat

ทริกเกอร์คือวิธีเฉพาะ ที่ผู้ใช้เรียกใช้แอป Chat โดยใช้ UI ของ Chat เช่น การใช้ @การกล่าวถึงหรือคำสั่งของแอป

ตารางต่อไปนี้แสดงทริกเกอร์ของ Chat, คำอธิบาย และวิธีที่แอป Chat ตอบกลับโดยทั่วไป

ทริกเกอร์	คำอธิบาย	การตอบกลับทั่วไป
เพิ่มไปยังพื้นที่ทำงานแล้ว	ผู้ใช้เพิ่มแอป Chat ลงในพื้นที่ทำงาน หรือ ผู้ดูแลระบบ Google Workspace ติดตั้ง แอป Chat ในพื้นที่ข้อความส่วนตัวสำหรับผู้ใช้ใน องค์กร หากต้องการดูข้อมูลเกี่ยวกับแอปใน Chat ที่ผู้ดูแลระบบติดตั้ง โปรดดูติดตั้งแอปใน Marketplace ลงในโดเมนในเอกสารช่วยเหลือสำหรับผู้ดูแลระบบ Google Workspace	แอป Chat จะส่ง ข้อความเริ่มต้นใช้งานที่อธิบายสิ่งที่แอปทำและวิธีที่ผู้ใช้ในพื้นที่ โต้ตอบกับแอป
ข้อความ	ผู้ใช้โต้ตอบกับแอป Chat ในข้อความด้วยวิธีใดวิธีหนึ่งต่อไปนี้ ส่งข้อความในพื้นที่ข้อความส่วนตัว (DM) ด้วย แอป Chat @พูดถึงแอป Chat ในพื้นที่ประเภทใดก็ได้ ส่งข้อความที่มีลิงก์ที่ตรงกับรูปแบบ URL สำหรับตัวอย่างลิงก์ พิมพ์ข้อความลงในเมนูแบบเลือกหลายรายการของวิดเจ็ต `selectionInput`	แอป Chat จะตอบกลับโดยอิงตามเนื้อหาของ ข้อความ เช่น แอป Chat จะตอบกลับ คำสั่งเครื่องหมายทับ `/about` ด้วยข้อความที่อธิบาย งานที่แอป Chat ทำได้
นำออกจากพื้นที่ทำงานแล้ว	ผู้ใช้จะนำแอป Chat ออกจากพื้นที่ทำงาน หรือ ผู้ดูแลระบบ Google Workspace จะถอนการติดตั้ง แอป Chat สำหรับผู้ใช้ในองค์กร ผู้ใช้จะนำแอปใน Chat ที่ผู้ดูแลระบบติดตั้งออกไม่ได้ หากผู้ใช้เคยติดตั้ง แอป Chat ไว้ก่อนหน้านี้ แอป Chat จะยังคงติดตั้งอยู่ไม่ว่าผู้ดูแลระบบ Google Workspace จะพยายามถอนการติดตั้งหรือไม่ก็ตาม	แอป Chat จะนำการแจ้งเตือนขาเข้าที่กำหนดค่าไว้สำหรับพื้นที่ทำงาน (เช่น การลบ Webhook) และล้างข้อมูลในที่เก็บข้อมูลภายใน แอปแชทไม่สามารถตอบกลับด้วยข้อความ ทริกเกอร์นี้ได้เนื่องจากไม่ได้เป็นสมาชิกของพื้นที่ทำงานอีกต่อไป
คำสั่งแอป	ผู้ใช้ใช้คำสั่งแอป Chat	แอป Chat จะตอบกลับคำสั่ง เช่น ตอบกลับด้วยข้อความหรือเปิดกล่องโต้ตอบ

คุณต้องกำหนดค่าฟังก์ชันเรียกกลับสำหรับทริกเกอร์เหล่านี้โดยใช้ Google Chat API ซึ่งแตกต่างจากส่วนเสริมอื่นๆ ของ Google Workspace โปรดดูคำแนะนำที่หัวข้อกำหนดค่าแอป Google Chat

หากต้องการตอบสนองต่อทริกเกอร์ โปรดดูคำแนะนำต่อไปนี้

ออบเจ็กต์เหตุการณ์

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

ดูข้อมูลเกี่ยวกับการจัดการออบเจ็กต์เหตุการณ์ได้ในคู่มือต่อไปนี้

ดูข้อมูลเกี่ยวกับออบเจ็กต์เหตุการณ์ของส่วนเสริมภายใน Chat และแอปพลิเคชันอื่นๆ ของ Google Workspace ได้ที่ ออบเจ็กต์เหตุการณ์

การดำเนินการในแชท

ส่วนนี้อธิบายวิธีที่แอป Chat ใช้การดำเนินการของส่วนเสริม เพื่อตอบสนองต่อการโต้ตอบของผู้ใช้

หากต้องการตอบกลับด้วยการดำเนินการของส่วนเสริม แอป Chat ต้องตอบกลับภายใน 30 วินาที และต้องโพสต์การตอบกลับในพื้นที่ทำงานที่มีการโต้ตอบ มิฉะนั้น แอป Chat จะต้องตั้งค่าการตรวจสอบสิทธิ์และเรียก Google Chat API เพื่อตอบกลับ

แอปแชทสามารถจัดการและตอบโต้การโต้ตอบได้หลายวิธี ในหลายกรณี แอป Chat จะตอบกลับด้วยข้อความ นอกจากนี้ แอปแชทยังค้นหาข้อมูลบางอย่างจากแหล่งข้อมูล บันทึกข้อมูลออบเจ็กต์เหตุการณ์ หรือทำสิ่งอื่นๆ ได้อีกด้วย ลักษณะการทำงานของการประมวลผลนี้เป็นสิ่งที่กำหนดแอป Google Chat

หากต้องการตอบสนองต่อการโต้ตอบของผู้ใช้ แอป Chat ต้องจัดการออบเจ็กต์เหตุการณ์ที่เกี่ยวข้องและแสดงออบเจ็กต์ JSON อย่างใดอย่างหนึ่งต่อไปนี้

DataActions: สร้างหรืออัปเดต ข้อมูล Google Workspace หากต้องการส่งหรืออัปเดตข้อความ Chat ออบเจ็กต์ต้องมีมาร์กอัปที่กําหนดการเปลี่ยนแปลงMessage ข้อมูล ซึ่งแสดงเป็น chatDataActionMarkup
RenderActions: สร้างหรืออัปเดตกล่องโต้ตอบ หรือให้คำแนะนำในการป้อนข้อมูลสำหรับเมนูแบบหลายตัวเลือก
AuthorizationError: แจ้งให้ผู้ใช้ลงชื่อเข้าใช้หรือตรวจสอบสิทธิ์ในบริการที่อยู่นอก Google โดยใช้การ์ดการให้สิทธิ์ ในแชท รองรับเฉพาะบัตรการให้สิทธิ์พื้นฐาน

การตอบกลับของแอปแชท	การดำเนินการที่จำเป็นในการคืนสินค้า
ส่งหรืออัปเดตข้อความ	`DataActions`
เปิด อัปเดต หรือปิดกล่องโต้ตอบ	`RenderActions`
หากต้องการรวบรวม ข้อมูลจากการ์ดหรือกล่องโต้ตอบ ให้แนะนำรายการที่เลือกโดยอิงตาม สิ่งที่ผู้ใช้พิมพ์ลงในเมนูแบบเลือกหลายรายการ	`RenderActions`
ดูตัวอย่างลิงก์ ในข้อความที่ผู้ใช้ Chat ส่งในพื้นที่ทำงาน	`DataActions`

ตอบกลับโดยใช้ Google Chat API

แอป Chat อาจต้องใช้ Google Chat API เพื่อตอบสนองต่อการโต้ตอบแทนที่จะส่งคืนการดำเนินการของส่วนเสริม เช่น แอป Chat ต้องเรียกใช้ Google Chat API เพื่อทำสิ่งต่อไปนี้

ตอบกลับการโต้ตอบหลังจากผ่านไป 30 วินาที
ทำงานนอกพื้นที่ที่เกิดการโต้ตอบ
ทำงานใน Chat ที่ไม่พร้อมใช้งานเป็นการดำเนินการของส่วนเสริม เช่น แสดงรายการพื้นที่ทำงานที่ผู้ใช้หรือแอป Chat เป็นสมาชิก หรือเพิ่มผู้ใช้ไปยังพื้นที่ทำงาน
ทำงานในนามของผู้ใช้ Chat (ซึ่งต้องมีการ ตรวจสอบสิทธิ์ผู้ใช้)

ดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการเรียกใช้ Chat API ได้ที่ภาพรวมของ Chat API

ทริกเกอร์

ออบเจ็กต์เหตุการณ์

การดำเนินการในแชท

ตอบกลับโดยใช้ Google Chat API

หัวข้อที่เกี่ยวข้อง