Slack

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

לפני שמתחילים

לפני שמשתמשים במחבר Slack, צריך לבצע את המשימות הבאות:

  • בפרויקט שלכם ב-Google Cloud:
    • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
    • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
    • מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

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

    • מפעילים את השירותים הבאים:
      • ‫secretmanager.googleapis.com (Secret Manager API)
      • ‫connectors.googleapis.com (Connectors API)

      במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

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

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

הגדרת המחבר

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

  1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

    כניסה לדף Connections

  2. לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
  3. בקטע מיקום, בוחרים את המיקום של החיבור.
    1. אזור: בוחרים מיקום מהרשימה הנפתחת.

      רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.

    2. לוחצים על הבא.
  4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
    1. מחבר: בוחרים באפשרות Slack מהרשימה הנפתחת של המחברים הזמינים.
    2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
    3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

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

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
    4. אופציונלי: מזינים תיאור למופע החיבור.
    5. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
    6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
    7. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

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

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

    8. (אופציונלי) בקטע הגדרות מתקדמות, מסמנים את התיבה שימוש ב-proxy כדי להגדיר שרת proxy לחיבור, ומגדירים את הערכים הבאים:
      • סכימת אימות של שרת proxy: בוחרים את סוג האימות לאימות מול שרת ה-proxy. אלה סוגי האימות שנתמכים:
        • בסיסי: אימות HTTP בסיסי.
        • ‫Digest: אימות HTTP מסוג Digest.
      • משתמש proxy: שם משתמש שישמש לאימות בשרת ה-proxy.
      • סיסמת ה-Proxy: הסוד במנהל הסודות של סיסמת המשתמש.
      • סוג ה-SSL של ה-Proxy: סוג ה-SSL שבו יש להשתמש כשמתחברים לשרת ה-Proxy. אלה סוגי האימות שנתמכים:
        • אוטומטי: הגדרת ברירת המחדל. אם כתובת ה-URL היא כתובת HTTPS, נעשה שימוש באפשרות Tunnel. אם כתובת ה-URL היא כתובת HTTP, נעשה שימוש באפשרות NEVER.
        • תמיד: החיבור תמיד מופעל באמצעות SSL.
        • לעולם לא: החיבור לא מופעל באמצעות SSL.
        • מנהור: החיבור הוא דרך שרת proxy למנהור. שרת ה-proxy פותח חיבור למארח המרוחק, והתנועה זורמת הלוך ושוב דרך ה-proxy.
      • בקטע שרת Proxy, מזינים את פרטי שרת ה-Proxy.
        1. לוחצים על + הוספת יעד.
        2. בוחרים סוג יעד.
          • כתובת המארח: מציינים את שם המארח או את כתובת ה-IP של היעד.

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

    9. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    10. לוחצים על הבא.
  5. בקטע אימות, מזינים את פרטי האימות.
    1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      החיבור ל-Slack תומך בסוגי האימות הבאים:

      • ‫OAuth2.0 – קוד הרשאה
      • אימות באמצעות טוקן משתמש
    2. כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

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

הגדרת אימות

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

  • OAuth2.0 – קוד הרשאה

    כדי לבצע אימות באמצעות OAuth2.0, מזינים את הפרטים הבאים:

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

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

    • טוקן משתמש: טוקן המשתמש שמשמש לאימות המשתמש.
    • גרסת סוד: גרסת הסוד שנבחרה למעלה.

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

שלבים נוספים אחרי יצירת החיבור

אם בחרתם באפשרות OAuth 2.0 - Authorization code לאימות, אתם צריכים לבצע את השלבים הנוספים הבאים אחרי יצירת החיבור:

  1. בדף החיבורים, מאתרים את החיבור החדש.

    שימו לב שהסטטוס של המחבר החדש יהיה נדרשת הרשאה.

  2. לוחצים על דרושה הרשאה.

    יוצג לוח עריכת הרשאה.

  3. מעתיקים את הערך של Redirect URI (ה-URI של ההפניה האוטומטית) לאפליקציה החיצונית.
  4. מאמתים את פרטי ההרשאה.
  5. לוחצים על Authorize.

    אם ההרשאה מתבצעת בהצלחה, סטטוס החיבור יהיה פעיל בדף החיבורים.

