כיצד לשלוח הודעות Microsoft Teams עם Python

בשני המקרים, אתה אמור לסיים עם מחברת DataLab עם כל הלוגיקה העסקית שלך מקודדת:

3. שליחת הודעה ל-Teams

אז, webhook ל-Teams: בדוק. לוגיקה עסקית: בדוק. כדי לשלב את מחברת הפייתון עם Microsoft Teams, אנחנו צריכים לעשות שני דברים: לאחסן את כתובת ה-URL של ה-webhook במחברת ה-DataLab ולכתוב קוד פייתון כדי לשלוח הודעה לערוץ ה-Teams.

אחסן את כתובת ה-URL של ה-webhook

מחברת הפייתון שלנו צריכה את כתובת ה-URL של ה-webhook כדי לשלוח את ההודעה לערוץ ה-Teams הנכון. תוכל פשוט להעתיק ולהדביק את כתובת ה-URL הזו בתוך תא קוד במחברת שלך. עם זאת, זו גישה לא מאובטחת ולא מומלצת. כתובת ה-URL של ה-webhook היא סוג של סוד. אם תשתף את המחברת שלך עם מישהו אחר, הם יוכלו לראות את כתובת ה-URL של ה-webhook, והם יוכלו לשלוח ספאם לערוץ ה-Teams שלך!

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

גישה מאובטחת ומדרגית יותר היא לאחסן את אסימון כתובת ה-URL של ה-webhook ב-משתנה סביבה. כאשר תחבר את משתנה הסביבה הזה, הוא יהיה זמין במושב הפייתון שלך. במחברת שלך:

• לחץ על כרטיסיית "סביבה" בצד שמאל
• לחץ על אייקון הפלוס ליד "משתני סביבה"
• בחלון "הוספת משתני סביבה":
• קבע "שם" בתור MS_TEAMS_WEBHOOK_URL
• בשדה "ערך", הדביק את כתובת ה־Webhook שהצלחת לשמור מוקדם יותר.
• קבע את "שם קבוצת משתני הסביבה" בתור "Microsoft Teams" (זה יכול להיות כל דבר, למעשה)

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

import os
webhook_url = os.environ["MS_TEAMS_WEBHOOK_URL"]
print(webhook_url)

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

קוד פייתון לשליחת הודעה ל־Microsoft Teams

עם MS_TEAMS_WEBHOOK_URL המוכנה ומוצבת, ניתן עכשיו לכתוב קוד פייתון שישלח הודעה ל־Teams! לשם כך, נשתמש ב־חבילת pymsteams, שמספקת מעטפת שימושית ל־API המסובכת הזו לשליחת הודעות ל־Teams. בואו נתקן אותה וניביא אותה, בנוסף לחבילת os כדי לקרוא משתני סביבה:

!pip install pymsteams
import pymsteams
import os

לאחר מכן, ניתן ליצור את מה שנקרא 'כרטיס התקשרות' – מילה רפאית להודעה עשירה ב־Teams –, להוסיף טקסט לתוכו ולשלוח אותו:

card = pymsteams.connectorcard(os.environ["MS_TEAMS_WEBHOOK_URL"])
card.text("Hello Teams!")
assert card.send()

הריץ את הקוד הזה! אתה אמור לראות את ההודעה הזו בערוץ:

plaintext
מעולה! זו היתה הודעה דוגמה ללא משמעות, אבל אתה יכול גם ליצור הודעה בהתבסס על התוצאה של הלוגיקה העסקית שלך, כמו שעשינו בתוך הספר הדוגמה:

card = pymsteams.connectorcard(os.environ["MS_TEAMS_WEBHOOK_URL"])
card.title("Weather Forecast")
card.text("\n".join([
    f"Weather for {CITY} in the next three days:",
    f"- Min temperature: {weather_df['temperature_2m'].min()} {unit_temperature}",
    f"- Max temperature: {weather_df['temperature_2m'].max()} {unit_temperature}", 
    f"- Total precipitation: {weather_df['precipitation'].sum():.2f} {unit_prec}"
]))
assert card.send()

עם התוצאה הבאה:

לבסוף, אתה יכול גם להשתמש במשתנה הסביבה DL_WORKBOOK_ID כדי לכלול כפתור שמקשר לספר העבודה שלך במקרה שתרצה לכלול דרך קלה לניווט מטים לספר הDataLab שמפעיל את ההודעה הזו:

card = pymsteams.connectorcard(os.environ["MS_TEAMS_WEBHOOK_URL"])
card.title("Weather Forecast")
card.text("\n".join([
    f"Weather for {CITY} in the next three days:",
    f"- Min temperature: {weather_df['temperature_2m'].min()} {unit_temperature}",
    f"- Max temperature: {weather_df['temperature_2m'].max()} {unit_temperature}", 
    f"- Total precipitation: {weather_df['precipitation'].sum():.2f} {unit_prec}"
]))
card.addLinkButton("View detailed forecast", f"https://www.datacamp.com/datalab/w/{os.environ.get('DL_WORKBOOK_ID', 'invalid')}/edit")
assert card.send()

עם התוצאה הבאה:

ממש נחמד, נכון?!

4. לאוטומט!

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

• בשורת התפריט בחלק העליון, יש ללחוץ על ריצה > לתזמן ריצה
• תצרף את התזמון כפי שתרצה:
• קבע את המחברת לרץ באופן אוטומטי בימית או שבועית. עבור תזמנים שבועיים, בחר ביום והשעה המדויקים.
• שמירת משתמשים של DataCamp שתרצו להיות מודעים בכל פעם שהפנקס מסתיים (בהצלחה או בכשלון). זה מועיל לעשות זאת במקרה של כשלון, כדי שתוכלו להתעמק ולתקן כאשר נוצרת בעיה.

אם מתוכנן כפי שבתמונה למעלה, הפנקס ירוץ ב-9:30 בבוקר בזמן המקומי כל יום, מה שאומר שהודעה תיפרסם בערוץ הטאמס המצויין בכל בוקר.

לאוטומט או לא לאוטומט

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

הנה סיכום בצורת שולחן:

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

מסקנה

הקמת DataLab לשלוח הודעות ל-Microsoft Teams דורשת ניווט דרך מספר מסכים בהתחלה. אבל אחרי שתקבל את כל ההגדרות עם כתובת הוובהוק בDataLab, שליחת הודעה היא רק על ידי הוספת כמה שורות של קוד פייתון – זה

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

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