Microsoft Teams

במאמר הזה מוסבר איך לשלב את Microsoft Teams עם Google Security Operations.

תרחישים לדוגמה

השילוב של Microsoft Teams משתמש ביכולות של Google SecOps כדי לתמוך בתרחישים הבאים:

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

  • הפעלת תגובה אינטראקטיבית: אתם יכולים להשתמש בפלייבוקים כדי לשאול משתמשים או מנתחי נתונים שאלות ישירות ב-Teams, ולהפוך פעולות לאוטומטיות על סמך התשובות שלהם.

  • שיתוף פעולה באירועים: יצירה אוטומטית של ערוצים ייעודיים או צ'אטים קבוצתיים לאירועים בעדיפות גבוהה וניהול הגישה של החברים.

  • אימות פעילות המשתמשים: שליחת הודעות ישירות למשתמשים כדי לאשר פעולות כמו התחברות או גישה לקבצים, כדי לעדכן את פרטי הבקשה לפי המשוב שלהם.

  • העשרת ההקשר של המשתמש: אחזור פרופילי משתמשים ומידע על חברות בצוות כדי לזהות תפקידים והרשאות במהלך חקירות.

איך מגדירים את השילוב של Microsoft Teams עם Google Security Operations

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

    מרכז הניהול של מיקרוסופט – רישיונות שחלים על המשתמש ב-Microsoft Teams

  2. אחרי שמוודאים שלמשתמש הרלוונטי יש רישיון, אפשר להתחיל ליצור את האפליקציה ל-Microsoft Teams. קודם צריך לעבור אל Azure Active Directory > App registrations.

    מרכז הניהול של מיקרוסופט – הכרטיסייה App registration (רישום אפליקציה)

  3. לוחצים על רישום חדש ומספקים את הפרטים הבאים:

    • שם לאפליקציית Teams
    • ‫URI של הפניה אוטומטית: "https://localhost"

    חשוב לשמור את ה-URI להפניה אוטומטית במקום כלשהו, כי תצטרכו אותו בהמשך התהליך.

  4. עוברים לדף Overview ומעתיקים את:

    • מזהה האפליקציה (הלקוח): תואם לפרמטר Client ID בהגדרת השילוב
    • מזהה הספרייה (הדייר): תואם לפרמטר Tenant בהגדרות השילוב

    דף הסקירה הכללית של Microsoft Teams במרכז הניהול של מיקרוסופט

  5. מוסיפים את ההרשאות הנדרשות. כל ההרשאות שהוחלו הן "מוענקות" וצריכות להיראות כך:

    הוספת ההרשאות הנדרשות לאפליקציה

    חשוב לתת הסכמת אדמין להרשאות.

  6. עוברים לכרטיסייה Certificates & secrets ומוסיפים סוד לקוח חדש. אחרי שסוד הלקוח נוצר, צריך להעתיק את הנתונים מהעמודה Value. הערך הזה נדרש לפרמטר Client Secret בהגדרות השילוב.

  7. עוברים לדף ההגדרות של Google SecOps SOAR ומזינים את הפרמטרים הבאים:

    • מזהה לקוח
    • סוד לקוח
    • ‫URI של הפניה לכתובת אחרת
    • דייר (tenant)

    מזינים מחרוזת פלייסהולדר לפרמטר Refresh Token ושומרים את ההגדרות.

    הגדרה ראשונית של השילוב עם Microsoft Teams

  8. עוברים לכרטיסייה Cases ופותחים בקשת תמיכה כלשהי. אם אין לכם בקשה, אתם יכולים לדמות אחת.

    סימולציה של מקרה

  9. בוחרים התראה בפנייה ולוחצים על פעולה ידנית.

    חלונית פרטי ההתראה – כפתור הפעולה הידנית

  10. עוברים לשילוב של Microsoft Teams ומפעילים את הפעולה Get Authorization. הפעולה הזו יוצרת קישור שמשמש לאימות באפליקציה.

    קבלת הרשאה לפעולה

  11. כדי לראות את התוצאות, עוברים לכרטיסייה "רשימת הבקשות" ולוחצים על הצגת התוצאות.

    הצגת התוצאות כפתור

    הפלט אמור להיראות כך:

    הצגת פלט התוצאות

  12. לוחצים על הקישור שמופיע בפעולה. חשוב לוודא שאתם מחוברים עם משתמש שמשמש לשילוב הזה. אחרי שפתחתם את הקישור בדפדפן, ראיתם שהוא הפנה אתכם לדף אחר. הדף הזה אמור להיראות כך: https://localhost/?code=0.ATwAylKP1BpbCEeO0…&session_state=a149d18b-4131-4649-8956-2f0d09a98743# Copy everything till "&session_state", לדוגמה: https://localhost/?code=0.ATwAylKP1BpbCEeO0…

  13. מריצים את הפעולה "יצירת טוקן".

    יצירת טוקן פעולה

  14. כדי לראות את התוצאות, עוברים לכרטיסייה Case Wall. בהודעה שתתקבל יופיע טוקן. מעתיקים את טוקן הרענון הזה ומדביקים אותו בפרמטר Refresh Token.

    פעולת קבלת הרשאה – ערך של טוקן רענון

  15. אם הכול בוצע בצורה נכונה, יופיע סימן וי ירוק.

    השלמת הגדרת השילוב עם Microsoft Teams

פרמטרים של שילוב

כדי להגדיר את השילוב, משתמשים בפרמטרים הבאים:

שם הפרמטר סוג ברירת מחדל חובה תיאור
שם המכונה String לא רלוונטי לא שם המכונה שרוצים להגדיר לה את השילוב.
תיאור String לא רלוונטי לא תיאור המכונה.
מזהה לקוח String לא רלוונטי כן לא רלוונטי
המזהה הסודי סיסמה לא רלוונטי כן לא רלוונטי
דייר (tenant) String לא רלוונטי כן לא רלוונטי
רענון הטוקן סיסמה לא רלוונטי כן לא רלוונטי
כתובת URL להפניה אוטומטית String http://localhost לא צריך לציין את כתובת ה-URL להפניה אוטומטית שתשמש לאימות השילוב. ערך ברירת המחדל הוא http://localhost. הפרמטר הזה משפיע על הפעולות "קבלת הרשאה" ו "יצירת אסימון".

איך מגדירים שילובים ב-Google SecOps

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

פעולות

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

המתנה לתשובה

הפעולה ממתינה לתשובה הצפויה בהודעה שצוינה.

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

פרמטרים

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

מציינים את הטקסט של התשובה הצפויה.

אם לא מציינים ערך, הפעולה מפסיקה את הביצוע בכל תשובה.
שיטת ההמתנה DDL

בדיקת התשובה הראשונה

ערכים אפשריים:

  • בדיקת התשובה הראשונה
  • המתנה עד לסיום הזמן הקצוב לתפוגה
 לא

מציינים את שיטת ההמתנה לפעולה.

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

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

ריצה

הפעולה הזו פועלת בכל הישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False

יצירת טוקן

מקבלים טוקן גישה באמצעות כתובת ה-URL להרשאה שהתקבלה בשלב הקודם.

פרמטרים

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

ריצה

הפעולה הזו פועלת בכל הישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_connected נכון/לא נכון is_connected:False

קבלת הרשאה

מריצים את הפעולה ועוברים לכתובת ה-URL שהתקבלה.

פרמטרים

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

ריצה

הפעולה הזו פועלת בכל הישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_connected נכון/לא נכון is_connected:false

קבלת מזהה הצוות

אחזור המאפיינים של צוות ספציפי.

פרמטרים

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

ריצה

הפעולה הזו פועלת בכל הישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False

קבלת פרטי משתמש

אחזור המאפיינים והקשרים של משתמש ספציפי.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שם משתמש String לא רלוונטי כן שם המשתמש ב-Microsoft Teams

ריצה

הפעולה הזו פועלת בכל הישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "isResourceAccount": null,
    "mailNickname": "username.co#EXT#",
    "surname": null,
    "deletedDateTime": null,
    "assignedLicenses": [{
        "skuId": "16ddbbfc-09ea-4de2-b1d7-312db6112d70",
        "disabledPlans": []
    }],
    "userPrincipalName": "username.co#EXT#@tenant.onmicrosoft.com",
    "faxNumber": null,
    "consentProvidedForMinor": null,
    "userType": "Member",
    "officeLocation": null,
    "usageLocation": "IL",
    "city": null,
    "employeeId": null,
    "onPremisesImmutableId": null,
    "preferredLanguage": null,
    "streetAddress": null,
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users/$entity",
    "id": "5e457a85-a705-4b65-8a9f-3a3d2ad7715c",
    "state": null,
    "businessPhones": [],
    "postalCode": null,
    "mail": "john_doe@example.com",
    "onPremisesSamAccountName": null,
    "onPremisesLastSyncDateTime": null,
    "accountEnabled": true,
    "mobilePhone": null,
    "refreshTokensValidFromDateTime": "2018-11-12T13:28:53Z",
    "companyName": null,
    "deviceKeys": [],
    "jobTitle": null,
    "preferredDataLocation": null,
    "showInAddressList": false,
    "department": null,
    "proxyAddresses": ["SMTP:mail"],
    "externalUserStateChangeDateTime": "2018-11-12T13:29:41Z",
    "onPremisesProvisioningErrors": [],
    "legalAgeGroupClassification": null,
    "onPremisesSyncEnabled": null,
    "onPremisesExtensionAttributes": {
        "extensionAttribute4": null,
        "extensionAttribute5": null,
        "extensionAttribute6": null,
        "extensionAttribute7": null,
        "extensionAttribute12": null,
        "extensionAttribute1": null,
        "extensionAttribute2": null,
        "extensionAttribute3": null,
        "extensionAttribute10": null,
        "extensionAttribute11": null,
        "extensionAttribute8": null,
        "extensionAttribute9": null,
        "extensionAttribute14": null,
        "extensionAttribute15": null,
        "extensionAttribute13": null
    },
    "assignedPlans": [{
        "capabilityStatus": "Enabled",
        "servicePlanId":
        "617d9209-3b90-4879-96e6-838c42b2701d",
        "service": "MicrosoftCommunicationsOnline",
        "assignedDateTime": "2018-11-12T13:28:57Z"
    }, {
        "capabilityStatus": "Enabled",
        "servicePlanId": "902b47e5-dcb2-4fdc-858b-c63a90a2bdb9",
        "service": "SharePoint",
        "assignedDateTime": "2018-11-12T13:28:57Z"
    }, {
        "capabilityStatus": "Enabled",
        "servicePlanId": "4fa4026d-ce74-4962-a151-8e96d57ea8e4",
        "service": "TeamspaceAPI",
        "assignedDateTime": "2018-11-12T13:28:57Z"
    }],
    "passwordProfile": null,
    "passwordPolicies": null,
    "externalUserState": "Accepted",
    "otherMails": ["mail"],
    "displayName": "name",
    "imAddresses": [],
    "provisionedPlans": [{
        "capabilityStatus": "Enabled",
        "provisioningStatus": "Success",
        "service": "SharePoint"
    }],
    "createdDateTime": "2018-11-12T13:28:53Z",
    "country": null,
    "onPremisesDistinguishedName": null,
    "onPremisesSecurityIdentifier": null,
    "onPremisesDomainName": null,
    "onPremisesUserPrincipalName": null,
    "givenName": null,
    "ageGroup": null
}

