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

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

Slack

במאמר הזה מוסבר איך לשלב את Slack עם Google SecOps.

הגדרת Slack לעבודה עם Google Security Operations

כדי להגדיר את Slack כך שיפעל עם Google SecOps, קודם צריך ליצור אפליקציה חדשה:

עוברים אל https://api.slack.com/ ולוחצים על Start Building (מתחילים לבנות).
מזינים את הפרמטרים שם האפליקציה וסביבת עבודה של Slack לפיתוח. לוחצים על יצירת אפליקציה.
עוברים לכרטיסייה OAuth & Permissions וגוללים למטה לקטע Scopes.
מוסיפים את היקפי ההרשאות הבאים. ב-Slack מומלץ להוסיף היקפי הרשאות של טוקן OAuth לבוט, ולא הרשאות משתמש:
- channels:history
- channels:manage
- channels:read
- chat:write
- files:write
- groups:history
- groups:write
- groups:read
- im:read
- im:write
- im:history
- mpim:read
- mpim:history
- mpim:write
- users:read
- users:read.email
הערה: בכל פעם שמוסיפים או מסירים היקפי הרשאות, צריך ליצור מחדש את אסימוני ה-OAuth.
כדי לאפשר אינטראקטיביות של האפליקציה לפעולות כמו 'שליחת הודעה אינטראקטיבית' ו'המתנה לתשובה עם Webhook', צריך להוסיף כתובת URL לבקשה עבור האפליקציה. מידע נוסף זמין במסמך Handling user interaction in your Slack apps בתיעוד של Slack.
גוללים למעלה ולוחצים על התקנת האפליקציה ב-Workspace.
לוחצים על אישור.
מעתיקים אחד מהאסימונים שנוצרו, בהתאם לסוג השימוש שרוצים לעשות – בוט או משתמש.
מגדירים שילוב עם אחד מהאסימונים האלה.

רשת

תפקיד	יציאת ברירת מחדל	כיוון	פרוטוקול
API	ערכים מרובים	להעברת נתונים	apitoken

הגדרת שילוב עם Slack ב-Google SecOps

הוראות מפורטות להגדרת שילוב ב-Google SecOps מופיעות במאמר הגדרת שילובים.

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

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

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

פעולות

הוספת שאלה

תיאור

לשאול שאלה ב-Slack.

פרמטרים

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

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

N/A

בלוק בנייה

תיאור

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

פרמטרים

שם הפרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
שאלה	String	לא רלוונטי	כן	מציינים את הטקסט של השאלה שרוצים להוסיף לבלוק.
לחצני תשובות	String	לא רלוונטי	כן	מציינים את לחצני התשובות שרוצים להוסיף לבלוק.
כתובת URL בסיסית של Siemplify	String	לא רלוונטי	כן	מציינים את כתובת הבסיס של שרת Google SecOps שרוצים להוסיף לבלוק.
מספר פנייה	String	לא רלוונטי	כן	מציינים את מספר הפנייה ב-Google SecOps שרוצים להוסיף לחסימה.
מזהה UUID של טוקן webhook	String	לא רלוונטי	כן	מציינים את ה-UUID של טוקן ה-Webhook כדי לעקוב אחרי התשובה של המשתמש.

דוגמאות לתרחישי שימוש בפלייבוק

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

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

{
  "result": "[{\"type\": \"section\", \"block_id\": \"f99958f1-c1f1-4fdb-bb8b-a382d952d5bd\", \"text\": {\"type\": \"mrkdwn\", \"text\": \"yes?\", \"verbatim\": false}},{\"type\": \"actions\", \"block_id\": \"2850e684-472a-472f-9a32-96294cbe9046\", \"elements\": [{\"type\": \"button\", \"text\": {\"type\": \"plain_text\", \"text\": \"y\"}, \"action_id\": \"y\", \"url\": \"...\"}, {\"type\": \"button\", \"text\": {\"type\": \"plain_text\", \"text\": \"n\"}, \"action_id\": \"n\", \"url\": \"...\"}, {\"type\": \"button\", \"text\": {\"type\": \"plain_text\", \"text\": \"View Case in Siemplify\"}, \"action_id\": \"View Case in Siemplify\", \"url\": \"...\"}]}]"
}

Case Wall

סוג התוצאות	ערך / תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם אבן בניין נוצרת בהצלחה (is_succeed=True): 'Slack block was created successfully.' אם יצירת בלוק Slack נכשלה בגלל שגיאה כללית כלשהי (is_succeed=False): 'יצירת הבלוק נכשלה בגלל השגיאה הבאה: {0}'.format(error text) הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם לא צוינה כתובת URL שמבוססת על webhook בהגדרת השילוב: 'הפעולה לא בוצעה. צריך לציין את פרמטר השילוב Webhook Base URL'. אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "הפעולה 'שליחת הודעה מתקדמת' נכשלה! השגיאה היא {0}".format(exception.stacktrace)	כללי

סוג התוצאות

ערך / תיאור

סוג

הודעת פלט*

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

אם אבן בניין נוצרת בהצלחה (is_succeed=True): 'Slack block was created successfully.'

אם יצירת בלוק Slack נכשלה בגלל שגיאה כללית כלשהי (is_succeed=False): 'יצירת הבלוק נכשלה בגלל השגיאה הבאה: {0}'.format(error text)

הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה:

אם לא צוינה כתובת URL שמבוססת על webhook בהגדרת השילוב: 'הפעולה לא בוצעה. צריך לציין את פרמטר השילוב Webhook Base URL'.

אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "הפעולה 'שליחת הודעה מתקדמת' נכשלה! השגיאה היא {0}".format(exception.stacktrace)

כללי

יצירת ערוץ

תיאור

יצירת ערוץ ב-Slack.

פרמטרים

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

שם הפרמטר

סוג

ערך ברירת המחדל

חובה

תיאור

שם הערוץ

String

לא רלוונטי

כן

מציינים את שם הערוץ.

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

מזהי משתמשים

String

לא רלוונטי

כן

מציינים את המזהים של המשתמשים שרוצים להזמין לערוץ החדש.

דוגמה: U014JDHLW87, ‏ U08544ABC85.

האם פרטי

תיבת סימון

התיבה לא מסומנת

לא

אם האפשרות הזו מופעלת, הפעולה יוצרת ערוץ פרטי.

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

{
    "is_general": "False",
    "name_normalized": "12asd1237712318",
    "is_channel": "True",
    "creator": "U014J4NFQQG",
    "is_member": "True",
    "is_archived": "False",
    "topic": {
        "last_set": "0",
        "value": " ",
        "creator": " "
    },
    "parent_conversation": "None",
    "is_im": "False",
    "is_ext_shared": "False",
    "previous_names": [],
    "last_read": "0000000000.000000",
    "id": "C014S1G6DB4",
    "is_org_shared": "False",
    "pending_connected_team_ids": [],
    "is_pending_ext_shared": "False",
    "is_mpim": "False",
    "is_group": "False",
    "shared_team_ids": ["T013MJHSNCT"],
    "purpose": {
        "last_set": 0,
        "value": " ",
        "creator": " "
    },
    "is_private": "False",
    "is_shared": "False",
    "name": "12asd1237712318",
    "created": "1591194197",
    "pending_shared": [],
    "unlinked": 0,
    "priority": 0
}

Case Wall

סוג התוצאה	ערך / תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם ok== true והפרמטר Private של הפעולה הוא false והפרמטר User IDs ריק (is_success=true): ‪"Successfully created channel {0}".format(name) אם ok== true ופרמטר הפעולה Private הוא true ופרמטר מזהי המשתמשים ריק (is_success=true): 'Successfully created private channel {0}'.format(name)‎ אם ok== true ופרמטר הפעולה Private הוא false ומזהי המשתמשים זמינים (is_success=true): 'Successfully created channel {0} and added {1} users'.format(name, user_ids) אם ok== true ופרמטר הפעולה Private הוא true ומזהי המשתמשים זמינים (is_success=true): "Successfully created private channel {0} and added {1} users".format(name, user_ids) If "ok" == false. בבקשה הראשונה (is_success=false): ‪"Failed to create channel {0}. Reason: {1}".format(name, value of error parameter from response) אם ok == false בבקשה השנייה (is_success=false): ‫"Channel {0} was created, but users were not invited. הסיבה:".format(name, value of error parameter from response) If "ok" == false and error == "user_not_found" (is_success=false): ‪"Failed to add users to channel {0}. Reason: {1} of the specified User IDs does not exist in Slack".format(name, len(errors) from the response) הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מדווחת שגיאה קריטית (פרטי כניסה שגויים, שגיאת חיבור, קריסת פעולה): "שגיאה בהפעלת הפעולה 'יצירת ערוץ'. הסיבה: {0}''.format(error.Stacktrace)	כללי

סוג התוצאה

ערך / תיאור

סוג

הודעת פלט*

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

אם ok== true והפרמטר Private של הפעולה הוא false והפרמטר User IDs ריק (is_success=true):

‪"Successfully created channel {0}".format(name)

אם ok== true ופרמטר הפעולה Private הוא true ופרמטר מזהי המשתמשים ריק (is_success=true): 'Successfully created private channel {0}'.format(name)‎

אם ok== true ופרמטר הפעולה Private הוא false ומזהי המשתמשים זמינים (is_success=true): 'Successfully created channel {0} and added {1} users'.format(name, user_ids)

אם ok== true ופרמטר הפעולה Private הוא true ומזהי המשתמשים זמינים (is_success=true):

"Successfully created private channel {0} and added {1} users".format(name, user_ids)

If "ok" == false. בבקשה הראשונה (is_success=false):

‪"Failed to create channel {0}. Reason: {1}".format(name, value of error parameter from response)

אם ok == false בבקשה השנייה (is_success=false):

‫"Channel {0} was created, but users were not invited. הסיבה:".format(name, value of error parameter from response)

If "ok" == false and error == "user_not_found" (is_success=false):

‪"Failed to add users to channel {0}. Reason: {1} of the specified User IDs does not exist in Slack".format(name, len(errors) from the response)

הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה:

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

כללי

איך מקבלים את היסטוריית השיחות של ערוץ או משתמש

תיאור

קבלת היסטוריית שיחות של משתמש או ערוץ על סמך קריטריונים של קלט שסופק. הפעולה הזו פועלת עם מזהה ערוץ או מזהה משתמש, שאפשר לחפש באמצעות הפעולות List Channels (הצגת רשימת הערוצים) או List User (הצגת רשימת המשתמשים).

פרמטרים

