หน้านี้จะอธิบายถึงวิธีตั้งค่าและตอบกลับคำสั่งเครื่องหมายทับ แอป Google Chat
คำสั่งเครื่องหมายทับเป็นวิธีทั่วไปที่ผู้ใช้เรียกใช้และโต้ตอบกับแท็ก แอป Chat คําสั่งเครื่องหมายทับยังช่วยให้ผู้ใช้ค้นพบและ ใช้ฟีเจอร์สำคัญของแอป Chat
หากต้องการใช้คำสั่งเครื่องหมายทับ ให้ผู้ใช้พิมพ์เครื่องหมายทับ (/
) ตามด้วยคำสั่งข้อความสั้นๆ
เช่น /about
เพื่อดูข้อมูลเกี่ยวกับแอป Chat
ผู้ใช้ค้นหาคำสั่งเครื่องหมายทับที่พร้อมใช้งานได้ด้วยการพิมพ์เครื่องหมายทับลงใน
Google Chat ซึ่งแสดงหน้าต่างแสดงรายการคำสั่งที่ใช้ได้สำหรับ
แอปแชท:
![หน้าต่างคำสั่งเครื่องหมายทับ](https://developers.google.cn/static/workspace/chat/images/slash-command-window.png?authuser=9&hl=th)
เพื่อตัดสินใจว่าคุณควรตั้งค่าคำสั่งเครื่องหมายทับหรือไม่ และเพื่อทำความเข้าใจวิธี ออกแบบการโต้ตอบของผู้ใช้ กําหนดเส้นทางทั้งหมดของผู้ใช้
คำสั่งเครื่องหมายทับที่มีคำตอบส่วนตัว
เมื่อผู้ใช้ส่งข้อความที่มีคำสั่งเครื่องหมายทับ ข้อความจะมีเฉพาะ ที่ผู้ใช้และแอป Chat มองเห็นได้ ถ้า คุณได้กำหนดค่าแอปใน Chat ให้เพิ่มลงในพื้นที่ทำงานแล้ว กับคนหลายคน คุณอาจต้องตอบคําสั่งเครื่องหมายทับ อย่างเป็นส่วนตัว เพื่อให้การโต้ตอบระหว่างผู้ใช้กับ แอป Chat
เช่น ถ้าต้องการดูข้อมูลเกี่ยวกับแอป Chat ที่นักเรียน
ค้นพบในพื้นที่ทำงาน ผู้ใช้สามารถใช้คำสั่งต่างๆ เช่น /about
หรือ /help
เพื่อหลีกเลี่ยงการแจ้งคนอื่นๆ ในพื้นที่ทำงาน
แอปแชทสามารถตอบกลับแบบส่วนตัวโดยมีข้อมูลเกี่ยวกับ
วิธีใช้แอป Chat และรับการสนับสนุน
ข้อกำหนดเบื้องต้น
Node.js
แอป Google Chat ที่เปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ วิธีสร้าง แอป Chat แบบอินเทอร์แอกทีฟที่ใช้บริการ HTTP ให้ทำการเริ่มต้นอย่างรวดเร็วนี้ให้เสร็จสมบูรณ์
Apps Script
แอป Google Chat ที่เปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ วิธีสร้าง แอป Chat แบบอินเทอร์แอกทีฟใน Apps Script โปรดกรอกข้อมูลในการเริ่มต้นอย่างรวดเร็วนี้
Python
แอป Google Chat ที่เปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ วิธีสร้าง แอป Chat แบบอินเทอร์แอกทีฟที่ใช้บริการ HTTP ให้ทำการเริ่มต้นอย่างรวดเร็วนี้ให้เสร็จสมบูรณ์
Java
แอป Google Chat ที่เปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ วิธีสร้าง แอป Chat แบบอินเทอร์แอกทีฟที่ใช้บริการ HTTP ให้ทำการเริ่มต้นอย่างรวดเร็วนี้ให้เสร็จสมบูรณ์
ตั้งค่าคำสั่งเครื่องหมายทับ
ส่วนนี้จะอธิบายวิธีทำตามขั้นตอนต่อไปนี้เพื่อตั้งค่าเครื่องหมายทับ คำสั่ง:
- สร้างชื่อให้คําสั่งเครื่องหมายทับ
- กำหนดค่าคำสั่งเครื่องหมายทับใน Google Chat API
ตั้งชื่อคำสั่งเครื่องหมายทับ
ชื่อของคําสั่งเครื่องหมายทับคือสิ่งที่ผู้ใช้พิมพ์ในข้อความ Chat เพื่อเรียกใช้แอป Chat และใส่คำอธิบายสั้นๆ ด้วย ปรากฏใต้ชื่อ เพื่อแจ้งผู้ใช้เพิ่มเติมเกี่ยวกับวิธีใช้คําสั่ง
![ชื่อและคำอธิบายคำสั่งเครื่องหมายทับ](https://developers.google.cn/static/workspace/chat/images/slash-command-description.png?authuser=9&hl=th)
เมื่อเลือกชื่อและคำอธิบายสำหรับคำสั่งเครื่องหมายทับ ให้พิจารณาถึง คำแนะนำต่อไปนี้
วิธีตั้งชื่อคำสั่งเครื่องหมายทับ
- ใช้คำหรือวลีสั้นๆ ที่สื่อความหมาย และนำไปใช้ได้จริงเพื่อ
เป็นคำสั่งที่ชัดเจนและง่ายสำหรับผู้ใช้ ตัวอย่างเช่น แทนที่จะพูดว่า
/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 ให้ทำตามขั้นตอนต่อไปนี้ ขั้นตอน:
ในคอนโซล Google Cloud ให้คลิกเมนู > API และ บริการ > API ที่เปิดใช้และ บริการ > Google Chat API
คลิกการกำหนดค่า
คลิกเพิ่มคำสั่งเครื่องหมายทับในส่วนคำสั่งเครื่องหมายทับ
ป้อนชื่อ รหัสคำสั่ง และคำอธิบายคำสั่ง
- ชื่อ: ชื่อที่แสดงของคำสั่งและสิ่งที่ผู้ใช้พิมพ์ เพื่อเรียกใช้แอปของคุณ ต้องขึ้นต้นด้วยเครื่องหมายทับ มีได้เฉพาะข้อความเท่านั้น และสามารถ ไม่เกิน 50 อักขระ
- คำอธิบาย: ข้อความที่อธิบายวิธีใช้และจัดรูปแบบ คำสั่ง คำอธิบายมีอักขระได้สูงสุด 50 ตัว
- รหัสคำสั่ง: ตัวเลขตั้งแต่ 1 ถึง 1000 ที่ แอป Chat ใช้เพื่อจดจำคำสั่งเครื่องหมายทับ และแสดงคำตอบ
ไม่บังคับ: หากต้องการให้แอป Chat ตอบกลับ คำสั่งที่มีกล่องโต้ตอบ ให้เลือก ช่องทำเครื่องหมายเปิดกล่องโต้ตอบ
คลิกบันทึก
กำหนดค่าคำสั่งเครื่องหมายทับสำหรับแอป Chat แล้ว
ตอบกลับคำสั่งเครื่องหมายทับ
เมื่อผู้ใช้สร้างข้อความใน Chat ที่มีคําสั่งเครื่องหมายทับ
แอป Chat ของคุณได้รับเหตุการณ์การโต้ตอบ MESSAGE
เพย์โหลดเหตุการณ์มี slashCommand
และ slashCommandMetadata
ออบเจ็กต์ ออบเจ็กต์เหล่านี้มีรายละเอียดเกี่ยวกับคำสั่งที่ใช้ในข้อความ
(รวมถึงรหัสคำสั่ง) เพื่อให้คุณส่งคืนคำตอบที่เหมาะสมได้
![ข้อความส่วนตัวสำหรับ
แอป Cymbal Labs ข้อความจะระบุว่า
แอป Chat สร้างโดย Cymbal Labs และแชร์ลิงก์
ไปยังเอกสารประกอบ และลิงก์สำหรับติดต่อทีมสนับสนุน](https://developers.google.cn/static/workspace/chat/images/private-message.png?authuser=9&hl=th)
/help
เพื่ออธิบายวิธีรับการสนับสนุนโค้ดต่อไปนี้แสดงตัวอย่างของแอป Chat
ที่ตอบกลับคำสั่งเครื่องหมายทับ /about
โดยการจัดการ
เหตุการณ์การโต้ตอบ MESSAGE
รายการและการตรวจจับ
ข้อความมีรหัสคำสั่งที่ตรงกันหรือไม่ หากข้อความประกอบด้วย
รหัสคำสั่ง แอป Chat จะแสดงข้อความส่วนตัวดังนี้
Node.js
Apps Script
Python
Java
ตั้งค่า ABOUT_COMMAND_ID
ด้วยรหัสคำสั่งที่คุณ
ระบุเมื่อคุณ
กำหนดค่าคำสั่งเครื่องหมายทับใน Chat API
หากต้องการทดสอบโค้ดนี้ โปรดดู
ทดสอบฟีเจอร์แบบอินเทอร์แอกทีฟสำหรับแอป Google Chat
หัวข้อที่เกี่ยวข้อง
- ดูตัวอย่างแอปใน Chat ที่ใช้คําสั่งเครื่องหมายทับ
- ส่งข้อความ
- ส่งข้อความส่วนตัว
- เปิดกล่องโต้ตอบแบบอินเทอร์แอกทีฟ