רשימת ערוצים

קבלת הפרטים של כל הערוצים שקיימים בצוות ספציפי.

פרמטרים

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

ריצה

הפעולה הזו פועלת בכל הישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
all_channels_details לא רלוונטי לא רלוונטי

הצגת רשימת הצוותים

אחזור הפרטים של כל הצוותים.

פרמטרים

לפעולה הזו אין פרמטרים של קלט.

ריצה

הפעולה הזו פועלת בכל הישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
teams, טימס, צוותים לא רלוונטי לא רלוונטי
תוצאת JSON
[
    {
        "mailNickname": "Test",
        "classification": null,
        "deletedDateTime": null,
        "renewedDateTime": "2018-11-12T15:03:50Z",
        "onPremisesProvisioningErrors": [],
        "membershipRuleProcessingState": null,
        "preferredLanguage": null,
        "expirationDateTime": null,
        "id": "43b559d5-f63d-47dd-9e6c-b3470b6446ee",
        "theme": null,
        "preferredDataLocation": null,
        "mail": "john_doe@example.com",
        "membershipRule": null,
        "onPremisesLastSyncDateTime": null,
        "description": "Test",
        "securityEnabled": false,
        "proxyAddresses": ["SPO:SPO_eaf75319-582a-46cf-8812-9e787d757c4e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:Test@tenant.onmicrosoft.com"],
        "visibility": "Public",
        "resourceProvisioningOptions": ["Team"],
        "displayName": "Test",
        "groupTypes": ["Unified"],
        "onPremisesSyncEnabled": null,
        "createdDateTime": "2018-11-12T15:03:50Z",
        "resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
        "onPremisesSecurityIdentifier": null,
        "mailEnabled": true
    }, {
        "mailNickname": "user",
        "classification": null,
        "deletedDateTime": null,
        "renewedDateTime": "2018-11-28T13:46:50Z",
        "onPremisesProvisioningErrors": [],
        "membershipRuleProcessingState": null,
        "preferredLanguage": null,
        "expirationDateTime": null,
        "id": "67149c85-7139-4062-bfae-059d18ee7e5d",
        "theme": null,
        "preferredDataLocation": null,
        "mail": "john_doe@example.com",
        "membershipRule": null,
        "onPremisesLastSyncDateTime": null,
        "description": "user",
        "securityEnabled": false, "proxyAddresses": ["SPO:SPO_781470a6-2db5-454d-a8e3-71752b3b829e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:user@tenant.onmicrosoft.com"],
        "visibility": "Public",
        "resourceProvisioningOptions": ["Team"],
        "displayName": "user",
        "groupTypes": ["Unified"],
        "onPremisesSyncEnabled": null,
        "createdDateTime": "2018-11-28T13:46:50Z",
        "resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
        "onPremisesSecurityIdentifier": null,
        "mailEnabled": true
    }

רשימת משתמשים

מקבלים את הפרטים של כל המשתמשים.

פרמטרים

לפעולה הזו אין פרמטרים של קלט.

ריצה

הפעולה הזו פועלת בכל הישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
משתמשים לא רלוונטי לא רלוונטי
תוצאת JSON
[{
    "mailNickname": "Test",
    "classification": null,
    "deletedDateTime": null,
    "renewedDateTime": "2018-11-12T15:03:50Z",
    "onPremisesProvisioningErrors": [],
    "membershipRuleProcessingState": null,
    "preferredLanguage": null,
    "expirationDateTime": null,
    "id": "43b559d5-f63d-47dd-9e6c-b3470b6446ee",
    "theme": null,
    "preferredDataLocation": null,
    "mail": "john_doe@example.com",
    "membershipRule": null,
    "onPremisesLastSyncDateTime": null,
    "description": "Test",
    "securityEnabled": false,
    "proxyAddresses": ["SPO:SPO_eaf75319-582a-46cf-8812-9e787d757c4e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:Test@tenant.onmicrosoft.com"],
    "visibility": "Public",
    "resourceProvisioningOptions": ["Team"],
    "displayName": "Test",
    "groupTypes": ["Unified"],
    "onPremisesSyncEnabled": null,
    "createdDateTime": "2018-11-12T15:03:50Z",
    "resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
    "onPremisesSecurityIdentifier": null,
    "mailEnabled": true
}, {
    "mailNickname": "user",
    "classification": null,
    "deletedDateTime": null,
    "renewedDateTime": "2018-11-28T13:46:50Z",
    "onPremisesProvisioningErrors": [],
    "membershipRuleProcessingState": null,
    "preferredLanguage": null,
    "expirationDateTime": null,
    "id": "67149c85-7139-4062-bfae-059d18ee7e5d",
    "theme": null,
    "preferredDataLocation": null,
    "mail": "john_doe@example.com",
    "membershipRule": null,
    "onPremisesLastSyncDateTime": null,
    "description": "user",
    "securityEnabled": false,
    "proxyAddresses": ["SPO:SPO_781470a6-2db5-454d-a8e3-71752b3b829e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:user@tenant.onmicrosoft.com"],
    "visibility": "Public",
    "resourceProvisioningOptions": ["Team"],
    "displayName": "user",
    "groupTypes": ["Unified"],
    "onPremisesSyncEnabled": null,
    "createdDateTime": "2018-11-28T13:46:50Z",
    "resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
    "onPremisesSecurityIdentifier": null,
    "mailEnabled": true
}]

פינג

בודקים את הקישוריות.

פרמטרים

לפעולה הזו אין פרמטרים של קלט.

ריצה

הפעולה הזו פועלת בכל הישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_connected נכון/לא נכון is_connected:False

שליחת הודעה

לשלוח הודעה לערוץ ספציפי.

פרמטרים

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

ריצה

הפעולה הזו פועלת בכל הישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
[{
    "@odata.context":"https://graph.microsoft.com/beta/$metadata#teams('192c0699-fad2-4d02-88a2-84efd6369894')/channels('19%3Ae3acbb17a8754cae9df724f493b5342f%40thread.tacv2')/messages/$entity",
    "id":"1601372154742",
    "replyToId":null,
    "etag":"1601372154742",
    "messageType":"message",
    "createdDateTime":"2020-09-29T09:35:54.742Z",
    "lastModifiedDateTime":"2020-09-29T09:35:54.742Z",
    "lastEditedDateTime":null,
    "deletedDateTime":null,
    "subject":null,
    "summary":null,
    "chatId":null,
    "importance":"normal",
    "locale":"en-us",
    "webUrl":"https://teams.microsoft.com/l/message/19%3Ae3acbb17a8754cae9df724f493b5342f%40thread.tacv2/1601372154742?groupId=192c0699-fad2-4d02-88a2-84efd6369894&tenantId=d48f52ca-5b1a-4708-8ed0-ebb98a26a46a&createdTime=1601372154742&parentMessageId=1601372154742",
    "policyViolation":null,
    "from":{
        "application":null,
        "device":null,
        "conversation":null,
        "user":{
            "id":"b786d3cf-e97d-4511-b61c-0559e9f4da75",
            "displayName":"u05D2'u05D9u05D9u05DEu05E1 u05D1u05D5u05E0u05D3",
            "userIdentityType":"aadUser"
        }},
    "body":{
        "contentType":"text",
        "content":"Hello there"
    },
    "channelIdentity":{
        "teamId":"192c0699-fad2-4d02-88a2-84efd6369894",
        "channelId":"19:e3acbb17a8754cae9df724f493b5342f@thread.tacv2"
    },
    "attachments":[],
    "mentions":[],
    "reactions":[]
}]

שליחת הודעה למשתמש

שולחים הודעת צ'אט למשתמש ב-Microsoft Teams.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
מזהי משתמשים CSV לא רלוונטי לא

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

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

טקסט

ערכים אפשריים:

  • טקסט
  • HTML

מתוך ישויות ומזהי משתמשים

ערכים אפשריים:

  • מתוך ישויות ומזהי משתמשים
  • מתוך ישויות
  • ממזהי משתמשים

צריך לציין את סוג הבחירה שבה המשתמשים צריכים להשתמש.

אם בוחרים באפשרות "מתוך ישויות ומזהי משתמשים", הפעולה מחפשת גם בישויות רלוונטיות וגם בערכים שצוינו בפרמטרים של "מזהי משתמשים".

אם מציינים את האפשרות "מתוך ישויות", הפעולה פועלת רק עם ישויות רלוונטיות ומתעלמת מהערכים שצוינו בפרמטר "מזהי משתמשים".

אם בוחרים באפשרות "ממזהי משתמשים", הפעולה פועלת רק עם ערכים מ "מזהי משתמשים" והפרמטר "מזהי משתמשים" הופך לחובה.

ריצה

הפעולה הזו פועלת על הישויות הבאות:

  • שם משתמש
  • כתובת אימייל

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "id": "1632820681737",
    "replyToId": null,
    "etag": "1632820681737",
    "messageType": "message",
    "createdDateTime": "2021-09-28T09:18:01.737Z",
    "lastModifiedDateTime": "2021-09-28T09:18:01.737Z",
    "lastEditedDateTime": null,
    "deletedDateTime": null,
    "subject": null,
    "summary": null,
    "chatId": "19:5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75@unq.gbl.spaces",
    "importance": "normal",
    "locale": "en-us",
    "webUrl": null,
    "channelIdentity": null,
    "policyViolation": null,
    "from": {
        "application": null,
        "device": null,
        "user": {
            "id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
            "displayName": "ג'יימס בונד",
            "userIdentityType": "aadUser"
        }
    },
    "body": {
        "contentType": "text",
        "content": "qqq"
    },
    "attachments": [],
    "mentions": [],
    "reactions": []
}
קיר תיקים
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:


