Slack

השילוב של Dialogflow עם Slack מאפשר ליצור בקלות אפליקציות ובוטים משלכם ל-Slack, ולאמן אותם להבין שפה טבעית.

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

מגבלות

השילוב הזה תומך רק בשפת ברירת המחדל של נציג התמיכה.

הגדרת Slack

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

• חשבון Slack
• צוות ב-Slack

יצירת אפליקציית Slack

1. ניווט אל Slack Developer Console
2. מזינים שם לאפליקציה
3. בוחרים את הצוות שאליו רוצים לשייך את האפליקציה.
4. לוחצים על הלחצן Create App (יצירת אפליקציה).

הוספת משתמש בוט

1. בתפריט הימני, לוחצים על OAuth & Permissions (הרשאות ו-OAuth).
2. עוברים לקטע Scopes ומוודאים שהיקף ההרשאות הבא ל-OAuth מופיע בקטע Bot Token Scopes:
3. בתפריט הימני, לוחצים על דף הבית של האפליקציה.
4. מפעילים את האפשרות Always Show My Bot as Online ועורכים את App Display Name אם צריך (זה השם שהמשתמשים יראו לבוט)

הפעלת השילוב ב-Dialogflow

ב-Slack Developer Console, לוחצים על Basic Information בתפריט הימני וגוללים למטה לקטע App Credentials. חשוב לרשום את מזהה הלקוח, הסוד של הלקוח וטוקן האימות.

קישור של Slack ל-Dialogflow

1. ב-Dialogflow, בתפריט הימני, עוברים אל Integrations (שילובים).
2. לוחצים על האריח Slack.
3. מזינים את הערכים הרלוונטיים בשדות הבאים:
   1. Client ID
   2. סוד לקוח
   3. טוקן אימות
4. לוחצים על התחלה.

המשך ההגדרה של Slack

אחרי שמגדירים את Slack ו-Dialogflow, צריך להפעיל את OAuth, את כתובות ה-URL של בקשות האירועים (שמסופקות על ידי Dialogflow) ואת המינויים לאירועים.

הוספת כתובת URL של OAuth

1. מעתיקים את כתובת ה-URL של OAuth מדף ההגדרות של Slack ב-Dialogflow.

הערה: אם אפליקציית Slack שלכם היא אפליקציית Slack קלאסית ולא שדרגתם אותה עדיין, תצטרכו ללחוץ על Show URLs for legacy Slack workflow בדף ההגדרות של Slack ב-Dialogflow, ואז להעתיק את כתובת ה-URL של OAuth. מידע נוסף זמין במאמר מדריך למתחילים: ההבדלים בין אפליקציות Slack ישנות לחדשות.

1. עוברים אל Slack Developer Console ולוחצים על OAuth & Permissions (הרשאות ו-OAuth) בתפריט הימני.
2. לוחצים על הלחצן Add a new Redirect URL (הוספת כתובת URL חדשה להפניה אוטומטית) ומדביקים את כתובת ה-URL של OAuth.
3. לוחצים על הוספה.
4. לוחצים על הלחצן שמירת כתובות URL.

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

1. מעתיקים את כתובת ה-URL של בקשת האירוע מדף ההגדרות של Slack ב-Dialogflow.
2. עוברים אל Slack Developer Console ולוחצים על Event Subscriptions (הרשמה לאירועים) בתפריט הימני.
3. לוחצים על המתג כדי להפעיל את האפשרות 'אירועים', ומדביקים את כתובת ה-URL של מינוי האירועים בשדה Request URL (כתובת ה-URL של הבקשה)
   
   אחרי כמה רגעים אמור להופיע הכיתוב 'Verified' (מאומת) בצבע ירוק מעל השדה Request URL.

4. בקטע Subscribe to Bot Events (הרשמה לאירועים של בוט), לוחצים על הלחצן Add Bot User Event (הוספת אירוע של משתמש בוט)
   
   יוצגו שדה טקסט ורשימת אירועים. בשדה הזה אפשר להזין מונחים כדי לחפש אירועים שרוצים שהבוט יגיב להם. ריכזנו רשימה של אירועים שאנחנו ממליצים להוסיף:
   

   שם האירוע	תיאור אירוע
   message.im	הודעה פורסמה בערוץ של צ'אט ישיר
   message.groups	הודעה פורסמה בערוץ פרטי
   message.channels	הודעה פורסמה בערוץ
   im_created	נוצר צ'אט ישיר. בקטע הרשמה לאירועים בשם משתמשים, לוחצים על הלחצן הוספת אירוע ב-Workspace כדי להוסיף את האירוע im_created, ואז לוחצים על שמירת השינויים.

   

5. אחרי שמסיימים לעדכן את ההגדרות האלה, לוחצים על הלחצן שמירת השינויים בתחתית הדף.

הוספת בוט Slack לצוות

1. ב-Slack Developer Console, לוחצים על Manage Distribution (ניהול הפצה) בתפריט הימני.
2. בקטע שיתוף האפליקציה עם סביבת העבודה, לוחצים על הלחצן הוספה ל-Slack.
3. בדף הבא, לוחצים על הלחצן Authorize (אישור) כדי להוסיף את הסוכן

בדיקה

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

תתבקשו להתחבר ל-Slack. אחרי הכניסה לחשבון, עוברים למופע ומאתרים את משתמש הבוט שנקרא ‎@dialogflow-bot. אתם יכולים לשלוח צ'אט ישיר לסוכן כדי לבדוק אותו או להוסיף אותו לערוצים במופע שלכם.

הערה: כדי לשנות את השם של הנציג או להוסיף לוגו, צריך להגדיר את הבוט כציבורי.

אירועים

האירועים הבאים מופעלים על ידי השילוב הזה:

אירוע	תיאור
SLACK_WELCOME	מופעל כשמשתמש מתחיל שיחה עם בוט Slack.

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

אלה הודעות התגובה המתקדמות שנתמכות.

תשובות עם תמונות

פורמטים וגדלים נתמכים:

• gif
• jpeg
• png
• bmp

תשובות בכרטיס

אין שדות חובה לכרטיסים ב-Slack – אפשר להשתמש בכל שילוב של רכיבים.

יש תמיכה בלחצנים עם כתובת URL ועם החזרת נתונים (postback) של טקסט. כפתורים עם כתובת URL מוצגים כהיפר-קישורים.

תשובות מהירות

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

תשובות של מטען ייעודי (payload) בהתאמה אישית

טקסט מעוצב בשילוב עם Slack בלחיצה אחת

הבוטים שלכם ב-Slack יכולים לשלוח טקסט מעוצב, כמו בדוגמה הבאה:

{
  "slack": {
    "text": "This is an example of *bold*, _italic_, and `code`."
  }
}