אישור מחדש של קוד הרשאה

אם אתם משתמשים בסוג האימות Authorization code וביצעתם שינויים בהגדרות של האפליקציה, אתם צריכים לאשר מחדש את החיבור ל-OneDrive. כדי לאשר מחדש חיבור, מבצעים את השלבים הבאים:

  1. לוחצים על החיבור הרצוי בדף החיבורים.

    ייפתח הדף עם פרטי החיבור.

  2. לוחצים על עריכה כדי לערוך את פרטי החיבור.
  3. בודקים את הפרטים של OAuth 2.0 – קוד הרשאה בקטע אימות.

    אם צריך, מבצעים את השינויים הנדרשים.

  4. לוחצים על Save. הלחיצה תעביר אתכם לדף פרטי החיבור.
  5. בקטע אימות, לוחצים על עריכת הרשאה. מוצגת החלונית Authorize (אישור).
  6. לוחצים על Authorize.

    אם ההרשאה מתבצעת בהצלחה, סטטוס החיבור יהיה פעיל בדף החיבורים.

דוגמאות להגדרת חיבור

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

‫Slack – סוג החיבור לאימות UserToken

שם השדה פרטים
מיקום us-central1
מחבר Slack
גרסת המחבר 1
שם החיבור slack-usertoken-connection
הפעלת Cloud Logging כן
חשבון השירות my-service-account@my-project.iam.gserviceaccount.com
רמת הפירוט 5
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
אימות באמצעות טוקן משתמש כן
טוקן משתמש USER_TOKEN
גרסה של סוד 1

‫Slack – סוג החיבור לאימות OAuth 2.0

שם השדה פרטים
מיקום us-central1
מחבר Slack
גרסת המחבר 1
שם החיבור slack-google-cloud-oauth-conn
הפעלת Cloud Logging כן
חשבון השירות my-service-account@my-project.iam.gserviceaccount.com
רמת הפירוט 5
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
‫OAuth 2.0 – קוד הרשאה כן
מזהה לקוח CLIENT_ID
היקפים channels:read, groups:read, im:read, mpim:read, channels:write, groups:write,
im:write,mpim:write, channels:history, groups:history, im:history, mpim:history,
search:read, chat:write:user, chat:write:bot, files:read, files:write:user, pins:read,
pins:write,usergroups:read, usergroups:write, reminders:read, reminders:write,
users:read, users.profile:write
סוד לקוח CLIENT_SECRET
גרסה של סוד 2

מגבלות המערכת

מחבר Slack יכול לעבד עד עסקה אחת בשנייה, לכל צומת, ומגביל את כל העסקאות שחורגות מהמגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

שימוש בחיבור ל-Slack בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור בשילוב באמצעות המשימה Connectors.

  • כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
  • מידע על יצירה ושימוש במשימת מחברים ב-Application Integration זמין במאמר משימת מחברים.

ישויות, פעולות ופעולות

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

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

    עם זאת, יכול להיות שמחבר לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה Entities תהיה ריקה.

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

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

  • פעולה: פעולה היא פונקציה מסוג first class שזמינה לשילוב דרך ממשק המחבר. פעולה מאפשרת לבצע שינויים בישות אחת או בכמה ישויות, והיא משתנה ממתחם למתחם. בדרך כלל, לפעולה יהיו כמה פרמטרים של קלט ופרמטר של פלט. עם זאת, יכול להיות שמחבר לא תומך באף פעולה, ובמקרה כזה הרשימה Actions תהיה ריקה.

פעולות

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

הפעולה InviteUser

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

פרמטרים של קלט לפעולה InviteUser

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

דוגמה להגדרת הפעולה InviteUser מופיעה במאמר InviteUser Example.

פעולה מסוג CloseChannel

