תיעוד

Slack

שליחה וקבלה של הודעות Slack מתוך pipeline (Events API ‏+ chat.postMessage), במודל BYO.

Slack

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

מה אפשר לעשות עם זה

  • לקבל הודעות מערוץ דרך ה-Events API ולהפעיל עליהן pipeline.
  • לפרסם הודעה בערוץ או בתגובה לשרשור.
  • להציג רשימת ערוצים / משתמשים, לקרוא הודעות אחרונות כדי לספק הקשר לסוכן.

Tools וצמתים

  • Tools של קריאה: slack.list_channels, slack.list_users, slack.read_messages.
  • Tool של כתיבה (עם אישור): slack.post_message.
  • הצומת slack_outbound — שליחה דרך chat.postMessage, תשובה בשרשור, עם הבטחת exactly-once.
  • ה-Receiver ‏slack_inbound — נקודת כניסה של Events API, עם אימות חתימה מובנה על הגוף הגולמי, חלון אנטי-שחזור (anti-rejeu), מנגנון אנטי-לולאה (הודעה של הבוט אינה מפעילה את עצמה מחדש) ודה-דופליקציה של האירועים.

חיבור (BYO)

  1. ניהול → אינטגרציות → Slack.
  2. הזינו את ה-bot token (xoxb-…) ואת ה-signing secret של אפליקציית ה-Slack שלכם.
  3. הגדירו את כתובת ה-Events API של האפליקציה שלכם אל ה-Receiver ‏slack_inbound של ה-pipeline.
  4. ה-token וה-secret מוצפנים במנוחה ולעולם אינם נחשפים שוב.

Slack הוא מחבר BYO מחמיר: אתם משתמשים באפליקציית ה-Slack שלכם, ללא metering וללא רווח של betool. חתימת האירועים מאומתת על הגוף הגולמי — הודעה מזויפת נדחית.

תרחישי שימוש

  • עוזר צוות — סוכן משיב לשאלות שמתפרסמות בערוץ בהסתמך על בסיס הידע שלכם.
  • התראות הניתנות לפעולה — pipeline מפרסם התראה בשרשור ומקבל את תשובת המפעיל כדי להמשיך בעיבוד.