Настроить чат-бота
Это руководство показывает, как переделать приложение бота на стороне провайдера, не выходя из 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.
Изменить бота
Заголовок раздела «Изменить бота»- Перейдите в Настройки → Рабочее пространство → Основные и прокрутите до карточки Чат-мосты
- В блоке провайдера нажмите Настроить бота
- Диалог открывается на актуальных значениях приложения, прочитанных обратно у провайдера, — поэтому вы начинаете с изменения, которое кто-то внёс в самом интерфейсе Slack
- Измените нужное и сохраните
Чтение этих актуальных значений стоит ротации токена на стороне Slack — поэтому строка требует осознанного нажатия, а не выполняется при загрузке страницы.
Запись накладывает ваши изменения на текущее определение приложения. Всё, что Control Center не моделирует, — вторая slash-команда, добавленная вами в Slack, шаг рабочего процесса, посторонняя настройка — остаётся нетронутым. Области доступа и события объединяются, но никогда не вычитаются.
После сохранения Control Center перечитывает идентичность бота, чтобы имя в настройках совпадало с именем в приложении чата.
Переустановить при изменении разрешений
Заголовок раздела «Переустановить при изменении разрешений»Когда сохранение меняет разрешения, диалог остаётся открытым и сообщает: «В Slack изменились права приложения. Переустановите его, чтобы изменения вступили в силу», — с кнопкой Переустановить приложение, которая открывает страницу установки этого приложения в команде Slack. В Slack это Install App → Reinstall to Workspace.
Переименовать 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.
Новое имя бота не появилось в чате
Заголовок раздела «Новое имя бота не появилось в чате»Провайдеры ненадолго кэшируют метаданные приложения. Если имя всё ещё устарело через минуту, проверьте, не предложило ли сохранение переустановить приложение.