אם מדווח קוד הסטטוס 201 ‏ (is_success = true): "נשלחה הודעה בהצלחה למשתמשים הבאים ב-Microsoft Teams:‏ {entity.identifier}."

אם לא נמצא צ'אט אחד עם ישות (is_success = true): "הפעולה לא הצליחה לשלוח הודעה למשתמשים הבאים ב-Microsoft Teams:‏ {entity.identifier}."

אם לא נמצאו כל הצ'אטים עם ישות (is_success = false): "לא נשלחו הודעות למשתמשים שצוינו ב-Microsoft Teams".

הודעה אסינכרונית:

"ממתין לתשובה מהמשתמשים הבאים: {entity.identifier}."

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

אם מדווחת שגיאה קריטית: "שגיאה בביצוע הפעולה 'שליחת הודעה למשתמש'. הסיבה: {0}''.format(error.Stacktrace)

אם הזמן הקצוב לתפוגה נגמר: "שגיאה בביצוע הפעולה 'שליחת הודעה למשתמש'. הסיבה: ההודעות נשלחו, אבל חלף הזמן הקצוב לפעולה בזמן ההמתנה לתשובה מהמשתמשים הבאים: {entity.identifier}." צריך להגדיל את זמן הקצוב לתפוגה ב-IDE ולנסות שוב. הערה: אם תנסו שוב, תישלח הודעה נוספת.

 כללי

