ตอบกลับคําสั่งเครื่องหมายทับในรูปแบบแอป Google Chat

หน้านี้จะอธิบายถึงวิธีตั้งค่าและตอบกลับคำสั่งเครื่องหมายทับ แอป Google Chat

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

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

วันที่

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

คำสั่งเครื่องหมายทับที่มีคำตอบส่วนตัว

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

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

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

ตั้งค่าคำสั่งเครื่องหมายทับ

ส่วนนี้จะอธิบายวิธีทำตามขั้นตอนต่อไปนี้เพื่อตั้งค่าเครื่องหมายทับ คำสั่ง:

1. สร้างชื่อให้คําสั่งเครื่องหมายทับ
2. กำหนดค่าคำสั่งเครื่องหมายทับใน Google Chat API

ตั้งชื่อคำสั่งเครื่องหมายทับ

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

วันที่

เมื่อเลือกชื่อและคำอธิบายสำหรับคำสั่งเครื่องหมายทับ ให้พิจารณาถึง คำแนะนำต่อไปนี้

• วิธีตั้งชื่อคำสั่งเครื่องหมายทับ

  • ใช้คำหรือวลีสั้นๆ ที่สื่อความหมาย และนำไปใช้ได้จริงเพื่อ เป็นคำสั่งที่ชัดเจนและง่ายสำหรับผู้ใช้ ตัวอย่างเช่น แทนที่จะพูดว่า /createAReminder ใช้ /remindMe
  • หากคำสั่งของคุณมีคำมากกว่า 1 คำ โปรดช่วยให้ผู้ใช้อ่านคำสั่ง โดยใช้อักษรตัวพิมพ์เล็กทั้งหมดกับคำแรก แล้วตามด้วยตัวพิมพ์ใหญ่ขึ้นต้น ตัวอักษรเพิ่มเติม ตัวอย่างเช่น แทนที่จะเป็น /updatecontact ใช้ /updateContact
  • พิจารณาว่าจะใช้ชื่อเฉพาะหรือชื่อทั่วไปสำหรับคำสั่งของคุณ ถ้า คำสั่งของคุณจะอธิบายการโต้ตอบหรือคุณลักษณะทั่วไป คุณสามารถใช้ ชื่อทั่วไปที่ผู้ใช้รู้จักและคาดหวัง เช่น /settingsหรือ /feedback มิฉะนั้น ให้ลองใช้ชื่อคำสั่งที่ไม่ซ้ำ เพราะถ้า ชื่อคำสั่งเหมือนกับแอป Chat อื่นๆ ผู้ใช้ต้อง กรองด้วยคำสั่งที่คล้ายกันเพื่อค้นหาและใช้คำสั่งของคุณ

• หากต้องการอธิบายคำสั่งเครื่องหมายทับ ให้ทำดังนี้

  • เขียนคำอธิบายให้สั้นและชัดเจนเพื่อให้ผู้ใช้ทราบว่าควรคาดหวังสิ่งใด เมื่อเรียกใช้คำสั่ง
  • แจ้งให้ผู้ใช้ทราบหากมีข้อกําหนดการจัดรูปแบบสําหรับคําสั่งนี้ เช่น หากคุณสร้างคำสั่ง /remindMe ที่ต้องใช้อาร์กิวเมนต์ ข้อความ ให้กำหนดคำอธิบายเป็น Remind me to do [something] at [time]
  • แจ้งให้ผู้ใช้ทราบว่าแอป Chat ตอบกลับ ทุกคนในพื้นที่ทำงาน หรือแบบส่วนตัวสำหรับผู้ใช้ที่เรียกใช้คำสั่ง ตัวอย่างเช่น สำหรับคำสั่งเครื่องหมายทับ /about คุณสามารถอธิบายเป็น Learn about this app (Only visible to you) เพื่อตอบกลับแบบส่วนตัวกับ ดูส่วนตอบกลับด้วยข้อความส่วนตัว

กำหนดค่าคำสั่งเครื่องหมายทับใน Google Chat API

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

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

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

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

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

3. คลิกเพิ่มคำสั่งเครื่องหมายทับในส่วนคำสั่งเครื่องหมายทับ

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

   1. ชื่อ: ชื่อที่แสดงของคำสั่งและสิ่งที่ผู้ใช้พิมพ์ เพื่อเรียกใช้แอปของคุณ ต้องขึ้นต้นด้วยเครื่องหมายทับ มีได้เฉพาะข้อความเท่านั้น และสามารถ ไม่เกิน 50 อักขระ
   2. คำอธิบาย: ข้อความที่อธิบายวิธีใช้และจัดรูปแบบ คำสั่ง คำอธิบายมีอักขระได้สูงสุด 50 ตัว
   3. รหัสคำสั่ง: ตัวเลขตั้งแต่ 1 ถึง 1000 ที่ แอป Chat ใช้เพื่อจดจำคำสั่งเครื่องหมายทับ และแสดงคำตอบ

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

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

กำหนดค่าคำสั่งเครื่องหมายทับสำหรับแอป Chat แล้ว

ตอบกลับคำสั่งเครื่องหมายทับ

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

วันที่

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

// Checks for the presence of a slash command in the message.
if (event.message.slashCommand) {
  // Executes the slash command logic based on its ID.
  // Slash command IDs are set in the Google Chat API configuration.
  switch (event.message.slashCommand.commandId) {
    case ABOUT_COMMAND_ID:
      return res.send({
        privateMessageViewer: event.user,
        text: 'The Avatar app replies to Google Chat messages.'
      });
  }
}

// Checks for the presence of a slash command in the message.
if (event.message.slashCommand) {
  // Executes the slash command logic based on its ID.
  // Slash command IDs are set in the Google Chat API configuration.
  switch (event.message.slashCommand.commandId) {
    case ABOUT_COMMAND_ID:
      return {
        privateMessageViewer: event.user,
        text: 'The Avatar app replies to Google Chat messages.'
      };
  }
}

# Checks for the presence of a slash command in the message.
if "slashCommand" in request_json["message"]:
  # Executes the slash command logic based on its ID.
  # Slash command IDs are set in the Google Chat API configuration.
  if request_json["message"]["slashCommand"]["commandId"] == ABOUT_COMMAND_ID:
    return {
      "privateMessageViewer": request_json["user"],
      "text": 'The Avatar app replies to Google Chat messages.'
    }

// Checks for the presence of a slash command in the message.
if (body.getAsJsonObject("message").has("slashCommand")) {
  // Executes the slash command logic based on its ID.
  // Slash command IDs are set in the Google Chat API configuration.
  JsonObject slashCommand = body.getAsJsonObject("message").getAsJsonObject("slashCommand");
  switch (slashCommand.get("commandId").getAsString()) {
    case ABOUT_COMMAND_ID:
    JsonObject aboutMessage = new JsonObject();
    aboutMessage.addProperty("text", "The Avatar app replies to Google Chat messages.");
    aboutMessage.add("privateMessageViewer", body.getAsJsonObject("user"));
      response.getWriter().write(gson.toJson(aboutMessage));
      return;
  }
}

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

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

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