בדף הזה מוסבר איך להגדיר פקודות דרך שורת הפקודות ולהשיב להן אפליקציית Google Chat.
פקודה של לוכסן היא דרך נפוצה שבה משתמשים מפעילים הנחיה אפליקציית Chat. פקודות לוכסן גם עוזרות למשתמשים לגלות להשתמש בתכונות העיקריות של אפליקציית Chat.
כדי להשתמש בפקודה של לוכסן, המשתמשים מקלידים קו נטוי (/
) ואז פקודה של טקסט קצר,
כמו /about
כדי לקבל מידע על אפליקציית Chat.
המשתמשים יכולים לגלות פקודות זמינות של לוכסן על ידי הקלדת לוכסן
ב-Google Chat, שבו מוצג חלון שבו מפורטות הפקודות הזמינות
אפליקציית Chat:
![חלון הפקודה לוכסן](https://developers.google.cn/static/workspace/chat/images/slash-command-window.png?authuser=0000&hl=he)
כדי להחליט אם להגדיר פקודות באמצעות לוכסנים ולהבין איך לעיצוב אינטראקציות של משתמשים, הגדרת כל התהליכים שעוברים המשתמשים.
פקודות דרך שורת הפקודות עם תשובות פרטיות
כשמשתמש שולח הודעה שמכילה פקודה של קו נטוי, ההודעה היא רק יהיו גלויים למשתמש ולאפליקציית Chat. אם המיקום הגדרת שאפליקציית Chat תתווסף למרחבים עם כמה אנשים, כדאי להגיב לפקודה לוכסן באופן פרטי, כדי לשמור על האינטראקציה בין המשתמש אפליקציית Chat.
לדוגמה, כדי ללמוד על אפליקציית Chat שהם
לחפש אותו במרחב, המשתמשים יכולים להשתמש בפקודות כמו /about
או /help
.
כדי לא לשלוח הודעה לכל שאר המשתתפים במרחב המשותף,
אפליקציית Chat יכולה להשיב באופן פרטי עם מידע על
איך משתמשים באפליקציית Chat ומקבלים תמיכה.
דרישות מוקדמות
.Node.js
אפליקציית Google Chat שמופעלת בה תכונות אינטראקטיביות. כדי ליצור להשתמש בשירות HTTP באפליקציית Chat האינטראקטיבית. במדריך למתחילים מוסבר איך עושים את זה.
Apps Script
אפליקציית Google Chat שמופעלת בה תכונות אינטראקטיביות. כדי ליצור כדי להשתמש באפליקציית Chat האינטראקטיבית ב-Apps Script, צריך להשלים את המדריך למתחילים.
Python
אפליקציית Google Chat שמופעלת בה תכונות אינטראקטיביות. כדי ליצור להשתמש בשירות HTTP באפליקציית Chat האינטראקטיבית. במדריך למתחילים מוסבר איך עושים את זה.
Java
אפליקציית Google Chat שמופעלת בה תכונות אינטראקטיביות. כדי ליצור להשתמש בשירות HTTP באפליקציית Chat האינטראקטיבית. במדריך למתחילים מוסבר איך עושים את זה.
הגדרה של פקודת קו נטוי
בקטע הזה מוסבר איך להגדיר קו נטוי הפקודה:
- יוצרים שם לפקודה של הלוכסן.
- מגדירים את הפקודה בקו נטוי ב-Google Chat API.
בחירת שם לפקודת הלוכסן
השם של פקודה ב-Chat הוא מה שהמשתמשים מקלידים בהודעה ב-Chat כדי להפעיל את אפליקציית Chat. בנוסף, תיאור קצר מופיעה מתחת לשם כדי להציג למשתמשים מידע נוסף על אופן השימוש בפקודה:
![שם ותיאור של פקודה](https://developers.google.cn/static/workspace/chat/images/slash-command-description.png?authuser=0000&hl=he)
כשבוחרים שם ותיאור לפקודת הלוכסן, כדאי להביא בחשבון את ההמלצות הבאות:
כדי לתת שם לפקודה של הלוכסן:
- השתמשו במילים או בביטויים קצרים, תיאוריים ומעשיים, כדי
פקודות ברורות ופשוטות למשתמש. לדוגמה, במקום לומר
/createAReminder
, שימוש ב-/remindMe
. - אם הפקודה מכילה יותר ממילה אחת, כדאי לעזור למשתמשים לקרוא אותה.
על ידי שימוש באותיות קטנות במילה הראשונה ואז שימוש באותיות רישיות
מכתב עם מילים נוספות. לדוגמה, במקום
/updatecontact
, להשתמש ב-/updateContact
. - כדאי לשקול אם להשתמש בשם ייחודי או בשם נפוץ לפקודה. אם המיקום
שמתארת אינטראקציה או תכונה טיפוסית, אפשר להשתמש
שם נפוץ שהמשתמשים מזהים ומצפים, כמו
/settings
או/feedback
. אחרת, נסו להשתמש בשמות פקודות ייחודיים, כי אם שם הפקודה זהה באפליקציות צ'אט אחרות, המשתמש לסנן באמצעות פקודות דומות כדי למצוא את הפקודה שלכם ולהשתמש בה.
- השתמשו במילים או בביטויים קצרים, תיאוריים ומעשיים, כדי
פקודות ברורות ופשוטות למשתמש. לדוגמה, במקום לומר
כדי לתאר את הפקודה של הלוכסן:
- התיאור צריך להיות קצר וברור כדי שהמשתמשים ידעו למה לצפות כשהוא מפעיל את הפקודה.
- חשוב ליידע את המשתמשים אם יש דרישות פורמט כלשהן לפקודה.
לדוגמה, אם יוצרים פקודת
/remindMe
שמחייבת ארגומנט text, צריך להגדיר את התיאור כך שיהיה משהו כמוRemind me to do [something] at [time]
. - אפשר ליידע את המשתמשים אם אפליקציית Chat משיבה
את כל המשתמשים במרחב, או באופן פרטי למשתמש שהפעיל את הפקודה.
לדוגמה, לפקודה
/about
, אפשר לתאר אותה כך:Learn about this app (Only visible to you)
. כדי להגיב באופן פרטי פקודה של שורת הפקודות, ראו את הקטע מענה באמצעות הודעה פרטית.
איך מגדירים פקודה של שורת הפקודות ב-Google Chat API
כדי ליצור פקודה של שורת הפקודות, צריך לציין מידע על הפקודה ההגדרות של אפליקציית Chat ל-Google Chat API.
כדי להגדיר פקודה של שורת הפקודות ב-Google Chat API: שלבים:
במסוף Google Cloud, לוחצים על 'תפריט'. > ממשקי API ו- שירותים > ממשקי API מופעלים שירותים > Google Chat API
לוחצים על Configuration.
בקטע SlashCommand, לוחצים על Add a לוכסן הפקודה.
מזינים שם, מזהה פקודה ותיאור לפקודה:
- שם: השם המוצג של הפקודה והסוג של המשתמשים כדי להפעיל את האפליקציה. חייב להתחיל בקו נטוי, להכיל רק טקסט ויכול להיות באורך של עד 50 תווים.
- תיאור: הטקסט שמתאר את השימוש ואת הפורמט את הפקודה. האורך המרבי של תיאורים הוא 50 תווים.
- מזהה פקודה: מספר מ-1 עד 1,000 אפליקציית Chat משתמשת בה כדי לזהות את הפקודה "קו נטוי" ולהחזיר תשובה.
אופציונלי: אם רוצים שאפליקציית Chat תגיב על הפקודה עם תיבת הדו-שיח, בוחרים את הפקודה פותחים תיבת דו-שיח.
לוחצים על שמירה.
זהו! מוגדרת עכשיו פקודה באפליקציית Chat.
תשובה לפקודה של קו נטוי
כשמשתמשים יוצרים הודעת Chat שמכילה פקודה של קו נטוי,
אפליקציית Chat מקבלת אירוע אינטראקציה אחד (MESSAGE
).
המטען הייעודי (payload) של האירוע מכיל את הפרמטר slashCommand
ו-slashCommandMetadata
אובייקטים. האובייקטים האלה מכילים פרטים על הפקודה שבה נעשה שימוש בהודעה
(כולל מזהה הפקודה), כדי שתוכלו להחזיר תגובה מתאימה.
![הודעה פרטית עבור
אפליקציית Chat של Cymbal Labs. בהודעה כתוב
אפליקציית Chat נוצרה על ידי Cymbal Labs ויש בה קישור
תיעוד וקישור ליצירת קשר עם צוות התמיכה.](https://developers.google.cn/static/workspace/chat/images/private-message.png?authuser=0000&hl=he)
/help
מסבירה איך לקבל תמיכה.בקוד הבא מוצגת דוגמה לאפליקציית Chat
שעונה לפקודה /about
באמצעות מקש הטעות
MESSAGE
אירועי אינטראקציה וזיהוי
האם ההודעה מכילה את מזהה הפקודה התואם. אם ההודעה מכילה
מזהה הפקודה, אפליקציית Chat תחזיר הודעה פרטית:
Node.js
Apps Script
Python
Java
מגדירים את ABOUT_COMMAND_ID
עם מזהה הפקודה
מצוין כש
הגדרת הפקודה הלוכסן ב-Chat API.
כדי לבדוק את הקוד הזה:
בודקים תכונות אינטראקטיביות באפליקציות של Google Chat.
נושאים קשורים
- הצגת דוגמאות של אפליקציות ל-Chat שמשתמשות בפקודות לוכסן
- איך שולחים הודעה
- איך שולחים הודעות פרטיות
- פתיחת תיבות דו-שיח אינטראקטיביות