Slack (Self-Hosted solution)

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

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

Для создания нового приложения Slack необходимо зайти под учетной записью, имеющей права администратора. Перейти по ссылке «Slack API: Applications» (https://api.slack.com/apps). Нажать кнопку «Create New App».

image7

В открывшемся окне «Create New App» заполните поле App Name, выберите в Development Slack Workspace свою команду и нажмите кнопку «Create App». Рекомендуем использовать Yva в качестве названия приложения.

image5

Приложение Yva создано. Прокрутите открывшуюся страницу до секции «App Credentials» и сохраните значения Client ID и Client Secret, они потребуются для настройки платформы Yva.ai.

image4

Далее перейдите на страницу «Features - OAuth & Permissions», используя меню слева. В секции «Redirect URLs» необходимо нажать кнопку «Add a new Redirect URL» и заполнить поля следующим образом:

https://адрес_вашей_Yva/api/sources/slack/oauth/callback

Затем сохраните изменения, нажав кнопки «Add» и «Save URLs».

image6

Прокрутите страницу до секции «Scopes» и с помощью кнопки «Add an OAuth Scope» добавьте следующие права: 

channels:history
channels:read
reactions:read
users:read
users:read.email
team:read

scopes

Затем перейдите на страницу «App Home», используя меню слева и, если требуется, измените имя и имя по умолчанию для бота, а затем сохраните изменения кнопкой «Save Changes». От имени данного бота пользователям будут приходить опросы, если они включены в вашей Yva.ai.

bot

В  результате прохождения всех шагов инструкции у вас должны остаться следующие артефакты:

Название приложения
Значение Client Id
Значение Client Secret

Конфигурация источника данных

1. Полученные в результате создания приложения артефакты необходимо ввести в административной части платформы Yva. Перейти туда можно по адресу https://адрес_вашей_Yva/admin. Выбрать раздел «Integration settings - Slack application». После ввода сохранить настройки, нажав кнопку «Apply».

integration_slack

2. Далее, необходимо перейти в «Администрирование - Управление источниками» Вашей рабочей области. Сделать это можно по адресу https://адрес_вашей_Yva/dashboard. И добавить Slack как источник.

image8

Разрешите приложению доступ к запрашиваемым правам.

allow

После подключения в правой части страницы «Управление источниками» появится подключенная команда Slack.

Также обращаем ваше внимание, что вы можете подключать неограниченное количество рабочих пространств Slack в Yva. Для этого необходимо авторизоваться в рабочем пространстве Slack, которое вы хотите подключить, и повторно выполнить пункт 2 из раздела "Конфигурация источника данных".