שם הפרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
מזהה ערוץ או מזהה משתמש	String	לא רלוונטי	כן	מציינים את מזהה הערוץ או מזהה המשתמש כדי לאחזר את היסטוריית השיחות.
מסגרת זמן	DDL	בשעה האחרונה ערכים אפשריים: בשעה האחרונה 6 השעות האחרונות 24 השעות האחרונות בשבוע שעבר בחודש שעבר בהתאמה אישית	לא	מציינים מסגרת זמן לתוצאות. אם בוחרים באפשרות 'בהתאמה אישית', צריך לציין גם את הפרמטר 'שעת התחלה'.
שעת ההתחלה	String	לא רלוונטי	לא	מציינים את שעת ההתחלה של התוצאות. הפרמטר הזה הוא חובה אם בוחרים באפשרות 'מותאם אישית' בפרמטר 'מסגרת זמן'. פורמט: ISO 8601. דוגמה: 2021-08-05T05:18:42Z
שעת הסיום	String	לא רלוונטי	לא	מציינים את שעת הסיום של התוצאות. אם לא מספקים ערך ובפרמטר Time Frame (מסגרת זמן) בוחרים באפשרות Custom (התאמה אישית), המערכת משתמשת בזמן הנוכחי. פורמט: ISO 8601. לדוגמה: ‏2021-08-05T05:18:42Z.
מספר הרשומות המקסימלי שיוחזר	מספר שלם	20	לא	מציינים את מספר הרשומות שיוחזרו. אם לא מספקים כלום, הפעולה מחזירה 20 רשומות.

דוגמאות לתרחישי שימוש בפלייבוק

אחזור היסטוריית שיחות כדי לחקור התראות.

הפעלה ב-

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

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

תוצאת סקריפט

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

תוצאת JSON

[
  {
    "bot_id": "B02D9QYM7P0",
    "type": "message",
    "text": "test",
    "user": "U02D1RPLVST",
    "ts": "1665988448.627219",
    "app_id": "A02DDGD942Z",
    "team": "T02CX3N6B0B",
    "bot_profile": {
      "id": "B02D9QYM7P0",
      "deleted": false,
      "name": "Siemplify-test",
      "updated": 1630908872,
      "app_id": "A02DDGD942Z",
      "icons": {
        "image_36": "https://a.slack-edge.com/80588/img/plugins/app/bot_36.png",
        "image_48": "https://a.slack-edge.com/80588/img/plugins/app/bot_48.png",
        "image_72": "https://a.slack-edge.com/80588/img/plugins/app/service_72.png"
      },
      "team_id": "T02CX3N6B0B"
    },
    "blocks": [
      {
        "type": "rich_text",
        "block_id": "JbVUf",
        "elements": [
          {
            "type": "rich_text_section",
            "elements": [
              {
                "type": "text",
                "text": "test"
              }
            ]
          }
        ]
      }
    ]
  }
]

Case Wall

סוג התוצאות	ערך / תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם היסטוריית השיחות נמצאה בהצלחה (is_succeed=True): 'היסטוריית השיחות אוחזרה בהצלחה'. אם השיחה עם המזהה שצוין לא נמצאה (is_succeed=False): "לא נמצאה שיחה עם המזהה שצוין {0}".format(channel_or_user_id) אם נמצאה שיחה עם המזהה שסופק, אבל לא נמצאו הודעות בטווח הזמן שסופק (is_succeed=False): 'נמצאה שיחה עם המזהה {0}, אבל לא נמצאו הודעות בטווח הזמן שסופק'.format(channel_or_user_id) הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "הפעולה 'שליחת הודעה מתקדמת' נכשלה! השגיאה היא {0}".format(exception.stacktrace) אם צוין ערך לא תקין לפרמטר 'מספר הרשומות המקסימלי להחזרה': 'שגיאה בהפעלת הפעולה '{שם הפעולה}'. הסיבה: 'צוין ערך לא תקין לפרמטר 'מספר הרשומות המקסימלי להחזרה': . צריך לציין מספר חיובי'.' אם האפשרות 'בהתאמה אישית' נבחרה לפרמטר 'מסגרת זמן' ולא צוין פרמטר 'שעת התחלה': 'שגיאה בהפעלת הפעולה '{שם הפעולה}'. הסיבה: 'לא צוינה שעת התחלה למסגרת הזמן המותאמת אישית'.	כללי

סוג התוצאות

ערך / תיאור

סוג

הודעת פלט*

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

אם היסטוריית השיחות נמצאה בהצלחה (is_succeed=True): 'היסטוריית השיחות אוחזרה בהצלחה'.

אם השיחה עם המזהה שצוין לא נמצאה (is_succeed=False): "לא נמצאה שיחה עם המזהה שצוין {0}".format(channel_or_user_id)

אם נמצאה שיחה עם המזהה שסופק, אבל לא נמצאו הודעות בטווח הזמן שסופק (is_succeed=False): 'נמצאה שיחה עם המזהה {0}, אבל לא נמצאו הודעות בטווח הזמן שסופק'.format(channel_or_user_id)

הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה:

אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "הפעולה 'שליחת הודעה מתקדמת' נכשלה! השגיאה היא {0}".format(exception.stacktrace)

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

אם האפשרות 'בהתאמה אישית' נבחרה לפרמטר 'מסגרת זמן' ולא צוין פרמטר 'שעת התחלה': 'שגיאה בהפעלת הפעולה '{שם הפעולה}'. הסיבה: 'לא צוינה שעת התחלה למסגרת הזמן המותאמת אישית'.

כללי

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

תיאור

קבלת פרטי משתמש ב-Slack על סמך קריטריוני קלט שסופקו.

פרמטרים

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

שם הפרמטר

סוג

ערך ברירת המחדל

חובה

תיאור

חיפוש לפי

DDL

אימייל

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

אימייל
שם
מזהה

כן

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

ערך המשתמש

String

לא רלוונטי

כן

מציינים את ערך המשתמש שרוצים לחפש.

דוגמאות לתרחישי שימוש בפלייבוק

