התאמת בוט הצ'אט

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

דרישות מקדימות

• התפקיד owner או admin בסביבת העבודה
• ספק מחובר. שורת התאמת הבוט מופיעה רק אחרי שסביבת העבודה מחוברת
• אפליקציה ש-Control Center יכול לנהל. ב-Slack זה אומר שהחיבור מחזיק אסימון רענון של תצורת האפליקציה (xoxe-…); אם אין כזה, השורה אומרת זאת ונשארת מושבתת

מה אפשר לשנות

שדה	משמעות	מגבלה
שם האפליקציה	איך הספק מציג את האפליקציה ברשימה	1–35 תווים
שם הבוט (מה שחברים מקלידים אחרי @)	מה שחברים מקלידים אחרי @	1–80 תווים
תיאור קצר	שורה אחת שהספק מציג	עד 140 תווים
מה הבוט אומר שהוא יודע לעשות	מוצג מעל הודעה ישירה עם הבוט	עד 300 תווים
פקודת סלאש	הפקודה שחברים מפעילים, בלי הלוכסן	אותיות קטנות, רק a–z 0–9 _ -, נחתך ב-32 תווים
הודעות ישירות	האם הבוט חושף את חוויית ההודעות הישירות והסוכן	דלוק או כבוי

Control Center מאמת את ארבעת שדות הטקסט לפני שהוא קורא לספק, כך שאתם מקבלים “the app name must be between 1 and 35 characters” במקום invalid_manifest אטום משרת שאינכם רואים. הפקודה אינה נדחית אלא מנורמלת: לוכסן מוביל מוסר, השאר הופך לאותיות קטנות, כל מה שמחוץ ל-a–z 0–9 _ - נזרק, ותוצאה ריקה נופלת חזרה ל-cc.

עריכת הבוט

1. עברו אל הגדרות ← סביבת עבודה ← כללי וגללו לכרטיס גשרי צ’אט
2. בחסימת הספק, לחצו על התאמת הבוט
3. תיבת הדו־שיח נפתחת על הערכים החיים של האפליקציה, שנקראו חזרה מהספק — כך שאתם מתחילים משינוי שמישהו עשה בממשק של Slack עצמו
4. ערכו את מה שצריך ושמרו

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

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

אחרי השמירה, Control Center קורא מחדש את זהות הבוט כדי שהשם בהגדרות יתאים לשם באפליקציית הצ’אט.

התקנה מחדש כשההרשאות משתנות

התקנה מחדש אחרי שינוי הרשאות

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

כששמירה משנה הרשאות, תיבת הדו־שיח נשארת פתוחה ואומרת “Slack שינה את הרשאות האפליקציה. התקינו אותה מחדש כדי שההרשאות ייכנסו לתוקף”, עם כפתור התקנת האפליקציה מחדש שפותח את עמוד ההתקנה של האפליקציה הזו בצוות ב-Slack. ב-Slack זה Install App → Reinstall to Workspace.

שינוי שם פקודת הסלאש

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

שינוי השם אינו שובר שרשורים מגושרים קיימים: שרשורים ממופתחים לפי שיחה, ולא לפי פקודה.

מה Control Center לא ישנה

• הגדרות מבניות. התעבורה (Socket Mode), ההיקפים הנדרשים ומינויי האירועים נכפים ולא מוצעים. אפליקציה שאפשר להגדיר משמסך הגדרות עד כדי דממה היא פנייה לתמיכה, לא יכולת
• הסמל של הבוט. אפשר לשנות אותו רק בהגדרות האפליקציה של הספק עצמו, ותיבת הדו־שיח אומרת זאת
• הגירות התכונות של הספק עצמו. אפליקציה שכבר נמצאת בצורת ה-assistant הישנה של Slack ממשיכה בה; תיבת הדו־שיח הזו עורכת תיאור, היא אינה מבצעת הגירה של אפליקציה

פתרון תקלות

שורת התאמת הבוט אינה מופיעה כלל

סביבת העבודה עדיין אינה מחוברת. השורה מופיעה רק אחרי שחסימת הספק מציגה חיבור חי. ראו הגדרת אינטגרציית Slack.

שורת התאמת הבוט מושבתת

לחיבור אין פרטי גישה לניהול האפליקציה — כתובית המשנה של השורה אומרת “Control Center זקוק לאסימון גישה לתצורת האפליקציה כדי לערוך את הבוט. התחברו מחדש וצרפו אחד.” ב-Slack, הפיקו זוג אסימוני תצורת אפליקציה ב-api.slack.com/apps והתחברו מחדש כשאסימון הרענון מלא. זה מצופה מאפליקציה שנבנתה ביד או שנוצרה דרך יצירה ב-Slack, כי Slack לעולם אינו מדווח איזו אפליקציה הוא יצר.

“Control Center does not know which app to edit”

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

השם החדש של הבוט לא הופיע בצ’אט

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

מדריכים קשורים

• הגדרת אינטגרציית Slack
• קישור חשבון Slack
• גשר צ’אט

מושגים קשורים

• גשרי צ’אט