יצירת ערוץ

יוצרים ערוץ ב-Microsoft Teams.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שם הצוות String לא רלוונטי כן מציינים את שם הצוות שבו רוצים ליצור את הערוץ.
שם הערוץ String לא רלוונטי כן צריך לציין שם ייחודי לערוץ.
סוג הערוץ DDL

רגילה

ערכים אפשריים:

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

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('c084d2c7-a7e6-47a5-921b-0c32c3ab41d1')/channels/$entity",
    "id": "19:92ce922c1790450fae81f6713dbffbe3@thread.tacv2",
    "createdDateTime": "2021-11-18T11:37:39.8186647Z",
    "displayName": "Architecturea Discussion",
    "description": null,
    "isFavoriteByDefault": false,
    "email": "",
    "webUrl": "https://teams.microsoft.com/l/channel/19%3a92ce922c1790450fae81f6713dbffbe3%40thread.tacv2/Architecturea+Discussion?groupId=c084d2c7-a7e6-47a5-921b-0c32c3ab41d1&tenantId=d48f52ca-5b1a-4708-8ed0-ebb98a26a46a",
    "membershipType": "standard"
}
קיר תיקים
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:


אם מדווח קוד הסטטוס 201 ‏ (is_success = true): "הערוץ '{channel name}' נוצר בהצלחה בצוות '{team name}' ב-Microsoft Teams".

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

אם מדווחת שגיאה קריטית: "Error executing action "Create Channel".‎ הסיבה: {0}''.format(error.Stacktrace)

אם הצוות לא נמצא: "Error executing action "Create Channel".‎ הסיבה: הצוות בשם {team, name} לא נמצא ב-Microsoft Teams.

אם מדווח קוד הסטטוס 400: "שגיאה בביצוע הפעולה 'יצירת ערוץ'. הסיבה: {innerError/message}.

 כללי

מחיקת הערוץ

מחיקת ערוץ ב-Microsoft Teams.

פרמטרים

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

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
קיר תיקים
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:


אם מדווח קוד הסטטוס 204 ‏ (is_success = true): "הערוץ "{channel name}" בצוות "{team name}" נמחק בהצלחה ב-Microsoft Teams".

אם הערוץ לא נמצא (is_success = true): "הערוץ "{channel name}" כבר לא קיים בצוות "{team name}" ב-Microsoft Teams".

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

אם מדווחת שגיאה קריטית: "שגיאה בביצוע הפעולה 'מחיקת ערוץ'. הסיבה: {0}''.format(error.Stacktrace)

אם הצוות לא נמצא: "שגיאה בביצוע הפעולה 'מחיקת ערוץ'. הסיבה: הצוות בשם {team, name} לא נמצא ב-Microsoft Teams.

כללי

הוספת משתמשים לערוץ

מוסיפים משתמשים לערוץ הפרטי ב-Microsoft Teams.

פרמטרים

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

ריצה

הפעולה הזו פועלת על הישויות הבאות:

  • שם משתמש
  • כתובת אימייל

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
קיר תיקים
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:


אם מדווח קוד הסטטוס 201 לישות אחת (is_success = true): "המשתמשים הבאים נוספו בהצלחה לערוץ "{Channel Name}" מהצוות "{team name}" ב-Microsoft Teams:‏ {entity.identifier}"

אם המשתמש לא נמצא בישות אחת (is_success = true): "הפעולה לא הצליחה למצוא את המשתמשים הבאים ב-Microsoft Teams:‏ {entity.identifier}"

אם מדווח קוד הסטטוס 400 לישות אחת (is_success = true): "הפעולה לא הצליחה להוסיף את המשתמשים הבאים לערוץ "{Channel Name}" מהצוות "{team name}" ב-Microsoft Teams: ‏{entity.identifier}. צריך לוודא שהמשתמשים הם חלק מהצוות "{team name}".

אם המשתמש לא נמצא בכלל (is_success = false): "None of the provided users were found in Microsoft Teams."‎

