Подключение бота к Slack

Статья
10/24/2023

ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ SDK версии 4

Бот можно настроить для взаимодействия с людьми через приложение Slack. В этой статье описывается создание приложения Slack с помощью Slack, подключение бота к приложению Slack в Azure и тестирование бота в Slack.

В этой статье показано, как добавить канал Slack в бот в портал Azure. Дополнительные сведения об использовании пользовательского адаптера канала см. в разделе "Дополнительные сведения".

Необходимые компоненты

Подписка Azure. Если у вас еще нет подписки Azure, создайте бесплатную учетную запись, прежде чем начать работу.
Бот, опубликованный в Azure, который требуется подключить к Slack.
Доступ к рабочей области Slack с достаточными разрешениями для создания приложений и управления ими в https://api.slack.com/apps. Если у вас нет доступа к среде Slack, можно создать рабочую область.

Создание приложения в Slack

Сначала вы создадите приложение в Slack, которое создает сведения, необходимые для настройки канала Slack для бота в Azure.

Перейдите на панель "Приложения" и войдите в учетную запись Slack.
Выберите "Создать приложение" или "Создать приложение", если это первое приложение.
1. На странице "Создание приложения" выберите "С нуля".
2. На странице "Имя" и на странице "Имя рабочей области" введите имя приложения Slack.
3. Чтобы выбрать рабочую область для разработки приложения, выберите рабочую область для приложения.
4. Просмотрите и примите условия обслуживания API Slack.
5. Выберите Создать приложение.

Добавление нового URL-адреса перенаправления

После создания приложения добавьте URL-адрес перенаправления в приложение.

Выберите OAuth и разрешения.
В результирующей области в разделе URL-адреса перенаправления выберите " Добавить новый URL-адрес перенаправления".
В поле ввода введите один из следующих URL-адресов перенаправления и нажмите кнопку "Добавить".
- Для глобального бота введите https://slack.botframework.com.
- Для регионального бота введите следующий URL-адрес в соответствии с выбранным регионом:
Область/регион URL-адрес перенаправления

Европа https://europe.slack.botframework.com

Индия https://india.slack.botframework.com
Выберите " Сохранить URL-адреса".

Область/регион	URL-адрес перенаправления
Европа	https://europe.slack.botframework.com
Индия	https://india.slack.botframework.com

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

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

Для URL-адреса запроса введите один из следующих URL-адресов запроса, где {bot-name} отображается отображаемое имя ресурса Azure Bot без фигурных скобок.

Для глобального бота введите https://slack.botframework.com/api/Events/{bot-name}.
Для регионального бота введите следующий URL-адрес в соответствии с выбранным регионом:

Область/регион	Запросить URL-адрес
Европа	`https://europe.slack.botframework.com/api/Events/{bot-name}`
Индия	`https://india.slack.botframework.com/api/Events/{bot-name}`

В разделе "Подписка на события бота" выберите "Добавить событие пользователя бота", а затем подпишитесь на события. Например:
- member_joined_channel
- member_left_channel
- message.channels
- message.groups
- message.im
- message.mpim
Выберите Сохранить изменения.

Включение отправки сообщений боту пользователями

После подписки на события бота включите пользователям сообщение о боте.

Выберите "Главная" приложения.
В результирующей области в разделе "Показать вкладки" на вкладке "Сообщения" можно разрешить пользователям отправлять команды и сообщения косой черты на вкладке "Сообщения".

Добавление и настройка интерактивных сообщений

При необходимости включите интерактивные сообщения.

Выберите "Интерактивность" и "Сочетания клавиш".
Для URL-адреса запроса:
- Для глобального бота введите https://slack.botframework.com/api/Actions.
- Для регионального бота введите следующий URL-адрес в соответствии с выбранным регионом:
Область/регион Запросить URL-адрес

Европа https://europe.slack.botframework.com/Actions

Индия https://india.slack.botframework.com/Actions
Нажмите кнопку Сохранить изменения.

Область/регион	Запросить URL-адрес
Европа	`https://europe.slack.botframework.com/Actions`
Индия	`https://india.slack.botframework.com/Actions`

Копирование сведений о приложении

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

Выберите основные сведения.
В результирующей области в разделе "Учетные данные приложения" найдите идентификатор клиента, секрет клиента и секрет подписи.
Теперь выберите OAuth и Разрешения.
В результирующей области найдите раздел "Области ". Запишите области маркера бота для приложения.

Настройка бота в Azure

Чтобы выполнить этот шаг, вам потребуется учетные данные приложения Slack на предыдущем шаге.

Откройте портал Azure.
Откройте колонку ресурсов Azure Bot для бота.
Откройте каналы и выберите Slack.
В разделе "Конфигурация канала Slack" введите сведения, скопированные на предыдущих шагах.
1. Введите необходимые учетные данные Slack для приложения, созданного в Slack.
2. При необходимости укажите URL-адрес целевой страницы, на который пользователи Slack будут перенаправлены после добавления бота.
3. Значения URL-адреса перенаправления OAuth и URL-адреса запроса подписки на события должны соответствовать значениям, введенным в Slack, чтобы добавить URL-адрес перенаправления и подписаться на события бота.
Выберите Применить.
Вы перенаправляетесь в Slack, чтобы завершить установку приложения Slack.
- Если запрошенные разрешения выглядят правильно, нажмите кнопку "Разрешить".

Теперь бот настроен для взаимодействия с пользователями в Slack. Пользователи в рабочей области теперь могут взаимодействовать с ботом с помощью приложения Slack.

Тестирование приложения в Slack

Войдите в рабочую область Slack, где вы установили приложение.
В разделе "Приложения" выберите свое приложение.
В результирующей области отправьте сообщения в приложение.

Дополнительная информация:

Примечание.

По состоянию на июнь 2020 года канал Slack поддерживает области разрешений Slack версии 2, которые позволяют боту указывать свои возможности и разрешения более детально. Все только что настроенные каналы Slack будут использовать области версии 2. Чтобы переключить бота на области версии 2, удалите и повторно создайте конфигурацию канала Slack в колонке каналов портал Azure.

Дополнительные сведения о поддержке Slack для ботов см. в документации по API Slack: