Microsoft Teams
Убедитесь, что у вас есть доступ администратора к вашему аккаунту Microsoft, так как следующие действия требуют данных прав.
Приложение Microsoft Office 365
Необходимо проверить созданное в рамках Microsoft Office 365 приложение на соответствие прав и разрешений необходимых для подключения Teams. Переходим на страницу регистрации приложений - https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade и авторизовываемся под учетной записью Microsoft. Выбираем ранее созданное приложение.
Сохраните Имя и ID приложения (Application (client) ID). Данные значение потребуется позже при подачи заявки в Microsoft.
Затем переходим в раздел «API permissions» и проверяем какие разрешения даны приложению. У приложения должны быть одобрены следующие разрешения с типом Application:
ChannelMessage.Read.All
Mail.Read
User.Read.All
Directory.Read.All
Если приложение имеет больше разрешений, чем требуется, лишние необходимо удалить.
Если приложению не хватает разрешений, их необходимо добавить. Процедура добавления описана в Microsoft Office 365 .
Далее, необходимо проверить список redirect URI. Сделать это можно на вкладке «Authentication».
Убедитесь, что в списке URI для перенаправления есть следующие (где вместо yva.company.com адрес вашей Yva.ai):
https://yva.company.com/sso/externallogin/callback
https://yva.company.com/api/sources/office365/oauth/callback
Если в списке есть дополнительные адреса, их необходимо удалить. Если в списке не хватает адреса, его можно добавить нажатием кнопки «Add URI». Не забудьте сохранить результат правок кнопкой «Save».
Как итог, для дальнейших действий потребуются следующие значения:
Название приложения
ID приложения
Если в список разрешений приложения или список URI для перенаправления вносились изменения, то необходимо повторно подключить источник »Office 365» в платформе на вкладке «Администрирование - Управление источниками».
Создание заявки на получение доступа к Teams
Получение системой Yva.ai данных из Microsoft Teams для анализа происходит через API Microsoft Graph. Методы получения сообщений из MS Teams относятся к «защищенным». Для их работы необходимо пройти процедуру получения доступ к ним. Ниже вы найдете инструкцию, как это сделать.
Перейдите по ссылке https://forms.office.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR1ax4zKyZjVBmutzKVo1pVtUQ1VJMlNTNUdJV1FKTzVZSVU4MlMwTTdOTSQlQCN0PWcu
1. Введите адрес администратора, который получит ответ об одобрении. Можно ввести несколько адресов через точку с запятой. Мы рекомендуем в качестве дополнительного адреса ввести адрес технической поддержки компании Yva.ai: delivery@yva.ai
2. Отметьте «Yes». Если у представителей Microsoft возникнут вопросы, мы поможем на них ответить.
3. Publisher name: впишите название вашей компании на английском языке.
4. App Name: это название приложения, которое Вы сохранили при регистрации приложения Office 365.
5. App id(s) to enable application permissions for: это ID приложения, которое вы сохранили при регистрации приложения Office 365.
6. What does your app do? Вставьте следующий текст:
Yva.ai is an ethical AI predictive HR analytics platform which helps teams and team managers to predict employees' burnout, retain and grow key talents, find informal leaders and develop leadership skills. To get an eye-bird view of the situation in the company, the company connects the sources of communication to the Yva.ai platform. The Yva.ai platform analyzes historical communication pattern of the company with the help of neural network algorithms and detects the signs of early burnout among employees basing on this analysis. This way the Yva.ai platform collects valuable insights with no distracting employees from their work.
7. Why does your app need read access to all messages in the tenant? Вставьте следующий текст:
The app should analyze all users in tenant.
8. Data retention. Выберите пункт:
This app will store a copy or summary of message metadata but will not make a copy of the message body, the subject lines, or any attachments. This is disclosed in the app's privacy policy.
9. Укажите tenant ID вашей организации в Azure (узнать свой tenant ID можно в разделе Azure Active Directory)
10. Укажите Yes
11. Оставьте пустым, т.к. вы регистрируете приложение только для своей организации
12. Оставьте пустым, т.к. вы регистрируете приложение только для своей организации
13. Оставьте пустым, т.к. вы регистрируете приложение только для своей организации
Далее, Microsoft будет рассматривать заявку. Это может занять от нескольких часов до одного месяца. Ответом будет либо письмо с уточнениями, либо сообщение о том, что доступ одобрен.