รับและตอบกลับการโต้ตอบของผู้ใช้

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

หน้านี้อธิบายวิธีดำเนินการต่อไปนี้

  • กำหนดค่าแอปใน Chat เพื่อรับการโต้ตอบ กิจกรรม
  • ประมวลผลเหตุการณ์การโต้ตอบในโครงสร้างพื้นฐาน
  • ตอบกลับเหตุการณ์การโต้ตอบหากเหมาะสม

ข้อกำหนดเบื้องต้น

แอป Google Chat ที่เปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ วิธีสร้าง แอป Chat แบบอินเทอร์แอกทีฟ ทำตามการเริ่มต้นใช้งานอย่างรวดเร็วต่อไปนี้ เกี่ยวกับสถาปัตยกรรมแอปที่คุณต้องการใช้

วิธีการทำงานของเหตุการณ์การโต้ตอบ

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

ตัวอย่างเช่น แอป Chat ใช้เหตุการณ์การโต้ตอบเพื่อทํา ดังต่อไปนี้:

ตัวอย่างเหตุการณ์การโต้ตอบ คำตอบโดยทั่วไปจากแอป Chat
ผู้ใช้เรียกใช้แอป Chat โดย @พูดถึงหรือใช้คำสั่งเครื่องหมายทับ แอป Chat จะประมวลผลสิ่งที่ข้อความพูดกับ สร้างข้อความ เช่น แอป Chat ตอบกลับ คำสั่ง /about พร้อมข้อความอธิบายงานต่างๆ ที่แอป Chat สามารถทำได้
ผู้ใช้เพิ่มแอป Chat ลงใน พื้นที่ทำงาน แอป Chat จะส่งการเริ่มต้นใช้งาน ข้อความซึ่งอธิบายถึงสิ่งที่ทำและวิธีที่ผู้ใช้ในพื้นที่ทํางานจะโต้ตอบด้วยได้ ได้
ผู้ใช้นํา แอป Chat จากพื้นที่ทำงาน แอป Chat จะนำการแจ้งเตือนที่เข้ามาใหม่ออก สำหรับพื้นที่ทำงาน (เช่น การลบ webhook) และยกเลิกการเข้าถึง ที่จัดเก็บข้อมูลภายใน
ผู้ใช้คลิกปุ่มบนการ์ดหรือกล่องโต้ตอบที่ส่งมาจาก แอป Chat แอป Chat จะประมวลผลและจัดเก็บ ข้อมูลที่ผู้ใช้ส่ง หรือแสดงการ์ดหรือกล่องโต้ตอบอื่น

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

รับเหตุการณ์การโต้ตอบของแอป Chat

ส่วนนี้จะอธิบายวิธีรับและประมวลผลเหตุการณ์การโต้ตอบสำหรับ แอป Chat

กําหนดค่าแอปใน Chat เพื่อรับเหตุการณ์การโต้ตอบ

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

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

  1. ในคอนโซล Google Cloud ให้ไปที่หน้า Chat API แล้วคลิก หน้าการกำหนดค่า

    ไปที่หน้าการกำหนดค่า Chat API

  2. ในส่วนฟีเจอร์แบบอินเทอร์แอกทีฟ ให้ตรวจสอบการตั้งค่าและอัปเดตตาม ฟีเจอร์ที่คุณต้องการสร้าง ได้แก่

    ช่อง คำอธิบาย
    ฟังก์ชันการทำงาน ต้องระบุ ชุดของช่องที่ระบุวิธีที่แอปใน Chat จะโต้ตอบกับผู้ใช้ได้
    • รับข้อความแบบ 1:1: ผู้ใช้จะค้นหาและส่งข้อความถึงแอป Chat ได้โดยตรงใน Google Chat
    • เข้าร่วมพื้นที่ทำงานและการสนทนากลุ่ม: ผู้ใช้สามารถเพิ่มแอป Chat ไปยังพื้นที่ทำงานและการสนทนากลุ่มได้
    การตั้งค่าการเชื่อมต่อ ต้องระบุ ปลายทางของแอป Chat คือปลายทางอย่างใดอย่างหนึ่งต่อไปนี้
    • URL ของแอป: ปลายทาง HTTPS ที่โฮสต์การใช้งานแอป Chat
    • โครงการ Apps Script: รหัสการติดตั้งใช้งานสำหรับโครงการ Apps Script ที่ใช้งานแอป Chat
    • ชื่อหัวข้อ Cloud Pub/Sub: หัวข้อ Pub/Sub ที่แอป Chat สมัครรับข้อมูลในฐานะปลายทาง
    • Dialogflow: ลงทะเบียนแอป Chat ที่มีการผสานรวม Dialogflow โปรดดูข้อมูลเพิ่มเติมที่หัวข้อสร้างแอป Google Chat ของ Dialogflow ที่เข้าใจภาษาธรรมชาติ
    คำสั่งเครื่องหมายทับ ไม่บังคับ คำสั่งที่แสดงต่อผู้ใช้ภายใน Google Chat อนุญาตให้ผู้ใช้ดูการดำเนินการหลักสำหรับแอป Chat ของคุณภายใน Google Chat และเลือกการดำเนินการเฉพาะที่ต้องการโต้ตอบด้วย โปรดดูข้อมูลเพิ่มเติมที่หัวข้อตอบกลับคำสั่งเครื่องหมายทับเป็นแอป Chat
    ตัวอย่างลิงก์ ไม่บังคับ รูปแบบ URL ที่แอป Chat รู้จักและให้เนื้อหาเพิ่มเติมเมื่อผู้ใช้ส่งลิงก์ ดูข้อมูลเพิ่มเติมได้ที่ลิงก์แสดงตัวอย่าง
    ระดับการแชร์ ไม่บังคับ ผู้ใช้สูงสุด 5 คนหรือ Google Groups อย่างน้อย 1 กลุ่มที่ดูและติดตั้งแอป Chat ได้ ใช้ช่องนี้เพื่อทดสอบแอป Chat หรือแชร์แอป Chat กับทีมของคุณ โปรดดูข้อมูลเพิ่มเติมที่ทดสอบฟีเจอร์แบบอินเทอร์แอกทีฟ
  3. คลิกบันทึก เมื่อคุณบันทึกแอป Chat คุณสามารถกำหนดค่าแอป Chat ได้ ผู้ใช้ที่ระบุในองค์กร Google Workspace ของคุณ