קבלת פרטי משתמשים כדי לשפר את עיבוד ההתראות ב-Google SecOps.

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

{
  "id": "U043FPEMATG",
  "team_id": "T02CX3N6B0B",
  "name": "example.user",
  "deleted": false,
  "color": "3c989f",
  "real_name": "Example User",
  "tz": "Europe/Europe",
  "tz_label": "Central European Summer Time",
  "tz_offset": 7200,
  "profile": {
    "title": "",
    "phone": "",
    "skype": "",
    "real_name": "Example User",
    "real_name_normalized": "Example User",
    "display_name": "Example User",
    "display_name_normalized": "Example User",
    "fields": null,
    "status_text": "",
    "status_emoji": "",
    "status_emoji_display_info": [],
    "status_expiration": 0,
    "avatar_hash": "gc297456197c",
    "email": "example.user@example.com",
    "first_name": "Example",
    "last_name": "User",
    "image_24": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=24&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-24.png",
    "image_32": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=32&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-32.png",
    "image_48": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=48&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-48.png",
    "image_72": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=72&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-72.png",
    "image_192": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=192&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-192.png",
    "image_512": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=512&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-512.png",
    "status_text_canonical": "",
    "team": "T02CX3N6B0B"
  },
  "is_admin": false,
  "is_owner": false,
  "is_primary_owner": false,
  "is_restricted": false,
  "is_ultra_restricted": false,
  "is_bot": false,
  "is_app_user": false,
  "updated": 1663939355,
  "is_email_confirmed": true,
  "who_can_share_contact_card": "EVERYONE"
}

Case Wall

סוג התוצאות	ערך / תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם פרטי המשתמש נמצאו בהצלחה (is_succeed=True): "פרטי המשתמש אוחזרו בהצלחה". אם לא נמצאו פרטי משתמש על סמך הקריטריונים שסופקו (is_succeed=False): "Failed to find user details based on the provided criteria: Search by: <0> User value: <1>".format(search_by, user_value) אם נמצאו פרטי משתמש לפי שם, ויש יותר מהתאמה אחת (is_succeed=True): "לפי קריטריוני החיפוש שצוינו נמצאו כמה התאמות: חיפוש לפי: <0> ערך משתמש: <1>".format(search_by, user_value) אם המשתמש לא נמצא (is_succeed=False) בגלל שגיאה כללית כלשהי: 'Failed to fetch user details because of occurred error: (0}' (טקסט השגיאה) הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "הפעולה 'שליחת הודעה מתקדמת' נכשלה! השגיאה היא {0}".format(exception.stacktrace)	כללי
Case Wall Table	שם הטבלה: פרטי משתמש ב-Slack עמודות הטבלה: מזהה מזהה הצוות שם שם אמיתי שם לתצוגה שם פרטי שם משפחה שעת העדכון אזור הזמן כותרת טלפון האם הוא אדמין האם הוא הבעלים האם זה הבעלים הראשי מוגבל בהגבלה מחמירה האם מדובר בבוט האם מדובר במשתמש באפליקציה האם כתובת האימייל אושרה	כללי

סוג התוצאות

ערך / תיאור

סוג

הודעת פלט*

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

אם פרטי המשתמש נמצאו בהצלחה (is_succeed=True): "פרטי המשתמש אוחזרו בהצלחה".

אם לא נמצאו פרטי משתמש על סמך הקריטריונים שסופקו (is_succeed=False): "Failed to find user details based on the provided criteria: Search by: <0> User value: <1>".format(search_by, user_value)

אם נמצאו פרטי משתמש לפי שם, ויש יותר מהתאמה אחת (is_succeed=True): "לפי קריטריוני החיפוש שצוינו נמצאו כמה התאמות: חיפוש לפי: <0> ערך משתמש: <1>".format(search_by, user_value)

אם המשתמש לא נמצא (is_succeed=False) בגלל שגיאה כללית כלשהי: 'Failed to fetch user details because of occurred error: (0}' (טקסט השגיאה)

הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה:

כללי

Case Wall Table

שם הטבלה: פרטי משתמש ב-Slack

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

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

כללי

אחזור פרטי משתמש לפי מזהה

תיאור

קבלת פרטי משתמש לפי המזהה שלו.

פרמטרים

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

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

N/A

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

תיאור

מקבלים רשימה של ערוצי Slack.

פרמטרים

לא רלוונטי

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