הפעולה הזו סוגרת צ'אט ישיר או צ'אט ישיר עם כמה משתמשים.

פרמטרים של קלט של CloseChannel

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

דוגמה להגדרת הפעולה CloseChannel מופיעה במאמר דוגמה ל-CloseChannel.

פעולה JoinChannel

הפעולה הזו מאפשרת למשתמש להצטרף לשיחה קיימת.

פרמטרים של קלט של JoinChannel

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

דוגמה להגדרת הפעולה JoinChannel מופיעה במאמר דוגמה ל-JoinChannel.

פעולה של יציאה מערוץ

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

פרמטרים של קלט של LeaveChannel

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

דוגמה להגדרת הפעולה LeaveChannel מופיעה במאמר דוגמה ל-LeaveChannel.

פעולה של OpenChannel

הפעולה הזו פותחת או מחדשת צ'אט ישיר או צ'אט ישיר עם כמה אנשים.

פרמטרים של קלט של OpenChannel

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

דוגמה להגדרת הפעולה OpenChannel מופיעה במאמר OpenChannel Example.

הפעולה DownloadFile

הפעולה הזו מורידה קובץ.

פרמטרים של קלט של DownloadFile

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

דוגמה להגדרת הפעולה DownloadFile מופיעה במאמר דוגמה ל-DownloadFile.

פעולה של סיום מצב 'נא לא להפריע'

הפעולה הזו מסיימת את מצב 'נא לא להפריע' של המשתמש.

פרמטרים של קלט לפעולה EndDnd

מעבירים JSON ריק, כמו {}.

דוגמה להגדרת הפעולה EndDnd מופיעה במאמר EndDnd Example.

SetSnooze action

הפעולה הזו מפעילה את מצב 'נא לא להפריע' עבור המשתמש או משנה את משך הזמן שלו.

פרמטרים של קלט לפעולה SetSnooze

שם הפרמטר סוג הנתונים חובה תיאור
NumOfMinutes String 60 מספר הדקות להשהיית המשתמש.

דוגמה להגדרת הפעולה SetSnooze מופיעה במאמר SetSnooze Example.

פעולת EndSnooze

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

פרמטרים של קלט של הפעולה EndSnooze

מעבירים JSON ריק, כמו {}.

דוגמה להגדרת הפעולה EndSnooze מופיעה במאמר דוגמה ל-EndSnooze.

הפעולה SendScheduleMessage

הפעולה הזו מתזמנת שליחת הודעה לערוץ.

פרמטרים של קלט לפעולה SendScheduleMessage

מעבירים JSON ריק, כמו {}.

דוגמה להגדרת הפעולה SendScheduleMessage מופיעה במאמר SendScheduleMessage Example.

הפעולה RemoveProfilePhoto

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

פרמטרי הקלט של הפעולה RemoveProfilePhoto

מעבירים JSON ריק, כמו {}.

דוגמה להגדרת הפעולה RemoveProfilePhoto מופיעה במאמר RemoveProfilePhoto Example.

הפעולה SendEphemeralMessage

הפעולה הזו שולחת הודעה זמנית למשתמש בערוץ.

פרמטרים של קלט לפעולה SendEphemeralMessage

מעבירים JSON ריק, כמו {}.

דוגמה להגדרת הפעולה SendEphemeralMessage מופיעה במאמר דוגמה לשליחת הודעה זמנית.

הפעולה הזו מאחזרת כתובת URL של קישור קבוע להודעה ספציפית בשיחה או בערוץ.

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

דוגמה להגדרת הפעולה GetPermaLink מופיעה במאמר דוגמה ל-GetPermaLink.

פעולת SetReadCursor

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

פרמטרים של קלט לפעולה SetReadCursor

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

דוגמה להגדרת הפעולה SetReadCursor מופיעה במאמר SetReadCursor Example.

פעולה GetTeamBillableInfo

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

פרמטרים של קלט בפעולה GetTeamBillableInfo

מעבירים JSON ריק, כמו {}.