กำหนดค่าแอป Chat เพื่อรับการโต้ตอบแล้ว กิจกรรมจาก Google Chat

จัดการคำขอเรียกใช้ HTTP กับบริการของคุณซ้ำ

หากคำขอ HTTPS ไปยังบริการของคุณล้มเหลว (เช่น หมดเวลา ทำให้เครือข่ายชั่วคราว หรือรหัสสถานะ HTTPS ที่ไม่ใช่ 2xx) Google Chat อาจลองส่งอีกครั้งบางส่วน ภายในไม่กี่นาที (แต่ไม่รับประกันว่าแน่นอน) ดังนั้น แอป Chat อาจได้รับข้อความเดียวกัน 2-3 ครั้งใน ในบางสถานการณ์ หากคำขอเสร็จสมบูรณ์แต่ส่งคืน เพย์โหลดข้อความ Google Chat จะไม่ลองส่งคำขออีกครั้ง

ประมวลผลหรือตอบสนองต่อเหตุการณ์การโต้ตอบ

ส่วนนี้อธิบายวิธีที่แอปใน Google Chat ประมวลผลและตอบสนองต่อ เหตุการณ์การโต้ตอบ

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

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

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

แผนภาพต่อไปนี้จะแสดงวิธีการ โดยทั่วไปแอป Google Chat จะประมวลผลหรือตอบสนองต่อ เหตุการณ์การโต้ตอบ:

สถาปัตยกรรมวิธีที่แอป Google Chat ประมวลผลเหตุการณ์การโต้ตอบ

ตอบกลับแบบเรียลไทม์

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

ตอบกลับการเข้าร่วมพื้นที่ทำงาน

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

วิธีส่งข้อความเมื่อผู้ใช้เพิ่มแอป Chat พื้นที่ทำงาน ในแอป Chat ตอบสนองต่อ ADDED_TO_SPACE เหตุการณ์การโต้ตอบ เพื่อตอบกลับ ADDED_TO_SPACE เหตุการณ์การโต้ตอบที่มี SMS ใช้รหัสต่อไปนี้

Node.js

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The event object from Chat API.
 * @param {Object} res The response object from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
exports.onMessage = function onMessage(req, res) {
  if (req.method === 'GET' || !req.body.message) {
    res.send(
      'Hello! This function is meant to be used in a Google Chat space.');
  }

  // Send an onboarding message when added to a Chat space
  if (req.body.type === 'ADDED_TO_SPACE') {
    res.json({
      'text': 'Hi, Cymbal at your service. I help you manage your calendar
      from Google Chat. Take a look at your schedule today by typing
      `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To
      learn what else I can do, type `/help`.'
    });
  }
};

Apps Script

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Chat API.
 * @return {Object} Response from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
function onAddToSpace(event) {

  return {
    'text': 'Hi, Cymbal at your service. I help you manage your calendar
    from Google Chat. Take a look at your schedule today by typing
    `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn
    what else I can do, type `/help`.'
  }
}

ตัวอย่างโค้ดแสดงข้อความต่อไปนี้

ตัวอย่างข้อความสำหรับการเริ่มต้นใช้งาน

ตัวอย่างอื่นๆ ของการตอบสนองต่อการโต้ตอบ

วิธีสร้างการตอบสนองแบบพร้อมกันต่อเหตุการณ์การโต้ตอบมีดังนี้ คู่มือ

ตอบกลับแบบไม่พร้อมกัน

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

หากต้องการสร้างข้อความโดยใช้ Chat API โปรดดู สร้างข้อความ สำหรับคำแนะนำในการใช้ เมธอดของ Chat API เพิ่มเติม โปรดดู ภาพรวม Chat API