Налаштувати чат-бота
Цей посібник показує, як переробити застосунок бота на боці провайдера, не виходячи з Control Center.
Передумови
Розділ із назвою «Передумови»- Роль
ownerабоadminу робочому просторі - Підключений провайдер. Рядок Налаштувати бота з’являється лише після того, як робочий простір підключено
- Застосунок, яким Control Center може керувати. Для Slack це означає, що з’єднання містить токен оновлення конфігурації застосунку (
xoxe-…); якщо його немає, рядок повідомляє про це й залишається вимкненим
Що ви можете змінити
Розділ із назвою «Що ви можете змінити»| Поле | Що означає | Обмеження |
|---|---|---|
| Назва застосунку | Як провайдер показує застосунок у списку | 1–35 символів |
| Ім’я бота (що учасники вводять після @) | Що учасники вводять після @ |
1–80 символів |
| Короткий опис | Один рядок, який показує провайдер | Не більше ніж 140 символів |
| Що бот каже, що вміє | Показується над особистим повідомленням боту | Не більше ніж 300 символів |
| Slash-команда | Команда, яку викликають учасники, без слеша | У нижньому регістрі, лише a–z 0–9 _ -, обрізається до 32 символів |
| Особисті повідомлення | Чи відкриває бот особисті повідомлення та роботу з агентом | Увімкнено або вимкнено |
Control Center перевіряє чотири текстові поля, перш ніж звернутися до провайдера, тож ви отримуєте «the app name must be between 1 and 35 characters» замість незрозумілого invalid_manifest від сервера, якого не бачите. Команду не відхиляють, а нормалізують: провідний слеш відкидається, решту переводять у нижній регістр, усе поза a–z 0–9 _ - відкидається, а порожній результат замінюється на cc.
Редагувати бота
Розділ із назвою «Редагувати бота»- Перейдіть до Налаштування → Робочий простір → Загальні і прокрутіть до картки Чат-мости
- У блоці провайдера натисніть Налаштувати бота
- Діалог відкривається на актуальних значеннях застосунку, прочитаних із провайдера, — тож починаєте ви зі зміни, яку хтось зробив у власному інтерфейсі Slack
- Змініть потрібне й збережіть
Читання цих актуальних значень коштує ротації токена на боці Slack, тому рядок — це свідоме натискання, а не дія, яку сторінка виконує під час завантаження.
Запис накладає ваші зміни на поточне визначення застосунку. Усе, чого Control Center не моделює, — друга slash-команда, додана вами в Slack, крок робочого процесу, стороннє налаштування — залишається незмінним. Області доступу та події об’єднуються, а не віднімаються.
Після збереження Control Center перечитує ідентичність бота, щоб ім’я в налаштуваннях збігалося з іменем у чат-застосунку.
Перевстановити при зміні дозволів
Розділ із назвою «Перевстановити при зміні дозволів»Коли збереження змінює дозволи, діалог залишається відкритим і повідомляє: «Slack змінив дозволи застосунку. Перевстановіть застосунок, щоб вони набули чинності», — з кнопкою Перевстановити застосунок, яка відкриває сторінку встановлення цього застосунку в команді Slack. У Slack це Install App → Reinstall to Workspace.
Перейменувати slash-команду
Розділ із назвою «Перейменувати slash-команду»Змініть поле Slash-команда й збережіть. Після цього міст пише інструкції, використовуючи ту команду, якою його викликали востаннє, тож текст довідки та інструкції з прив’язки наслідують перейменування, а не називають команду, якої більше не існує.
Перейменування не ламає наявні гілки моста: гілки прив’язані до розмови, а не до команди.
Що Control Center не змінюватиме
Розділ із назвою «Що Control Center не змінюватиме»- Структурні налаштування. Транспорт (Socket Mode), потрібні області доступу та підписки на події задаються примусово, а не пропонуються. Застосунок, який з екрана налаштувань можна налаштувати до повного мовчання, — це звернення до підтримки, а не функція
- Іконка бота. Змінити її можна лише у власних налаштуваннях застосунку провайдера, і діалог про це повідомляє
- Власні міграції функцій провайдера. Застосунок, який уже має застарілу форму асистента Slack, зберігає її; цей діалог редагує опис, а не мігрує застосунок
Усунення несправностей
Розділ із назвою «Усунення несправностей»Рядка «Налаштувати бота» немає взагалі
Розділ із назвою «Рядка «Налаштувати бота» немає взагалі»Робочий простір ще не підключено. Рядок з’являється лише тоді, коли блок провайдера показує активне з’єднання. Див. Налаштувати інтеграцію Slack.
Рядок «Налаштувати бота» вимкнено
Розділ із назвою «Рядок «Налаштувати бота» вимкнено»У з’єднання немає облікових даних для керування застосунком — підзаголовок рядка повідомляє: «Control Center потрібен токен конфігурації застосунку, щоб редагувати бота. Підключіться знову й додайте його». Для Slack згенеруйте пару токенів конфігурації застосунку на api.slack.com/apps і підключіться знову, заповнивши токен оновлення. Це очікувано для застосунку, зібраного вручну або створеного через Створити в Slack, бо Slack ніколи не повідомляє, який застосунок він створив.
“Control Center does not know which app to edit”
Розділ із назвою «“Control Center does not know which app to edit”»У збереженому з’єднанні немає ідентифікатора застосунку — зазвичай це застосунок, підключений вручну до того, як ідентифікатор було записано. Підключіть робочий простір знову або створіть застосунок із Control Center.
Нове ім’я бота не з’явилося в чаті
Розділ із назвою «Нове ім’я бота не з’явилося в чаті»Провайдери ненадовго кешують метадані застосунку. Якщо ім’я все ще застаріле через хвилину, перевірте, чи не пропонувало збереження перевстановити застосунок.