Slack

השילוב עם Slack מאפשר לכם ליצור בקלות בוטים של Slack עם הבנת שפה טבעית שמבוססת על טכנולוגיית Dialogflow CX.

מגבלות

הגדרת Slack

כדי להגדיר את השילוב של Slack עם הסוכן, צריך את הפרטים הבאים:

  • חשבון Slack
  • סביבת עבודה ב-Slack

יצירת בוט ל-Slack

  1. עוברים אל Slack Apps (אפליקציות ל-Slack).
  2. ליצור אפליקציית Slack חדשה מקובץ מניפסט של אפליקציה. בהמשך מופיע מניפסט לדוגמה. מוודאים שהשדות oath_config ו-event_subscriptions תואמים למניפסט לדוגמה. 
    display_information:
  name: Dialogflow CX
  description: Dialogflow CX integration
  background_color: "#1148b8"
features:
  app_home:
    home_tab_enabled: false
    messages_tab_enabled: true
    messages_tab_read_only_enabled: false
  bot_user:
    display_name: CX
    always_online: true
oauth_config:
  scopes:
    bot:
      - app_mentions:read
      - chat:write
      - im:history
      - im:read
      - im:write
      - incoming-webhook
settings:
  event_subscriptions:
    request_url: https://dialogflow-slack-4vnhuutqka-uc.a.run.app
    bot_events:
      - app_mention
      - message.im
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false
  3. התקנת האפליקציה בסביבת העבודה הרצויה
    • טוקן OAuth של משתמש הבוט
      • עוברים אל Install App (התקנת האפליקציה) > OAuth Tokens for Your Workspace (טוקנים של OAuth עבור סביבת העבודה) > Bot User OAuth Token (טוקן OAuth של משתמש הבוט).
    • אסימון חתימה
      • עוברים אל 'מידע בסיסי' > 'פרטי הכניסה לאפליקציה' > 'סוד החתימה'.

הגדרת Dialogflow CX

  1. לוחצים על הכרטיסייה ניהול בחלונית הימנית.
  2. בתפריט הימני לוחצים על שילובים.
  3. לוחצים על הלחצן Connect (קישור) בכרטיס Slack.
  4. ממלאים את הפרטים הבאים:
    • טוקן גישה
    • טוקן חתימה
  5. בוחרים סביבה, לפי הצורך.
  6. לוחצים על התחלה.
  7. מעתיקים את Webhook URL.

הפעלת webhook ב-Slack

חוזרים אל אפליקציית Slack ומדביקים את כתובת ה-URL של ה-webhook בקטע Event Subscriptions > Enable Events > Request URL (הרשמה לאירועים > הפעלת אירועים > כתובת URL של בקשה).

בדיקה

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

הודעות עם תשובות עשירות

הודעות התשובה העשירות נתמכות באמצעות Custom Payload ב-Fulfillment. מידע על פורמט ההודעות זמין במאמר בנושא Slack message API.

לדוגמה, מטען ייעודי (payload) בהתאמה אישית הבא מספק הודעת טקסט פשוטה ב-Slack:

{
  "text": "Hello, world"
}

תשובות ספציפיות לערוץ

אחרי שמגדירים את התשובות הספציפיות לערוץ, הערוץ DF_CX_SLACK משמש אוטומטית כשהסוכן מגיב להודעות ב-Slack.