ส่งข้อความ Google Chat

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

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

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

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

Node.js

ส่วนเสริมของ Google Workspace ที่ขยายความสามารถของ Google Chat หากต้องการสร้าง ให้ทำตามการเริ่มต้นใช้งาน HTTP ฉบับย่อ

Apps Script

ส่วนเสริมของ Google Workspace ที่ขยายความสามารถของ Google Chat หากต้องการสร้าง โปรดทำตามการเริ่มต้นใช้งาน Apps Script อย่างรวดเร็ว

ออกแบบข้อความ

แอปแชทสามารถใส่ข้อมูลต่อไปนี้ในข้อความได้

  • ข้อความที่มีไฮเปอร์ลิงก์ การพูดถึงด้วย @ และอีโมจิ
  • การ์ดอย่างน้อย 1 ใบ ซึ่งอาจปรากฏในข้อความหรือเปิดในหน้าต่างใหม่เป็นกล่องโต้ตอบ
  • วิดเจ็ตเสริมอย่างน้อย 1 รายการ ซึ่งเป็นปุ่มที่ปรากฏหลังข้อความหรือการ์ดในข้อความ

ดูข้อมูลเกี่ยวกับการออกแบบข้อความได้ในเอกสารประกอบของ Google Chat API ต่อไปนี้

ตอบกลับด้วยข้อความ

แอปรับส่งข้อความสามารถตอบกลับด้วยข้อความต่อทริกเกอร์หรือการโต้ตอบต่อไปนี้

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

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

หากต้องการตอบกลับด้วยข้อความ ให้แสดงผลการดำเนินการ DataActions พร้อมออบเจ็กต์ CreateMessageAction ดังนี้

{ "hostAppDataAction": { "chatDataAction": { "createMessageAction": {
  "message": MESSAGE
}}}

แทนที่ MESSAGE ด้วยแหล่งข้อมูลจาก Chat API ของ Message ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของการดำเนินการได้ที่การดำเนินการใน Chat

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

Node.js

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The request object from Google Workspace Add-on.
 * @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.cymbalApp = function cymbalApp(req, res) {
  const chatEvent = req.body.chat;
  // Send an onboarding message when added to a Chat space
  if (chatEvent.addedToSpacePayload) {
    res.json({ hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
      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 onAddedToSpace(event) {
  return { hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
    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 ให้แสดงผลการดำเนินการ DataActions ด้วย UpdateMessageAction ดังที่แสดงในตัวอย่างต่อไปนี้

{ "hostAppDataAction": { "chatDataAction": { "updateMessageAction": {
  "message": MESSAGE
}}}}

แทนที่ MESSAGE ด้วยแหล่งข้อมูลจาก Chat API ของ Message

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของการดำเนินการได้ที่การดำเนินการใน Chat

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

ตอบกลับการโต้ตอบหรือส่งข้อความเชิงรุกโดยใช้ Google Chat API

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

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

หากต้องการส่งข้อความโดยใช้ Chat API คุณต้องตั้งค่าการตรวจสอบสิทธิ์และเรียกใช้เมธอด create() ในทรัพยากร Message ดูขั้นตอนได้ที่หัวข้อส่งข้อความโดยใช้ Google Chat API