Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

สร้างอินเทอร์เฟซ 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	แอป Chat จะตอบกลับคำสั่ง เช่น ตอบกลับด้วยข้อความหรือเปิดกล่องโต้ตอบ

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

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

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

แอป Chat จะได้รับออบเจ็กต์เหตุการณ์เมื่อทริกเกอร์ Chat เริ่มทำงาน หรือเมื่อผู้ใช้ Chat โต้ตอบกับ UI จากแอป 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 ในแชท รองรับเฉพาะบัตรการให้สิทธิ์พื้นฐาน

ตารางต่อไปนี้แสดงวิธีที่แอป Chat ตอบกลับด้วย การดำเนินการ แอปใน Chat สามารถแสดงออบเจ็กต์ JSON หรือสร้างการตอบกลับโดยใช้ AddOnResponseService ของ Apps Script

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

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

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

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

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

Node.js

async function onEvent(req, res) {
  // Trigger asynchronous job that will respond using the Google Chat API.
  ...

  // Respond with an empty response to the Google Chat platform.
  return res.send({});
};

Python

def on_event(event) -> dict:
  # Trigger asynchronous job that will respond using the Google Chat API.
  ...

  # Respond with an empty response to the Google Chat platform.
  return {}

Java

public String onEvent(JsonNode event) {
  // Trigger asynchronous job that will respond using the Google Chat API.
  ...

  // Respond with an empty response to the Google Chat platform.
  return "{}";
}

Apps Script

function onEvent(event) {
  // Trigger asynchronous job that will respond using the Google Chat API.
  ...

  // Respond with an empty response to the Google Chat platform.
  return null;
}

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