[
    {
        "is_org_shared": false,
        "is_general": true,
        "name_normalized": "general",
        "name": "general",
        "is_channel": true,
        "created": 1575550599,
        "is_member": true,
        "is_mpim": false,
        "is_archived": false,
        "creator": "URALP6WRJ",
        "topic": {
            "last_set": 1575550599,
            "value": "Company-wide announcements and work-based matters",
            "creator": "URALP6WRJ"
        },
        "num_members": 1,
        "purpose": {
            "last_set": 1575550599,
            "value": "This channel is for workspace-wide communication and announcements. All members are in this channel.",
            "creator": "URALP6WRJ"
        },
        "members": ["URALP6WRJ"],
        "unlinked": 0,
        "is_shared": false,
        "id": "CRB4ZHGNR",
        "is_private": false,
        "previous_names": []
    }, {
        "is_org_shared": false,
        "is_general": false,
        "name_normalized": "random",
        "name": "random",
        "is_channel": true,
        "created": 1575550599,
        "is_member": true,
        "is_mpim": false,
        "is_archived": false,
        "creator": "URALP6WRJ",
        "topic": {
            "last_set": 1575550599,
            "value": "Non-work banter and water cooler conversation",
            "creator": "URALP6WRJ"
        },
        "num_members": 1,
        "purpose": {
            "last_set": 1575550599,
            "value": "A place for non-work-related flimflam, faffing, hodge-podge or jibber-jabber you'd prefer to keep out of more focused work-related channels.",
            "creator": "URALP6WRJ"
        },
        "members": ["URALP6WRJ"],
        "unlinked": 0,
        "is_shared": false,
        "id": "CRD0KF9T9",
        "is_private": false,
        "previous_names": []
    }, {
        "is_org_shared": false,
        "is_general": false,
        "name_normalized": "website",
        "name": "website",
        "is_channel": true,
        "created": 1575550600,
        "is_member": true,
        "is_mpim": false,
        "is_archived": false,
        "creator": "URALP6WRJ",
        "topic": {
            "last_set": 0,
            "value": " ",
            "creator": " "
        },
        "num_members": 1,
        "purpose": {
            "last_set": 0,
            "value": " ",
            "creator": " "
        },
        "members": ["URALP6WRJ"],
        "unlinked": 0,
        "is_shared": false,
        "id": "CRDAUBZP0",
        "is_private": false,
        "previous_names": []
    }
]

Case Wall

סוג התוצאה	ערך / תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם ok == false (is_success=false): 'Failed to list channels. הסיבה: {0}".format(value of error parameter from response)	כללי

סוג התוצאה

ערך / תיאור

סוג

הודעת פלט*

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

אם ok == false (is_success=false): 'Failed to list channels. הסיבה: {0}".format(value of error parameter from response)

כללי

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

תיאור

הפעולה הזו נועדה לקבל רשימה של משתמשי Slack.

פרמטרים

לא רלוונטי

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

[
    {
        "profile": {
            "status_text": " ",
            "display_name": " ",
            "status_emoji": " ",
            "title": " ",
            "status_text_canonical": " ",
            "team": "TRALP6VNY",
            "real_name": "somerealname",
            "image_24": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=24&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-24.png",
            "phone": " ",
            "real_name_normalized": "somerealnamen",
            "image_512": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=512&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-512.png",
            "image_72": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=72&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-72.png",
            "image_32": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=32&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-32.png",
            "image_48": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=48&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-48.png",
            "skype": " ",
            "avatar_hash": "g2d62053d7f7",
            "display_name_normalized": " ",
            "status_expiration": 0,
            "email": "mail@seimplify.co",
            "image_192": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=192&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-192.png"
        },
        "updated": 1575550598,
        "tz": "Europe/Moscow",
        "name": "name",
        "deleted": false,
        "is_app_user": false,
        "is_bot": false,
        "tz_label": "Moscow Time",
        "real_name": "realname",
        "color": "9f69e7",
        "team_id": "TRALP6VNY",
        "is_admin": true,
        "is_ultra_restricted": false,
        "is_restricted": false,
        "is_owner": true,
        "tz_offset": 14400,
        "has_2fa": false,
        "id": "URALP6WRJ",
        "is_primary_owner": true
    }, {
        "profile": {
            "last_name": " ",
            "status_emoji": " ",
            "display_name_normalized": "Slackbot",
            "image_32": "https://a.slack-edge.com/80588/img/slackbot_32.png",
            "skype": " ",
            "image_72": "https://a.slack-edge.com/80588/img/slackbot_72.png",
            "status_expiration": 0,
            "image_192": "https://a.slack-edge.com/80588/marketing/img/avatars/slackbot/avatar-slackbot.png",
            "first_name": "slackbot",
            "display_name": "Slackbot",
            "title": " ",
            "real_name_normalized": "Slackbot",
            "always_active": true,
            "status_text_canonical": " ",
            "image_24": "https://a.slack-edge.com/80588/img/slackbot_24.png",
            "phone": " ",
            "image_48": "https://a.slack-edge.com/80588/img/slackbot_48.png",
            "fields": null,
            "real_name": "Slackbot",
            "image_512": "https://a.slack-edge.com/80588/img/slackbot_512.png",
            "team": "TRALP6VNY",
            "avatar_hash": "sv41d8cd98f0",
            "status_text": " "
        },
        "updated": 0,
        "tz": null,
        "name": "slackbot",
        "deleted": false,
        "is_app_user": false,
        "is_bot": false,
        "tz_label": "Pacific Standard Time",
        "real_name": "Slackbot",
        "color": "757575",
        "team_id": "TRALP6VNY",
        "is_admin": false,
        "is_ultra_restricted": false,
        "is_restricted": false,
        "is_owner": false,
        "tz_offset": -28800,
        "id": "USLACKBOT",
        "is_primary_owner": false
    }
]

פינג

תיאור

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

פרמטרים

לא רלוונטי

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

N/A

שינוי שם הערוץ

תיאור

משנים את השם של ערוץ Slack.

פרמטרים

שם הפרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
שם הערוץ	String	לא רלוונטי	לא	מציינים את שם הערוץ שרוצים לשנות. הערה: אם מציינים גם את הפרמטר Channel Name (שם הערוץ) וגם את הפרמטר Channel ID (מזהה הערוץ), הפעולה תפעל רק עם המזהה.
מזהה הערוץ	String	לא רלוונטי	לא	מציינים את המזהה של הערוץ שרוצים לשנות את השם שלו. הערה: אם מציינים גם את הפרמטר Channel Name (שם הערוץ) וגם את הפרמטר Channel ID (מזהה הערוץ), הפעולה תפעל רק עם המזהה.
שם חדש	String	לא רלוונטי	כן	מציינים שם חדש לערוץ. הערה: שמות הערוצים יכולים להכיל רק אותיות קטנות, מספרים, מקפים וקווים תחתונים, והם צריכים להיות באורך של עד 80 תווים.