דוגמה להגדרת הפעולה GetTeamBillableInfo מופיעה במאמר GetTeamBillableInfo Example.

פעולת EnableUserGroup

הפעולה הזו מפעילה קבוצת משתמשים.

פרמטרים של קלט לפעולה EnableUserGroup

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

דוגמה להגדרת הפעולה EnableUserGroup מופיעה במאמר EnableUserGroup Example.

פעולת השבתה של קבוצת משתמשים

הפעולה הזו משביתה קבוצת משתמשים.

פרמטרים של קלט לפעולה DisableUserGroup

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

דוגמה להגדרת הפעולה DisableUserGroup מופיעה במאמר דוגמה להשבתת קבוצת משתמשים.

דוגמאות לפעולות

דוגמה – InviteUser

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה InviteUser ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "ChannelId": "C06Q6NTRNA2",
      "Users": "U070MCLRREW"
    }
  4. אם הפעולה מצליחה, לפרמטר התגובה InviteUser של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
     [{
      "Success": "true"
    }] 

דוגמה – CloseChannel

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CloseChannel ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "ChannelId": "C075U92TU4U"
    }
  4. אם הפעולה מצליחה, לפרמטר התגובה CloseChannel של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
     [{
      "Success": "true"
    }] 

דוגמה – JoinChannel

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה JoinChannel ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "ChannelId": "C06UMDTL1EH"
    }
  4. אם הפעולה מצליחה, לפרמטר התגובה JoinChannel של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
     [{
      "Success": "true"
    }] 

דוגמה – LeaveChannel

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה LeaveChannel ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "ChannelId": "C06UME4PM2R"
    }
  4. אם הפעולה מצליחה, לפרמטר התגובה LeaveChannel של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
     [{
      "Success": "true"
    }]

דוגמה – OpenChannel

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה OpenChannel ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
    "Users": "U06VCS3NDNC,U06NE4KAL0G",
    "ChannelId": "C071CU9UXFF"
    }
  4. אם הפעולה מצליחה, לפרמטר התגובה OpenChannel של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
    [{
    "Success": "true"
    }]

דוגמה – DownloadFile

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DownloadFile ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "FileId": "F075UHEMSN8",
      "HasBytes": true
    }
  4. אם הפעולה מצליחה, לפרמטר התגובה DownloadFile של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [{
      "Success": "True",
      "ContentBytes": "JVBERi0xLjMKJcTl8uXrp/Og0MTGCjQgMCBvYmoKPDwgL0xlbmd0aCA1IDAgUiAvRmlsdGVyIC9GbGF0ZURlY29kZSA"
    }]

שיקולים נוספים

  • מגדירים את הערך של HasBytes כ-True כדי להוריד פורמטים אחרים של קבצים, כמו PDF או xlsx, שמספקים את התוכן בפורמט מקודד Base 64.
  • כדי להוריד קובץ בפורמט TXT, מגדירים את HasBytes כ-True ומורידים את תוכן הקובץ כבייטים. כדי להוריד את התוכן בפועל של הקובץ, מגדירים את הערך של HasBytes ל-False.

דוגמה – EndDnd

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה EndDnd ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {}
  4. אם הפעולה מצליחה, לפרמטר התגובה EndDnd של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
     [{
      "Success": "true"
    }]  

דוגמה – SetSnooze

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה SetSnooze ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
     {
      "NumOfMinutes": "60"
    }
  4. אם הפעולה מצליחה, לפרמטר התגובה SetSnooze של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
     [{
      "Success": "true",
      "SnoozeEnabled": "true",
      "SnoozeEndTime": "1722842455",
      "SnoozeRemaining": "3600",
      "SnoozeIsIndefinite": "false"
    }]

דוגמה – EndSnooze

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה EndSnooze ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {}
  4. אם הפעולה מצליחה, לפרמטר התגובה EndSnooze של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
      [{
      "Success": "true",
      "DndEnabled": "true",
      "NextDndStartTime": "1722875400",
      "NextDndEndTime": "1722911400",
      "SnoozeEnabled": "false"
    }]

