ตอบสนองต่อคำสั่งด่วนในฐานะแอป Google Chat

เวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์: มีให้ใช้งานในโปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ของ Google Workspace ซึ่งให้สิทธิ์ทดลองใช้ฟีเจอร์บางอย่างก่อนเปิดตัว

หน้านี้จะอธิบายวิธีตั้งค่าและตอบสนองต่อคำสั่งสั้นๆ สำหรับแอป Google Chat

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

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

รูปที่ 1: เมนูการผสานรวมที่มีคำสั่งลัดสำหรับแอปใน Chat

ตั้งค่าคําสั่งสั้นๆ ใน Google Chat API

หากต้องการสร้างคำสั่งสั้นๆ หรืออัปเดตคำสั่งเครื่องหมายทับที่มีอยู่เป็นคำสั่งสั้นๆ คุณต้องระบุข้อมูลเกี่ยวกับคำสั่งในการกำหนดค่าแอป Google Chat สำหรับ Google Chat API

หากต้องการกำหนดค่าคำสั่งสั้นๆ ใน Google Chat API ให้ทำตามขั้นตอนต่อไปนี้

1. ในคอนโซล Google Cloud ให้คลิกเมนู > API และบริการ > API และบริการที่เปิดใช้ > Google Chat API

   ไปที่หน้า Google Chat API

2. คลิกการกําหนดค่า

3. ในส่วนคำสั่ง ให้คลิกเพิ่มคำสั่ง

4. ป้อนรหัส ชื่อ คำอธิบาย และประเภทคำสั่งสำหรับคำสั่ง

   • รหัสคําสั่ง: ตัวเลขตั้งแต่ 1 ถึง 1,000 ที่แอปแชทใช้เพื่อจดจําคําสั่งและแสดงคําตอบ
   • ชื่อ: ชื่อที่แสดงของคําสั่ง ชื่อมีอักขระได้ไม่เกิน 50 ตัวและอาจมีสัญลักษณ์พิเศษ
     • ใช้คำหรือวลีสั้นๆ ที่สื่อความหมายและนำไปใช้ได้จริงเพื่อให้ผู้ใช้เข้าใจคำสั่งได้ชัดเจน เช่น ใช้ อัปเดตรายชื่อติดต่อสำหรับคำสั่งที่แก้ไขระเบียนรายชื่อติดต่อ
   • คําอธิบาย: ข้อความที่อธิบายสิ่งที่คําสั่งทํา คำอธิบายมีความยาวได้ไม่เกิน 50 อักขระและใส่อักขระพิเศษได้
     • เขียนคำอธิบายให้สั้นและชัดเจนเพื่อให้ผู้ใช้ทราบว่าจะเกิดอะไรขึ้นเมื่อเรียกใช้คําสั่ง
     • แจ้งให้ผู้ใช้ทราบว่าแอป Chat จะตอบกลับทุกคนในพื้นที่ทำงานหรือตอบกลับผู้ใช้ที่เรียกใช้คําสั่งเป็นการส่วนตัว เช่น สำหรับคำสั่งสั้นๆ อย่างเกี่ยวกับ คุณอาจอธิบายเป็นดูข้อมูลเกี่ยวกับแอปนี้ (คุณเท่านั้นที่เห็นได้)
   • ประเภทคำสั่ง: เลือกคำสั่งสั้นๆ

5. ไม่บังคับ: หากต้องการให้แอป Chat ตอบสนองต่อคำสั่งด้วยกล่องโต้ตอบ ให้เลือกช่องทำเครื่องหมายเปิดกล่องโต้ตอบ

6. คลิกบันทึก

ตอนนี้คุณกำหนดค่าคำสั่งด่วนสำหรับแอป Chat แล้ว

ตอบสนองต่อคำสั่งสั้นๆ

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

โค้ดต่อไปนี้แสดงตัวอย่างแอป Chat ที่ตอบกลับคําสั่ง Help โดยจัดการAPP_COMMANDเหตุการณ์การโต้ตอบ และตรวจหาว่าเพย์โหลดเหตุการณ์มีรหัสคําสั่งที่ตรงกันหรือไม่ หากเพย์โหลดเหตุการณ์มีรหัสคําสั่ง แอป Chat จะแสดงข้อความส่วนตัวดังนี้

Apps Script

// Handle the APP_COMMAND event type.
function onAppCommand(event) {
  // Executes the command logic based on its ID.
  // Command IDs are set in the Google Chat API configuration.
  switch (event.appCommandMetadata.appCommandId) {
    case HELP_COMMAND_ID:
      return {
        privateMessageViewer: event.user,
        text: 'The Avatar app replies to Google Chat messages.'
      };
  }
}

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

เปลี่ยนคำสั่งเครื่องหมายทับที่มีอยู่เป็นคำสั่งด่วน

หากต้องการแก้ไขคำสั่งเครื่องหมายทับที่มีอยู่ให้เป็นคำสั่งสั้นๆ ให้แก้ไขคำสั่งเครื่องหมายทับใน Google Chat API โดยเปลี่ยนประเภทคำสั่งจากคำสั่งเครื่องหมายทับเป็นคำสั่งสั้นๆ

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

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

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