שם הפרמטר

סוג

ערך ברירת המחדל

חובה

תיאור

שם הערוץ

String

לא רלוונטי

לא

מציינים את שם הערוץ שרוצים לשנות.

הערה: אם מציינים גם את הפרמטר Channel Name (שם הערוץ) וגם את הפרמטר Channel ID (מזהה הערוץ), הפעולה תפעל רק עם המזהה.

מזהה הערוץ

String

לא רלוונטי

לא

מציינים את המזהה של הערוץ שרוצים לשנות את השם שלו.

הערה: אם מציינים גם את הפרמטר Channel Name (שם הערוץ) וגם את הפרמטר Channel ID (מזהה הערוץ), הפעולה תפעל רק עם המזהה.

שם חדש

String

לא רלוונטי

כן

מציינים שם חדש לערוץ.

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

‫When "ok" == true:

{
    "channel": {
        "id": "C013ELA1YVC",
        "name": "project_old",
        "is_channel": true,
        "is_group": false,
        "is_im": false,
        "created": 1589444943,
        "is_archived": false,
        "is_general": false,
        "unlinked": 0,
        "name_normalized": "project_old",
        "is_shared": false,
        "parent_conversation": null,
        "creator": "U0136KZ0P5M",
        "is_ext_shared": false,
        "is_org_shared": false,
        "shared_team_ids": [
            "T013MJHSNCT"
        ],
        "pending_shared": [],
        "pending_connected_team_ids": [],
        "is_pending_ext_shared": false,
        "is_member": true,
        "is_private": false,
        "is_mpim": false,
        "last_read": "1595242486.000300",
        "topic": {
            "value": "",
            "creator": "",
            "last_set": 0
        },
        "purpose": {
            "value": "This *channel* is for working on a project. Hold meetings, share docs, and make decisions together with your team.",
            "creator": "U0136KZ0P5M",
            "last_set": 1589444943
        },
        "previous_names": [
            "project_new",
            "project"
        ]
    },
    "ok": true,
    "warning": "missing_charset",
    "response_metadata": {
        "warnings": [
            "missing_charset"
        ]
    }
}

‫When "ok" == false:

{
    "ok": false,
    "error": "name_taken",
    "warning": "missing_charset",
    "response_metadata": {
        "warnings": [
            "missing_charset"
        ]
    }
}

Case Wall

סוג התוצאה	ערך / תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם ok== true (is_success=true): 'Successfully renamed channel {0} to {1} {0}'.format(name/ID, new name) אם ok== false (is_success=false): 'לא הייתה אפשרות לשנות את השם של הערוץ {0}. הסיבה: {1}'.format(name,error from the response) אם הערוץ לא נמצא לפי שם הערוץ (is_success=false): "לא הייתה אפשרות לשנות את שם הערוץ {0}. סיבה: הערוץ לא נמצא".format(name) הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מדווחת שגיאה קריטית (פרטי כניסה שגויים, שגיאת חיבור, קריסת פעולה): "Error executing action "Rename Channel". Reason: {0}''.format(error.Stacktrace) אם לא מציינים את הפרמטרים Channel Name (שם הערוץ) ו-Channel ID (מזהה הערוץ): 'שגיאה בהפעלת הפעולה 'שינוי שם הערוץ'. הסיבה: צריך לציין את שם הערוץ או את מזהה הערוץ'.	כללי

סוג התוצאה

ערך / תיאור

סוג

הודעת פלט*

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

אם ok== true (is_success=true): 'Successfully renamed channel {0} to {1} {0}'.format(name/ID, new name)

אם ok== false (is_success=false): 'לא הייתה אפשרות לשנות את השם של הערוץ {0}. הסיבה: {1}'.format(name,error from the response)

אם הערוץ לא נמצא לפי שם הערוץ (is_success=false): "לא הייתה אפשרות לשנות את שם הערוץ {0}. סיבה: הערוץ לא נמצא".format(name)

הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה:

אם מדווחת שגיאה קריטית (פרטי כניסה שגויים, שגיאת חיבור, קריסת פעולה): "Error executing action "Rename Channel". Reason: {0}''.format(error.Stacktrace)

אם לא מציינים את הפרמטרים Channel Name (שם הערוץ) ו-Channel ID (מזהה הערוץ): 'שגיאה בהפעלת הפעולה 'שינוי שם הערוץ'. הסיבה: צריך לציין את שם הערוץ או את מזהה הערוץ'.

כללי

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

תיאור

שליחת הודעה מתקדמת לערוץ או למשתמש ב-Slack. הפעולה הזו מאפשרת לשלוח הודעות טקסט פשוטות והודעות עשירות בבלוקים של Slack עם לחצנים, עיצוב מתקדם ועוד. מידע נוסף על חסימת הודעות זמין במאמר בנושא Slack Block Kit .

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

פרמטרים

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

דוגמאות לתרחישי שימוש בפלייבוק

שליחת הודעה עם תוכן עשיר כמו לחצנים, קישורים או תמונות.

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