דוגמה – SendScheduleMessage

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה SendScheduleMessage ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
     {
      "Channel": "C07AMLB39JN",
      "PostAt": "2024-08-27 14:15:00.0",
      "Text": "Hello, World!",
      "ReplyBroadCast": false
     }
  4. אם הפעולה מצליחה, לפרמטר התגובה SendScheduleMessage של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

     
       [{
      "Success": "true",
      "ok": "true",
      "scheduled_message_id": "Q07KD4YSG72",
      "channel": "C07AMLB39JN",
      "post_at": "1724768100",
      "message_user": "U071FD3TS8P",
      "message_type": "message",
      "message_bot_id": "B076304QR9V",
      "message_app_id": "A076HCDGHT5",
      "message_text": "Hello, World!",
      "message_team": "T071W04MGV8",
      "message_bot_profile_id": "B076304QR9V",
      "message_bot_profile_deleted": "false",
      "message_bot_profile_name": "Googlecloud_OAuth_Slack",
      "message_bot_profile_updated": "1717513424",
      "message_bot_profile_app_id": "A076HCDGHT5",
      "message_bot_profile_icons_image_36": "https://a.slack-edge.com/80588/img/plugins/app/bot_36.png",
      "message_bot_profile_icons_image_48": "https://a.slack-edge.com/80588/img/plugins/app/bot_48.png",
      "message_bot_profile_icons_image_72": "https://a.slack-edge.com/80588/img/plugins/app/service_72.png",
      "message_bot_profile_team_id": "T071W04MGV8",
      "message_blocks_type": "rich_text",
      "message_blocks_block_id": "MYA",
      "message_blocks_elements_type": "rich_text_section",
      "message_blocks_elements_elements_type": "text",
      "message_blocks_elements_elements_text": "Hello, World!"
    }]

דוגמה – RemoveProfilePhoto

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה RemoveProfilePhoto ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
     {}
    
  4. אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לזה:

    [{
      "Success": "true"
     }]
    

דוגמה – SendEphemeralMessage

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה SendEphemeralMessage ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
     {}
    
  4. אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לזה:

     
    [{
      "Success": "true"
     }]
    
    

דוגמה – GetPermaLink

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה GetPermaLink ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "ChannelId": "C071W04P682",
      "MessageId": "1734939860.333379"
    }
    
  4. אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:

    [
      {
        "Success": "true",
        "ChannelId": "C071W04P682",
        "PermaLink": "https://altostrat-ic97757.slack.com/archives/C071W04P682/p1734939860333379"
      }
    ]
    

דוגמה – SetReadCursor

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה SetReadCursor ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "ChannelId": "C07AMLB39JN",
      "MessageId": "1724767860.360739"
    }
    
  4. אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:

    [
      {
        "Success": "true"
      }
    ]
    

דוגמה – GetTeamBillableInfo

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה GetTeamBillableInfo ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {}
    
  4. אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:

    [
      {
        "Success": "true",
        "Plan": "std"
      }
    ]
    

דוגמה – EnableUserGroup

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה EnableUserGroup ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "UserGroup": "S08696VPXPC",
      "TeamId": "T071W04MGV8"
    }
    
  4. אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:

    [
      {
        "Success": "true"
      }
    ]
    

דוגמה – DisableUserGroup

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DisableUserGroup ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "UserGroup": "S08696VPXPC",
      "TeamId": "T071W04MGV8"
    }
    
  4. אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:

    [
      {
        "Success": "true"
      }
    ]
    

דוגמאות לפעולות על ישויות

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

דוגמה – רשימת רשומות של הישות Messages

בדוגמה הזו מוצגת רשימת הרשומות של הישות Messages.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Messages מהרשימה Entity.
  3. בוחרים את הפעולה List ולוחצים על סיום.

אפשר לבצע פעולות ברשימה גם בישויות הבאות: Files, MessageReplies, Pins, Reactions, Reminders,TeamInfo, UserGroups, Users, Channels, DND, Teams, UserProfile, ScheduledMessages, TeamProfileFields, and TeamProfileSections.

