Slack הוא כלי נוח ופופולרי שתוכלו לשפר בעזרת הפקודות שלכם, המותאמות לארגון שלכם.

Slack הוא כלי המאפשר לצוותים לתקשר ולשתף פעולה. אחת התכונות המרכזיות שלו היא השימוש בפקודות לוכסן. פקודות אלו מפעילות פעולות או אינטגרציות ספציפיות בתוך הפלטפורמה.

בעוד ש-Slack מספק לך מספר פקודות לוכסן מובנות, אתה יכול ליצור פקודות מותאמות אישית באמצעות ה-API של Slack. לאחר מכן תוכל להגדיר את הפקודה המותאמת אישית לביצוע משימה מסוימת כאשר משתמש מפעיל אותה.

למה ליצור פקודת סלאש מותאמת אישית ב-Slack?

ייתכן שפקודות הלוכסן המובנות של Slack לא יספקו את הצרכים הספציפיים של הצוות או הארגון שלך. על ידי יצירת פקודות נטוי מותאמות אישית, תוכל ליצור חוויה אישית יותר עבור הצוות שלך. זה בתורו מגביר את המעורבות של הצוות.

הגדרת אפליקציית Slack

כדי להמשיך, אתה צריך להיות נוח עם שימוש בסיסי ב-Slack. היכנס לחשבון Slack שלך בדפדפן וצור סביבת עבודה חדשה. אתה תשתמש בסביבת העבודה הזו כדי לבדוק את האפליקציות שלך לפני שתשתמש בהן בסביבת העבודה של הצוות שלך.

פתח כרטיסייה נוספת ונווט אל אתר Slack API.

הקלק על ה צור אפליקציה לַחְצָן. בעמוד הבא שיופיע, בחר באפשרות ליצור אפליקציה מאפס.

instagram viewer

תן שם לאפליקציה ובחר את סביבת העבודה בה האפליקציה תפעל.

לחץ על צור אפליקציה לַחְצָן. פעולה זו תפנה אותך לדף המכיל את המידע הבסיסי על האפליקציה שלך.

בקטע התכונות, נווט אל OAuth והרשאות תכונה ולאחר מכן גלול מטה אל היקפי אסימון בוט. הוסף צ'אט: לכתוב היקף עבור האפליקציה שלך. היקף זה יאפשר לאפליקציה שלך לשלוח הודעות לסביבת העבודה.

גלול למעלה אל אסימוני OAuth עבור סביבת העבודה שלך סעיף, ולחץ על התקן ב-Workspace לַחְצָן.

בעמוד הבא שיופיע, לחץ על להתיר לַחְצָן. פעולה זו תתקין את האפליקציה בסביבת העבודה שלך.

יצירת פקודת Slash מותאמת אישית באמצעות Slack API

לאחר הגדרת אפליקציית Slack, עליך ליצור פקודה מותאמת אישית עבור המשימה שברצונך לבצע. לדוגמה, פקודת נטוי שמחזירה בדיחה למשתמש. נווט אל פקודות סלאש תכונה. הקלק על ה צור פקודה חדשה לַחְצָן.

מלא את פקודה, בקש כתובת אתר, ו תיאור קצר של הפקודה שברצונך ליצור. כתובת ה-Request היא נקודת הקצה שאליה Slack שולח בקשת POST כאשר משתמש מפעיל את הפקודה. השתמש בכתובת אתר מקומית כמציין מיקום; אתה תחליף את כתובת האתר הזו מאוחר יותר.

לחץ על להציל. כאשר אתה שומר, Slack מוסיף טווח פקודות עבור האפליקציה שלך באופן אוטומטי. היקף זה מאפשר לאפליקציה שלך להוסיף קיצורי דרך ופקודות נטוי שאנשים בסביבת העבודה שלך יכולים להשתמש בהן. שינוי ההיקפים יחייב אותך להתקין מחדש את האפליקציה. הקלק על ה להתקין מחדש את האפליקציה שלך לַחְצָן.

בעמוד שמופיע הבא, לחץ על אפשר התקנה מחדש של האפליקציה בסביבת העבודה שלך.

הגדרת ההתנהגות של פקודת Slash

הפעל כל Python IDE. צור סביבה וירטואלית חדשה. צור קובץ Python חדש וקובץ .env חדש. בטרמינל, הפעל את הפקודה הבאה כדי להתקין את הספריות הנדרשות.

pip להתקין python-dotenv בקשות Flask slack-bolt

ה python-dotenv הספרייה תאפשר לך לטעון את משתני הסביבה בקובץ .env. ה בקשות הספרייה מאפשרת לך לבצע בקשות HTTP ו בקבוק מטפל בבקשות HTTP נכנסות ובתגובות החזרה. בריח רפוי מטפל בבקשות Slack נכנסות.