[
  {
    "Entity": "U043FPEMATG",
    "EntityResult": {
      "channel": "D044C3DUMB2",
      "message": {
        "bot_id": "B02D9QYM7P0",
        "type": "message",
        "text": "test msg",
        "user": "U02D1RPLVST",
        "ts": "1666008612.116169",
        "app_id": "A02DDGD942Z",
        "team": "T02CX3N6B0B",
        "bot_profile": {
          "id": "B02D9QYM7P0",
          "app_id": "A02DDGD942Z",
          "name": "test",
          "icons": {
            "image_36": "https://a.slack-edge.com/80588/img/plugins/app/bot_36.png",
            "image_48": "https://a.slack-edge.com/80588/img/plugins/app/bot_48.png",
            "image_72": "https://a.slack-edge.com/80588/img/plugins/app/service_72.png"
          },
          "deleted": false,
          "updated": 1630908872,
          "team_id": "T02CX3N6B0B"
        },
        "blocks": [
          {
            "type": "rich_text",
            "block_id": "RJvg",
            "elements": [
              {
                "type": "rich_text_section",
                "elements": [
                  {
                    "type": "text",
                    "text": "test msg"
                  }
                ]
              }
            ]
          }
        ]
      },
      "ts": "1666008612.116169",
      "ok": true
    }
  }
]

Case Wall

סוג התוצאות	ערך / תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם ההודעה נשלחת בהצלחה (is_succeed=True): 'ההודעה נשלחה בהצלחה' אם ההודעה לא נשלחת בהצלחה (is_succeed=False) כי הנמען שצוין לא נמצא: "ההודעה לא נשלחה כי הנמען שצוין {0} עם הסוג {1} לא נמצא". (נמען, סוג נמען) אם ההודעה לא נשלחת בהצלחה (is_succeed=False) בגלל שגיאה כללית: "ההודעה לא נשלחה בגלל השגיאה הבאה: (0}" (טקסט השגיאה) הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "הפעולה 'שליחת הודעה מתקדמת' נכשלה! השגיאה היא {0}".format(exception.stacktrace)	כללי

סוג התוצאות

ערך / תיאור

סוג

הודעת פלט*

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

אם ההודעה נשלחת בהצלחה (is_succeed=True): 'ההודעה נשלחה בהצלחה'

אם ההודעה לא נשלחת בהצלחה (is_succeed=False) כי הנמען שצוין לא נמצא: "ההודעה לא נשלחה כי הנמען שצוין {0} עם הסוג {1} לא נמצא". (נמען, סוג נמען)

אם ההודעה לא נשלחת בהצלחה (is_succeed=False) בגלל שגיאה כללית: "ההודעה לא נשלחה בגלל השגיאה הבאה: (0}" (טקסט השגיאה)

הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה:

כללי

שליחת הודעה אינטראקטיבית

תיאור

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

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

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

פרמטרים

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

דוגמאות לתרחישי שימוש בפלייבוק

שליחת הודעה עם תוכן עשיר כמו לחצנים, קישורים או תמונות.

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

[
  {
    "uuid": "10953f8e-7ef8-4bde-9e9b-212005e0e737",
    "type": "web",
    "token_id": "47289ba5-277e-4ab9-9238-eb31080530ca",
    "ip": "0000:a000000:ad80:000:20ea:653:fb97",
    "hostname": "webhook.site",
    "method": "GET",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Safari/605.1.15",
    "content": "",
    "query": {
      "Answer": "yes"
    },
    "headers": {
      "connection": [
        "close"
      ],
      "accept-encoding": [
        "gzip, deflate, br"
      ],
      "accept-language": [
        "en-US,en;q=0.9"
      ],
      "user-agent": [
        "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Safari/605.1.15"
      ],
      "cookie": [
        "_ga=GA"
      ],
      "accept": [
        "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
      ],
      "host": [
        "webhook.site"
      ],
      "content-length": [
        ""
      ],
      "content-type": [
        ""
      ]
    },
    "url": "https://webhook.site/47289ba5-277e-4ab9-9238-xx0000000xx?Answer=yes",
    "size": 0,
    "files": [],
    "created_at": "2022-10-14 19:45:40",
    "updated_at": "2022-10-14 19:45:40",
    "sorting": 1665776740032262,
    "custom_action_output": []
  }
]

Case Wall

סוג התוצאות	ערך / תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם ההודעה נשלחת בהצלחה (is_succeed=True): 'ההודעה נשלחה בהצלחה' אם ההודעה לא נשלחת בהצלחה (is_succeed=False) כי הנמען שצוין לא נמצא: "ההודעה לא נשלחה כי הנמען שצוין {0} עם הסוג {1} לא נמצא". (נמען, סוג נמען) אם ההודעה לא נשלחת בהצלחה (is_succeed=False) בגלל שגיאה כללית: "ההודעה לא נשלחה בגלל השגיאה הבאה: (0}" (טקסט השגיאה) הודעות בלוח במקרה של פונקציונליות אסינכרונית: הודעה בלוח המקרים לגבי האיטרציות בזמן ההמתנה לתשובה: "המתנה לתגובה להודעה שנשלחה עם תגובה לפעולה מאתר אחר (webhook). כתובת ה-URL של התגובה לפעולה מאתר אחר (webhook) עם מזהה ייחודי אוניברסלי (UUID): {0}".format(כתובת ה-URL של התגובה לפעולה מאתר אחר (webhook) מתוך הגדרת השילוב + מזהה ייחודי אוניברסלי (UUID) של אסימון האינטרנט) אם התגובה אוחזרה בהצלחה (is_succeed=True): "Successfully fetched the user's response to a webhook! Response content: {0}".format(payload that was sent from user to a webhook) אם אחזור התשובה נכשל עד שהגיע הזמן הקצוב לתפוגה: "לא נמצאה תשובת משתמש ל-webhook והפעולה הופסקה בגלל הזמן הקצוב לתפוגה". הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם לא צוינה כתובת URL שמבוססת על webhook בהגדרות השילוב, וצוין אסימון UUID של webhook: 'הפעולה נכשלה. צריך לציין את פרמטר השילוב 'כתובת בסיסית של webhook'.' אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "הפעולה 'שליחת הודעה אינטראקטיבית' נכשלה! השגיאה היא {0}".format(exception.stacktrace)	כללי