דוגמה – קבלת רשומות של הישות Calls

בדוגמה הזו, מאחזרים את הרשומות של הישות Calls.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Calls מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. מגדירים את מזהה הישות ל-R070LKL3YKX, שהוא המפתח שיועבר. כדי להגדיר את מזהה הישות, בקטע Task Input של המשימה Connectors, לוחצים על EntityId ואז מזינים R070LKL3YKX בשדה Default Value.

צריך להעביר את הערך של מזהה הישות ישירות. בדוגמה הזו, הערך הייחודי של המפתח הראשי הוא R070LKL3YKX והוא מועבר ישירות.

אפשר לבצע פעולות get גם על הישויות הבאות: Calls, MessageReplies, Messages, Reactions,TeamInfo, Reminders, Users ו-Channels

דוגמה – מחיקת רשומות של ישות מסוג Calls

בדוגמה הזו נמחקות הרשומות של הישות Calls.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Calls מהרשימה Entity.
  3. בוחרים את הפעולה Delete ולוחצים על סיום.
  4. מגדירים את מזהה הישות ל-R074DSKVDSS, שהוא המפתח שיועבר. כדי להגדיר את מזהה הישות, בקטע Task Input של המשימה Connectors, לוחצים על EntityId ואז מזינים R074DSKVDSS בשדה Default Value.

    אם לישות יש שני מפתחות עסקיים מורכבים או שני מפתחות ראשיים, אפשר להגדיר את filterClause ל-Id='R074DSKVDSS'.

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

דוגמה – יצירת רשומות של ישות מסוג Calls (שיחות)

בדוגמה הזו נוצרות רשומות של הישות Calls.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Calls מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "ExternalUniqueId": "c249a48c-a154-43d6-a286-791df11927a4",
      "JoinURL": "https://example55.com/call"
    }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Connector יהיה ערך שדומה לזה:

     
    {
      "Id": "R074LBCFBU3"
    } 

דוגמה – יצירת רשומות של הישות Messages

בדוגמה הזו נוצרות רשומות של הישות Messages.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Messages מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "ChannelId": "C06UF15CB0V",
      "Text": "This is google cloud created Message"
    }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Connector יהיה ערך שדומה ל :

     
    {
    "Id": "1723008314.867479",
    "ChannelId": "C06UF15CB0V"
    }   

דוגמה – יצירת רשומה של הישות Pins

בדוגמה הזו נוצרת רשומה של הישות Pins.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Pins מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
    "ChannelId": "C06UF15CB0V",
    "Id": "1723008314.867479",
    "Type": "message"
    }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Connector יהיה ערך שדומה ל :

     
    {
    "Id": "1723008314.867479",
    "Type": "message",
    "ChannelId": "C06UF15CB0V"
    }

דוגמה – יצירת רשומה של הישות Reactions

בדוגמה הזו נוצרת רשומה של הישות Reactions.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Reactions מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "ChannelId": "C06UPA4KRD0",
      "Id": "1716375032.038669",
      "Type": "message",
      "Name": "raised_hands"
    }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Connector יהיה ערך שדומה לזה:

     
    {
      "Success": true
    }   

דוגמה – יצירת רשומה של ישות התזכורות

בדוגמה הזו נוצרת רשומה של הישות Reminders.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Reminders מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "Text": "this is a reminder",
      "Time": "2025-10-15 14:30:00"
    }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Connector יהיה ערך שדומה לזה:

     
    {
      "Id": "Rm074P0X9JCV"
    } 
     

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

בדוגמה הזו נוצרת רשומה של הישות Channels.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Channels מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
    "Name": "googlecloudcreatedchannel",
    "IsPublic": true
    } 

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Connector יהיה ערך שדומה לזה:

     
    {
    "Id": "C074MBW5N2G"
    } 
      

דוגמה – יצירת רשומה של הישות MessageReplies