אם מדווח קוד הסטטוס 400 לכולם (is_success = false): "הפעולה לא הצליחה להוסיף את המשתמשים שצוינו לערוץ "{Channel Name}" מהצוות "{team name}" ב-Microsoft Teams. צריך לוודא שהמשתמשים הם חלק מהצוות "{team name}".

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

אם מדווחת שגיאה קריטית: "Error executing action "Add Users To Channel".‎ הסיבה: {0}''.format(error.Stacktrace)

אם הצוות לא נמצא: "Error executing action "Add Users To Channel".‎ הסיבה: הצוות בשם {team, name} לא נמצא ב-Microsoft Teams.

אם הערוץ לא נמצא: "שגיאה בביצוע הפעולה "הוספת משתמשים לערוץ". הסיבה: הערוץ {channel name} לא נמצא ב-Microsoft Teams.

אם הערך של membershipType הוא לא private בערוץ: "Error executing action "Add Users To Channel".‎ הסיבה: הערוץ {channel name} לא פרטי.

 כללי

הסרת משתמשים מהערוץ

מסירים משתמשים מהערוץ הפרטי ב-Microsoft Teams.

פרמטרים

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

ריצה

הפעולה הזו פועלת על הישויות הבאות:

  • שם משתמש
  • כתובת אימייל (שם משתמש שתואם לביטוי הרגולרי של כתובת אימייל)

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
קיר תיקים
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:


אם מדווח קוד הסטטוס 201 לישות אחת (is_success = true): "המשתמשים הבאים הוסרו בהצלחה מהערוץ "{Channel Name}" מהצוות "{team name}" ב-Microsoft Teams:‏ {entity.identifier}"

אם המשתמש לא חבר בערוץ (is_success = true): "המשתמשים הבאים כבר לא חברים בערוץ "{Channel Name}" מהצוות "{team name}" ב-Microsoft Teams:‏ {entity.identifier}"

אם אף אחד מהמשתמשים לא חבר בערוץ (is_success = true): "אף אחד מהמשתמשים שצוינו לא חבר בערוץ "{Channel Name}" של הצוות "{team name}" ב-Microsoft Teams".

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

אם מדווחת שגיאה קריטית: "שגיאה בביצוע הפעולה 'הסרת משתמשים מהערוץ'. הסיבה: {0}''.format(error.Stacktrace)

אם הצוות לא נמצא: "שגיאה בביצוע הפעולה 'הסרת משתמשים מהערוץ'. הסיבה: הצוות בשם {team, name} לא נמצא ב-Microsoft Teams.

אם הערוץ לא נמצא: "שגיאה בביצוע הפעולה "הסרת משתמשים מהערוץ". הסיבה: הערוץ {channel name} לא נמצא ב-Microsoft Teams.

אם הערך של membershipType בערוץ הוא לא private: "Error executing action "Remove Users From Channel".‎ הסיבה: הערוץ {channel name} לא פרטי.

 כללי

יצירת צ'אט

יוצרים צ'אט עם משתמש ב-Microsoft Teams.

פרמטרים

לפעולה הזו אין פרמטרים של קלט.

ריצה

הפעולה הזו פועלת על הישויות הבאות:

  • שם משתמש
  • כתובת אימייל (שם משתמש שתואם לביטוי הרגולרי של כתובת אימייל)

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats/$entity",
    "id": "19:b786d3cf-e97d-4511-b61c-0559e9f4da75_cb786032-1ba9-439a-b714-99286e185921@unq.gbl.spaces",
    "topic": null,
    "createdDateTime": "2021-10-13T11:24:15.696Z",
    "lastUpdatedDateTime": "2021-10-13T11:24:15.696Z",
    "chatType": "oneOnOne"
}
קיר תיקים
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם מדווח קוד הסטטוס 201 ‏ (is_success = true): "נוצר בהצלחה צ'אט עם המשתמשים הבאים ב-Microsoft Teams:‏ {entities}"

אם המשתמש לא נמצא (is_success = true): "המשתמשים הבאים לא נמצאו ב-Microsoft Teams:‏ {entities}"

אם לא נמצאו משתמשים (is_success = false): "None of the provided users were found in Microsoft Teams: {entities}"

אם מדווח קוד הסטטוס 400 לישות אחת (is_success = true): "הפעולה לא הצליחה ליצור צ'אט עם המשתמשים הבאים ב-Microsoft Teams:‏ {entities}"

אם מדווח קוד הסטטוס 400 לכל הישויות (is_success = false): "הפעולה לא הצליחה ליצור צ'אט עם המשתמשים שצוינו ב-Microsoft Teams".

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

אם מדווחת שגיאה קריטית: "שגיאה בביצוע הפעולה "יצירת צ'אט". הסיבה: {0}''.format(error.Stacktrace)

 כללי

רשימת הצ'אטים

הצגת רשימה של הצ'אטים הזמינים ב-Microsoft Teams.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
סוג הצ'אט DDL

הכול

ערכים אפשריים:

  • הכול
  • צ'אט קבוצתי
  • הצ'אט של הפגישה
  • צ'אט אישי
 לא ציינו את סוג הצ'אט שאתם רוצים לקבל.
מפתח סינון DDL

יש לבחור טווח

ערכים אפשריים:

  • נושא
  • השם המוצג של החבר/ה
  • אימייל של חבר
 לא מציינים את המפתח שצריך להשתמש בו כדי לסנן צ'אטים.
