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

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

ใน Google Chat ส่วนเสริมจะปรากฏต่อผู้ใช้เป็นแอป Google Chat ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมการขยาย Google Chat

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

  • ทริกเกอร์: วิธีต่างๆ ที่ผู้ใช้ Google Chat สามารถเรียกใช้แอป Chat เช่น การเพิ่มแอปไปยังพื้นที่ทำงานหรือส่งข้อความถึงแอป
  • ออบเจ็กต์เหตุการณ์: ข้อมูลที่แอป Chat ได้รับจากทริกเกอร์หรือการโต้ตอบกับ UI
  • การดำเนินการ: วิธีที่แอปแชทตอบสนองต่อการโต้ตอบ เช่น การส่งข้อความหรือแสดงอินเทอร์เฟซผู้ใช้แบบการ์ด
แอป 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 จะต้องตอบกลับภายใน 30 วินาที และการตอบกลับต้องโพสต์ในพื้นที่ทำงานที่มีการโต้ตอบ มิเช่นนั้น แอป Chat จะต้องตั้งค่าการตรวจสอบสิทธิ์และเรียกใช้ Google Chat API เพื่อตอบกลับ

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

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

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

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

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

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

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