פתח את קובץ ה-.env וצור שני משתני סביבה. תן להם שם BOT_TOKEN ו SIGNING_SECRET בהתאמה. נווט אל אתר Slack API. מתחת לאפליקציה שלך מידע בסיסי העתק את סוד החתימה והשתמש בו כדי לאתחל את המשתנה BOT_TOKEN. נווט אל התכונה OAuth והרשאות והעתק את אסימון OAuth של משתמש הבוט. השתמש בו כדי לאתחל את המשתנה SIGNING_SECRET.

אסימון הבוט הוא מזהה ייחודי המאמת את האפליקציה שלך עם ה-API של Slack בעת ביצוע קריאות API. סוד החתימה מאמת שבקשות נכנסות לאפליקציה שלך מגיעות מ-Slack.

קוד המקור המלא זמין ב-a מאגר GitHub.

ייבא את הספריות והמודולים הנדרשים.

יְבוּא OS
מ pathlib יְבוּא נָתִיב
מ dotenv יְבוּא load_dotenv
יְבוּא בקשות
מ בקבוק יְבוּא Flask, request, jsonify
מ slack_bolt יְבוּא אפליקציה
מ slack_bolt.adapter.flask יְבוּא SlackRequestHandler

צור מופע חדש של יישום Flask.

app = Flask (__name__)

טען את משתני הסביבה מקובץ ה-.env באמצעות ה- load_dotenv() פוּנקצִיָה.

env_path = Path('.') / '.env'
load_dotenv (dotenv_path=env_path)

צור מופע חדש של אפליקציית Slack באמצעות ה אפליקציה מחלקה מספריית slack_bolt.

slack_app = אפליקציה(
 token=os.environ['BOT_TOKEN'],
 signing_secret=os.environ['SIGNING_SECRET']
)

צור פונקציית מטפל במסלול המטפלת בבקשות נכנסות ל- /slack/command נקודת קצה. כאשר נקודת הקצה מקבלת א הודעה בקשה, הוא מנתח את נתוני גוף הבקשה. לאחר מכן הוא בודק אם הפקודה כן /joke. אם כן, זה קורא ל- get_joke() function ומחזיר תגובת JSON ל-Slack עם תוצאת הפקודה.

@app.route("/slack/command", methods=["POST"])
defפקודה():
# נתח את נתוני גוף הבקשה
 data = request.form
# קרא לפונקציה המתאימה בהתבסס על פקודת הלוכסן
אם נתונים["פקודה"] == "/בדיחה":
 הודעה = get_joke()
אַחֵר:
 הודעה = f"פקודה לא חוקית: {נתונים['פקודה']}"
# החזר תגובה ל-Slack
לַחֲזוֹר jsonify({"טֶקסט": הודעה})

צור פונקציה ששולחת בקשת GET אל icanhazdadjoke API כדי לאחזר בדיחה אקראית בפורמט JSON. לאחר מכן הוא מחזיר את הבדיחה כמחרוזת.

defקבל_בדיחה():
 url = " https://icanhazdadjoke.com/"
 כותרות = {"לְקַבֵּל": "application/json"}
 response = requests.get (כתובת אתר, headers=headers, timeout=5)
 joke = response.json()["בדיחה"]
לַחֲזוֹר בדיחה

צור מופע חדש של א SlackRequestHandler אובייקט שיטפל בבקשות נכנסות מ-Slack.

handler = SlackRequestHandler (slack_app)

בדוק אם הסקריפט מופעל ישירות, ואם כן, הפעל את אפליקציית Flask ביציאה 5000.

אם __שם__ == "__רָאשִׁי__":
# הפעל את אפליקציית Flask ביציאה 5000
 app.run (פורט=5000, debug=נָכוֹן)

הפעל את התוכנית כדי להפעיל את השרת הפועל על localhost.

כדי שהתוכנית תתקשר עם Slack, אתה צריך כתובת אתר שהיא יכולה לגשת אליה דרך האינטרנט. הורד והרץ נגרוק. ה תוכנת ngrok מאפשרת לך ליצור כתובת URL ציבורית מאובטחת המעביר תעבורה לשרת אינטרנט הפועל במחשב שלך.

הפעל את הפקודה הבאה כדי לקבל את כתובת האתר הציבורית:

ngrok http 5000

התמונה למטה מציגה את כתובת האתר הציבורית ב-ngrok, מודגשת בלבן.

העתק את כתובת האתר ונווט אל אתר Slack API. הקלק על ה פקודות סלאש תכונה. ערוך את הפקודה /joke והחלף את מציין ה-URL של הבקשה ב-URL הציבורי שלך. הוסף /slack/events בסוף כתובת האתר כדי להצביע על נקודת הקצה שלך.

עבור אל סביבת העבודה שלך, ואז הקלד ושלח את הפקודה /joke. אתה אמור לראות בדיחה בתגובה:

היכרות עם תכונות רפיון אחרות

ל-Slack יש הרבה תכונות להציע מעבר לפקודות Slash. היכרות עם תכונות אלו תאפשר לך להבין כיצד הם פועלים.

לאחר מכן תוכל לחפש דרכים להתאים אותם לדרישות סביבת העבודה שלך. זה יגדיל את הפרודוקטיביות של הצוות שלך.