לוגיקת הסינון DDL

לא צוינה

ערכים אפשריים:

  • לא צוינה
  • שווה
  • מכיל
 לא מציינים את לוגיקת הסינון שרוצים להחיל. לוגיקת הסינון פועלת על סמך הערך שצוין בפרמטר Filter Key (מפתח סינון).
ערך המסנן String לא רלוונטי לא מציינים באיזה ערך להשתמש במסנן. אם בוחרים באפשרות "שווה", הפעולה תנסה למצוא את ההתאמה המדויקת בין התוצאות. אם בוחרים באפשרות "מכיל", הפעולה תנסה למצוא תוצאות שמכילות את מחרוזת המשנה הזו. אם לא מציינים ערך בפרמטר הזה, המסנן לא יופעל. לוגיקת הסינון פועלת על סמך הערך שצוין בפרמטר Filter Key (מפתח סינון).
מספר הרשומות המקסימלי להחזרה מספר שלם 50 לא מציינים את מספר הרשומות שרוצים להחזיר. אם לא צוין ערך, הפעולה תחזיר 50 רשומות.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "id": "19:5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75@unq.gbl.spaces",
    "topic": null,
    "createdDateTime": "2021-04-12T08:36:52.572Z",
    "lastUpdatedDateTime": "2021-09-28T09:31:58.045Z",
    "chatType": "oneOnOne",
    "members@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats('19%3A5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75%40unq.gbl.spaces')/members",
    "members": [
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMember",
            "id": "MCMjZDQ4ZjUyY2EtNWIxYS00NzA4LThlZDAtZWJiOThhMjZhNDZhIyMxOTo1YWY4MWJlYS05YzlmLTRmOWYtODc0NS05ZGYxZmRiYThlMTJfYjc4NmQzY2YtZTk3ZC00NTExLWI2MWMtMDU1OWU5ZjRkYTc1QHVucS5nYmwuc3BhY2VzIyM1YWY4MWJlYS05YzlmLTRmOWYtODc0NS05ZGYxZmRiYThlMTI=",
            "roles": [
                "Owner"
            ],
            "displayName": "yuriy",
            "visibleHistoryStartDateTime": "0001-01-01T00:00:00Z",
            "userId": "5af81bea-9c9f-4f9f-8745-9df1fdba8e12",
            "email": null,
            "tenantId": "d48f52ca-5b1a-4708-8ed0-ebb98a26a46a"
        },
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMember",
            "id": "MCMjZDQ4ZjUyY2EtNWIxYS00NzA4LThlZDAtZWJiOThhMjZhNDZhIyMxOTo1YWY4MWJlYS05YzlmLTRmOWYtODc0NS05ZGYxZmRiYThlMTJfYjc4NmQzY2YtZTk3ZC00NTExLWI2MWMtMDU1OWU5ZjRkYTc1QHVucS5nYmwuc3BhY2VzIyNiNzg2ZDNjZi1lOTdkLTQ1MTEtYjYxYy0wNTU5ZTlmNGRhNzU=",
            "roles": [
                "Owner"
            ],
            "displayName": "ג'יימס בונד",
            "visibleHistoryStartDateTime": "0001-01-01T00:00:00Z",
            "userId": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
            "email": "james.bond@siemplifycyarx.onmicrosoft.com",
            "tenantId": "d48f52ca-5b1a-4708-8ed0-ebb98a26a46a"
        }
    ]
}
קיר תיקים
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם הנתונים זמינים (is_success = true): "נמצאו צ'אטים ב-Microsoft Teams שעומדים בקריטריונים שצוינו".

אם אין נתונים זמינים (is_success=false): "לא נמצאו צ'אטים ב-Microsoft Teams שתואמים לקריטריונים שצוינו".

אם השדה של הפרמטר "ערך הסינון" ריק (is_success=true):

"המסנן לא הופעל כי הפרמטר "ערך המסנן" ריק".

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

אם הפרמטר "מפתח מסנן" מוגדר לערך "בחירה אחת" והפרמטר "לוגיקת מסנן" מוגדר לערך "שווה" או "מכיל":

"שגיאה בהפעלת הפעולה "{action name}". הסיבה: צריך לבחור שדה מהפרמטר "מפתח סינון".

אם צוין ערך לא חוקי בפרמטר "מספר הרשומות המקסימלי להחזרה":

"שגיאה בהפעלת הפעולה "{action name}". הסיבה: "צוין ערך לא חוקי בשדה 'מספר הרשומות המקסימלי להחזרה': . צריך להזין מספר חיובי"."

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

"שגיאה בהפעלת הפעולה "{action name}". הסיבה: {0}''.format(error.Stacktrace)

 כללי
שולחן קיר עם ויטרינה

שם הטבלה: שיחות זמינות

עמודות בטבלה:

  • אינדונזית – id
  • סוג – chatType
  • חברים – קובץ CSV של חברים/תצוגה
  • Names Topic - topic
 כללי

שליחת הודעה בצ'אט

שליחת הודעת צ'אט ב-Microsoft Teams.

