Table of Contents |
---|
Общее
В канале Slack создается приложение-бот, который поддерживает всю основную функциональность - ответы из баз знаний, поддержка кнопок (сценарии, контекстные вопросы, оценка), передачу файлов.
Также бота можно добавить в канал, там он тоже будет отвечать. Можно создать несколько каналов типа Slack в системе AutoFAQ.
Настройка приложения в Slack
Описание шага | Скриншоты | |
---|---|---|
1 | Создайте приложение в Slack, перейдя по ссылке https://api.slack.com/apps?new_app=1 | |
2 |
Например, для облачного стенда ссылка примет вид: https://chat.autofaq.ai/slack-adapter/api/webhook После окончания ввода адреса Slack автоматически проверит подключение и если все в порядке, то покажет значок “Verified” над полем. Иначе Slack покажет ошибку подключения к указанному url, нужно проверить, включен ли на сервере адаптер. Если адрес принят, необходимо нажать кнопку Save Changes внизу страницы. | |
3 | Переходим в левом меню в пункт OAuth & Permissions, открываем блок Scopes. Для “Bot Token Scopes” добавляем следующие разрешения:
Для User Token Scopes добавляем разрешения ниже:
| |
4 |
После публикации приложения появятся токены “Tokens for Your Workspace”, которые потом понадобится указать в настройках канала в AutoFAQ. | |
5 | Далее возвращаемся в Event Subscriptions и в “Subscribe to bot events“ выбираем следующие события:
Обязательно нажимаем кнопку Save Changes. | |
6 | Переходим в меню в пункт App Home и делаем так, чтобы бот всегда показывался online. Always Show My Bot as Online выставляем в On. | |
7 |
Например, для облачного стенда получится адрес https://chat.autofaq.ai/slack-adapter/api/interactiveEndpoint |
Создание канала AutoFAQ
Создайте новый канал типа Slack на странице Настройки - Каналы. Откроется окно для заполнения необходимых полей. В таблице ниже показано, чем заполнять все поля.
Поле | Как заполнять | Настройки бота в Slack | |
---|---|---|---|
1 | Название канала | Укажите любое название, под ним будет создан канал. | |
2 | Адрес сервера Slack API | Оставьте по умолчанию или заполните адресом установки Slack, если он отличается от стандартного. | |
3 | App ID | Берется из настроек приложения Slack, пункт Basic Information → App Credentials → App ID | |
4 | Workspace ID | Для того, чтобы его узнать, нужно:
| |
5 | Bot user OAuth Access Token | Берется из настроек приложения Slack, пункт OAuth & Permissions → Tokens for Your Workspace → Bot User OAuth Access Token. | |
6 | Bot user ID | Последний параметр копируется из формы проверки доступности канала.
|
Проверка работоспособности бота
После всех выполненных выше действий бот и канал успешно созданы. Проверяем, что он работоспособен.
Для этого в приложении Slack открываем список приложений Apps и ищем нашего бота по имени (имя Slack).
Выбираем нужного бота и пишем сообщение для проверки. По умолчанию настройки выставлены таким образом, что в личной переписке бот будет отвечать на каждое сообщение в отдельном треде.
Дополнительные настройки канала
Для канала типа Slack предусмотрены следующие дополнительные настройки.