Интеграция Slack

Интеграция Slack позволяет использовать ассистента HaveAI в рабочем пространстве вашей команды. После завершения необходимых разрешений и настроек ответа вы можете писать боту, упоминать его в каналах, к которым он имеет доступ, или задавать вопросы поддерживаемыми командами.

Настройка Slack требует создания приложения Slack и подключения этого приложения к HaveAI. Подключение авторизуется через экран разрешений Slack; вводить пароль Slack в HaveAI не нужно.

Перед началом

У вас должно быть право добавлять приложения в рабочее пространство Slack. Если ваше рабочее пространство требует одобрения администратора для установки приложения, завершите это одобрение.

Держите раздел Slack открытым в панели HaveAI. Адреса и настройки, которые вы используете во время настройки, вы получите с этого экрана.

1. Создайте приложение Slack

Откройте управление приложениями Slack и создайте новое приложение. Выберите имя приложения и рабочее пространство, где оно будет использоваться.

2. Подготовьте разрешения и сведения о приложении

Перейдите в раздел OAuth & Permissions вашего приложения Slack. Добавьте разрешения бота, показанные в шаге настройки в панели HaveAI. Эти разрешения делают возможными такие действия, как отправка сообщений, получение соответствующих сообщений, перечисление каналов и использование команд.

Сохраните следующие сведения из вашего приложения Slack в соответствующие поля панели HaveAI:

• Client ID: ID приложения.
• Client Secret: секретный ключ приложения.
• Signing Secret: секретный ключ, используемый для проверки запросов, приходящих от Slack.

Используйте секретные ключи только в соответствующих полях настройки; не делитесь ими в сообщениях каналов.

3. Введите адреса подключения

Скопируйте адреса, предоставленные в панели HaveAI, в их аналоги в вашем приложении Slack:

• Event Subscriptions → Request URL: адрес, куда события сообщений и упоминаний Slack будут приходить в HaveAI.
• Slash Commands → Request URL: адрес, куда отправляются команды.
• Interactivity → Request URL: адрес, предоставленный для интерактивных действий.
• OAuth & Permissions → Redirect URLs: адрес возврата, используемый после завершения авторизации.

В подписках на события добавьте опции app_mention, message.channels и message.im, которые показывает панель. Упоминание бота и отправка ему личного сообщения — разные события; завершите настройку форм общения, которые будете использовать.

4. Подключите рабочее пространство

Запустите подключение Slack в панели HaveAI. На экране авторизации Slack проверьте рабочее пространство и запрашиваемые разрешения и подтвердите.

Вернувшись в HaveAI, проверьте, что подключённое рабочее пространство верное. Добавьте бота в канал Slack, где будете его использовать. Доступ бота зависит от предоставленных разрешений и каналов, в которых он состоит.

5. Попробуйте ассистента

Убедитесь, что настройка ответа на сообщения с помощью ИИ включена. Затем попробуйте методы, которые будете использовать, по отдельности:

• Отправьте боту личное сообщение.
• В канале, где присутствует бот, упомяните бота и задайте вопрос.
• Отправьте вопрос одной из поддерживаемых команд, которые вы настроили.

То, что подключение установлено, не означает, что опция автоматического ответа на сообщения включена.

Поддерживаемые команды

Чтобы использовать команды, вам также нужно создать их в разделе Slash Commands вашего приложения Slack и привязать к адресу команд, который даёт панель.

Пример: /haveai Каковы наши условия возврата?

Ответ на команду-вопрос могут видеть другие участники в канале, где вы использовали команду. Задавая вопрос, учитывайте участников канала.

Настройки каналов и уведомлений

Просмотрите предлагаемые в панели настройки каналов и уведомлений по умолчанию в соответствии с рабочим распорядком вашей команды. Попробуйте события, для которых ожидаете уведомления, на примерном действии; то, что вы выбрали только один канал, не означает, что все виды уведомлений будут приходить в этот канал.

Для отслеживания диалогов и передачи оператору используйте разделы Сообщения и Передача оператору в панели HaveAI.

Если ответ не приходит

Проверьте подключённое рабочее пространство, добавлен ли бот в канал, и настройку ответа на сообщения. Затем просмотрите разрешения, подписки на события и адреса подключения в приложении Slack.

Если команда не работает, проверьте, что имя команды верное и что она создана с тем же именем в приложении Slack. Если вы изменили разрешения, Slack может запросить повторную авторизацию.

Если поток сообщений работает, но содержимое ответа недостаточно, обновите свою базу знаний и инструкции в HaveAI.

Удаление подключения

Вы можете удалить подключение из раздела Slack в панели HaveAI. Доступ приложения в рабочем пространстве Slack вы также можете проверить из управления приложениями Slack.

За подробными настройками приложения используйте официальное руководство по настройке Slack; для управления диалогами — руководства Сообщения и Передача оператору.

Связанные темы