סוג התוצאות

ערך / תיאור

סוג

הודעת פלט*

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

אם ההודעה נשלחת בהצלחה (is_succeed=True): 'ההודעה נשלחה בהצלחה'

אם ההודעה לא נשלחת בהצלחה (is_succeed=False) בגלל שגיאה כללית: "ההודעה לא נשלחה בגלל השגיאה הבאה: (0}" (טקסט השגיאה)

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

הודעה בלוח המקרים לגבי האיטרציות בזמן ההמתנה לתשובה: "המתנה לתגובה להודעה שנשלחה עם תגובה לפעולה מאתר אחר (webhook). כתובת ה-URL של התגובה לפעולה מאתר אחר (webhook) עם מזהה ייחודי אוניברסלי (UUID): {0}".format(כתובת ה-URL של התגובה לפעולה מאתר אחר (webhook) מתוך הגדרת השילוב + מזהה ייחודי אוניברסלי (UUID) של אסימון האינטרנט)

אם התגובה אוחזרה בהצלחה (is_succeed=True): "Successfully fetched the user's response to a webhook! Response content: {0}".format(payload that was sent from user to a webhook)

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

הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה:

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

אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "הפעולה 'שליחת הודעה אינטראקטיבית' נכשלה! השגיאה היא {0}".format(exception.stacktrace)

כללי

שליחת הודעה

תיאור

שליחת הודעה למשתמש או לכמה משתמשים או ערוצים.

פרמטרים

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

שם הפרמטר

סוג

ערך ברירת המחדל

חובה

תיאור

ערוץ

String

לא רלוונטי

כן

שם הערוץ ב-Slack או כתובת האימייל של המשתמש שאליו רוצים לשלוח את ההודעה.

צריך להזין ערכים מופרדים בפסיקים.

הודעה

String

לא רלוונטי

כן

תוכן ההודעה.

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

N/A

העלאת קובץ

תיאור

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

פרמטרים

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

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

N/A

המתנה לתשובה

תיאור

מחכים לתשובה בשרשור להודעה בערוץ.

פרמטרים

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

תרחישי שימוש בפלייבוק

ספר הפעלה עם פעולת שליחת הודעה ואחרי המתנה לתשובה (עם הערוץ כמחזיק מקום מהפעולה הקודמת – מזהה הערוץ)

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

N/A

המתנה לתשובה באמצעות webhook

תיאור

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

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

פרמטרים

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

דוגמאות לתרחישי שימוש בפלייבוק

המתנה לתשובה להודעה באמצעות webhook.

ריצה

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

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

תוצאת סקריפט

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

תוצאת JSON

{
  "client_msg_id": "00000000-0000-0000-0000-000000000000",
  "type": "message",
  "text": "Yes",
  "user": "U0000000",
  "ts": "1578390603.001200",
  "team": "T0000000",
  "blocks": [
    {
      "type": "rich_text",
      "block_id": "2Bb=",
      "elements": [
        {
          "type": "rich_text_section",
          "elements": [
            {
              "type": "text",
              "text": "Example"
            }
          ]
        }
      ]
    }
  ],
  "thread_ts": "1578390492.001100",
  "parent_user_id": "U0000000"
}

Case Wall

סוג התוצאות	ערך / תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: הודעה בלוח המקרים לגבי האיטרציות בזמן ההמתנה לתשובה: "המתנה לתגובה להודעה שנשלחה עם תגובה לפעולה מאתר אחר (webhook). כתובת ה-URL של התגובה לפעולה מאתר אחר (webhook) עם מזהה ייחודי אוניברסלי (UUID): {0}".format(כתובת ה-URL של התגובה לפעולה מאתר אחר (webhook) מתוך הגדרת השילוב + מזהה ייחודי אוניברסלי (UUID) של אסימון האינטרנט) אם התגובה אוחזרה בהצלחה (is_succeed=True): "Successfully fetched the user's response to a webhook! Response content: {0}".format(payload that was sent from user to a webhook) אם אחזור התשובה נכשל עד שהגיע הזמן הקצוב לתפוגה: "לא נמצאה תשובת משתמש ל-webhook והפעולה הופסקה בגלל הזמן הקצוב לתפוגה". הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם כתובת ה-URL שמבוססת על webhook לא צוינה בהגדרות השילוב, אבל צוין אסימון ה-UUID של ה-webhook: "הפעולה לא בוצעה. צריך לציין את פרמטר השילוב 'כתובת בסיסית של webhook'. " אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "הפעולה 'שליחת הודעה מתקדמת' נכשלה! השגיאה היא {0}".format(exception.stacktrace)	כללי

סוג התוצאות

ערך / תיאור

סוג

הודעת פלט*

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

אם התגובה אוחזרה בהצלחה (is_succeed=True): "Successfully fetched the user's response to a webhook! Response content: {0}".format(payload that was sent from user to a webhook)

הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה:

אם כתובת ה-URL שמבוססת על webhook לא צוינה בהגדרות השילוב, אבל צוין אסימון ה-UUID של ה-webhook: "הפעולה לא בוצעה. צריך לציין את פרמטר השילוב 'כתובת בסיסית של webhook'. "

כללי

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