פרמטרים

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

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "id": "1632820681737",
    "replyToId": null,
    "etag": "1632820681737",
    "messageType": "message",
    "createdDateTime": "2021-09-28T09:18:01.737Z",
    "lastModifiedDateTime": "2021-09-28T09:18:01.737Z",
    "lastEditedDateTime": null,
    "deletedDateTime": null,
    "subject": null,
    "summary": null,
    "chatId": "19:5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75@unq.gbl.spaces",
    "importance": "normal",
    "locale": "en-us",
    "webUrl": null,
    "channelIdentity": null,
    "policyViolation": null,
    "from": {
        "application": null,
        "device": null,
        "user": {
            "id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
            "displayName": "ג'יימס בונד",
            "userIdentityType": "aadUser"
        }
    },
    "body": {
        "contentType": "text",
        "content": "qqq"
    },
    "attachments": [],
    "mentions": [],
    "reactions": []
}
קיר תיקים
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם מדווח קוד הסטטוס 201 ‏ (is_success = true): "ההודעה נשלחה בהצלחה בצ'אט עם המזהה {Chat ID} ב-Microsoft Teams".

אם התשובה זמינה (is_success = true): "ההודעה נשלחה בהצלחה והתקבלה תשובה בצ'אט עם המזהה {Chat ID} ב-Microsoft Teams".

הודעה אסינכרונית: בהמתנה לתשובה...

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

אם מדווחת שגיאה קריטית: "שגיאה בביצוע הפעולה "שליחת הודעת צ'אט". הסיבה: {0}''.format(error.Stacktrace)

אם מדווח קוד הסטטוס 404: "שגיאה בביצוע הפעולה 'שליחת הודעת צ'אט'. הסיבה: הצ'אט עם המזהה לא נמצא ב-Microsoft Teams.

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

 כללי

שליחת תשובה להודעה

שולחים תשובה להודעה בערוץ ב-Microsoft Teams.

פרמטרים

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

מציינים את סוג התוכן של ההודעה.

ערכים אפשריים:

  • טקסט
  • HTML
טקסט String לא רלוונטי כן מציינים את תוכן ההודעה.

ריצה

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('192c0699-fad2-4d02-88a2-84efd6369894')/channels('19%3A4649fcf41fa5417f9aa78a5840bea442%40thread.tacv2')/messages('1686652339690')/replies/$entity",
"id": "1686653341151",
"replyToId": "1686652339690",
"etag": "1686653341151",
"messageType": "message",
"createdDateTime": "2023-06-13T10:49:01.151Z",
"lastModifiedDateTime": "2023-06-13T10:49:01.151Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": null,
"importance": "normal",
"locale": "en-us",
"webUrl": "https://teams.microsoft.com/l/message/19%3A4649fcf41fa5417f9aa78a5840bea442%40thread.tacv2/1686653341151?groupId=192c0699-fad2-4d02-88a2-84efd6369894&tenantId=d48f52ca-5b1a-4708-8ed0-ebb98a26a46a&createdTime=1686653341151&parentMessageId=1686652339690",
"policyViolation": null,
"eventDetail": null,
"from": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
"displayName": "ג'יימס בונד",
"userIdentityType": "aadUser"
}
},
"body": {
"contentType": "text",
"content": "Reply"
},
"channelIdentity": {
"teamId": "192c0699-fad2-4d02-88a2-84efd6369894",
"channelId": "19:4649fcf41fa5417f9aa78a5840bea442@thread.tacv2"
},
"attachments": [],
"mentions": [],
"reactions": []
}
קיר תיקים
סוג התוצאות ערך/תיאור סוג
הודעת פלט* הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם 201 לאחד (is_success = true):
print "Successfully sent a reply to the message in Microsoft Teams."‎

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:
אם יש שגיאה קריטית:
print "Error executing action "Send Message Reply". Reason: {0}''.format(error.Stacktrace)
אם הצוות לא נמצא:
print "Error executing action "Send Message Reply". הסיבה: הצוות בשם {team name} לא נמצא ב-Microsoft Teams. כדאי לבדוק את האיות.
אם הערוץ לא נמצא:
print "Error executing action "Send Message Reply". הסיבה: הערוץ {channel name} לא נמצא ב-Microsoft Teams. כדאי לבדוק את האיות.
אם התגובה היא "error":
מדפיסים "Error executing action "Send Message Reply". הסיבה: {error.message}.		 כללי

תעסוקה

כדי להגדיר משימות ב-Google SecOps, עוברים אל Response > Job Scheduler.

משימת חידוש של טוקן רענון

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

כברירת מחדל, התוקף של טוקן הרענון פג כל 90 יום, ולכן השילוב לא יהיה שמיש אחרי שהתוקף יפוג. מומלץ להריץ את המשימה הזו כל 7 או 14 ימים כדי לוודא שטוקן הרענון עדכני.

קלט של המשימה

כדי להגדיר את המשימה, משתמשים בפרמטרים הבאים:

פרמטרים
השורש של ה-API להתחברות חובה

שורש ה-API שמשמש לאימות באמצעות פלטפורמת הזהויות של מיקרוסופט.

ערך ברירת המחדל הוא https://login.microsoftonline.com.
הרמה הבסיסית (root) של ה-API חובה

שורש ה-API של המכונה של Microsoft Graph.

ערך ברירת המחדל הוא https://graph.microsoft.com.
סביבות אינטגרציה אופציונלי

סביבות השילוב שבהן המשימה מעדכנת את טוקני הרענון.

הפרמטר הזה מקבל כמה ערכים כמחרוזת מופרדת בפסיקים. צריך לתחום ערכים בודדים במירכאות (" ").

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.