בדוגמה הזו נוצרת רשומה של הישות MessageReplies.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות MessageReplies מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
    "ChannelId": "C076HCY07UN",
    "Text": "This is generated text",
    "ParentMessageId": "1717659095.881619"
    }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Connector יהיה ערך שדומה לזה:

     
    {
    "Id": "1717659183.033599",
    "ChannelId": C076HCY07UN,
    "ParentMessageId": "1717659095.881619"
    }
     

דוגמה – עדכון רשומה של הישות Calls

בדוגמה הזו מעדכנים רשומה של ישות Calls.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Calls מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "JoinURL": "https://example55.com/call/google-cloud",
      "Title": "title"
    }
  5. מגדירים את מזהה הישות ל-R074LB76Q5R. כדי להגדיר את מזהה הישות, לוחצים על entityId ואז מזינים R074LB76Q5R בשדה Default Value.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך R074LB76Q5R.

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Connector יהיה ערך שדומה לדוגמה הבאה:

    {
      "Id": "null"
    }  

דוגמה – עדכון רשומה של היישות Messages

בדוגמה הזו מעדכנים רשומה של ישות Messages.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Messages מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "Text": "Google Cloud Updated Message"
    }  
  5. מגדירים את filterClause ל-ChannelId = 'C06UPA4KRD0' ו-Id = '1716369465.000129'. כדי להגדיר את filterClause, לוחצים על filterClause ואז מזינים ChannelId = 'C06UPA4KRD0' and Id = '1716369465.000129' בשדה Default Value.

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Connector יהיה ערך שדומה לדוגמה הבאה:

    {
      "Id": null,
      "ChannelId": null
    }  

דוגמה – עדכון רשומה של ישות המשתמשים

בדוגמה הזו מעדכנים רשומה של ישות Users.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Users מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "ProfileDisplayName": "Vaibhav"
    } 
  5. מגדירים את מזהה הישות ל-U06Q6VDJYSU. כדי להגדיר את מזהה הישות, לוחצים על entityId ואז מזינים U06Q6VDJYSU בשדה Default Value.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך U06Q6VDJYSU.

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Connector יהיה ערך שדומה לדוגמה הבאה:

    {
    "Id": null
    } 

דוגמה – עדכון רשומה של ישות מסוג 'ערוצים'

בדוגמה הזו מעדכנים רשומה של ישות Channels.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Channels מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
    "Purpose": "This is the one channel that will always include everyone."
    }
  5. מגדירים את מזהה הישות ל-C06MAP1JDSB. כדי להגדיר את מזהה הישות, לוחצים על entityId ואז מזינים C06MAP1JDSB בשדה Default Value.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך C06MAP1JDSB.

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Connector יהיה ערך שדומה לדוגמה הבאה:

    {
    "Id": "C06MAP1JDSB"
    }

דוגמה – עדכון רשומה של הישות MessageReplies

בדוגמה הזו מעדכנים רשומה של ישות MessageReplies.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות MessageReplies מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
    "Text": "Updated Text"
    }
  5. מגדירים את filterClause ל-ChannelId = 'C06UPA4KRD0' ו-Id = '1716369465.000129'. כדי להגדיר את filterClause, לוחצים על filterClause ואז מזינים ChannelId = 'C06UPA4KRD0' and Id = '1716369465.000129' בשדה Default Value.

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Connector יהיה ערך שדומה לדוגמה הבאה:

    {
    "Id": null,
    "ChannelId": null,
    "ParentMessageId": null
    }   

דוגמה – עדכון רשומה של הישות UserProfile

בדוגמה הזו מעדכנים רשומה של ישות UserProfile.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות UserProfile מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
     {
      "CustomFields": "{\"Xf079082Q70B\": {\"value\": \"Patna Bihar\",\"alt\": \"\"}}",
      "Phone": "8767787654",
      "StatusText": "Long train Journey to work"
     }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Connector יהיה ערך שדומה לדוגמה הבאה:

    {
    
    }
    

קבלת עזרה מקהילת Google Cloud

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

המאמרים הבאים