Отправка уведомления веб-канала действий
Уведомление веб-канала действий Microsoft Teams помогает пользователям оценивать элементы, требующие внимания, уведомляя об изменениях. Чтобы расширить функциональность уведомлений веб-канала действий в приложении, используйте API-интерфейсы уведомлений веб-канала действий в Microsoft Graph.
Основные функции трансляции канала действий:
- Обеспечивает расширенный интерфейс.
- Следить за обновлениями пользователей.
- Транслирует сообщение для всех участников.
- Отображает уведомление веб-канала действий.
- Транслирует сведения, доступные для участников.
Это пошаговое руководство поможет вам транслировать сообщения и уведомлять всех участников организации с помощью уведомления веб-канала действий. Вы увидите следующие выходные данные:
Предварительные условия
Убедитесь, что вы установили следующие средства и настроили среду разработки:
| Установка | Для использования... | |
|---|---|---|
| Visual Studio 2022 | Вы можете установить корпоративную версию в Visual Studio 2022 и рабочие нагрузки ASP.NET и веб-разработки. Используйте последнюю версию. | |
| Пакет SDK для .NET Core версии 3.1 | Настраиваемые привязки для локальной отладки и Функции Azure развертываний приложений. Используйте последнюю версию или установите переносимую версию. | |
| Туннель разработки | Функции приложений Teams (диалоговые боты, расширения сообщений и входящие веб-перехватчики) требуют входящих подключений. Туннель соединяет систему разработки с Teams. Туннель разработки — это мощный инструмент для безопасного открытия локального узла в Интернете и контроля доступа. Туннель разработки доступен в Visual Studio 2022 версии 17.7.0 или более поздней. Вы также можете использовать ngrok в качестве туннеля для подключения системы разработки к Teams. Он не требуется для приложений, которые содержат только вкладки. Этот пакет устанавливается в каталоге проекта (с помощью npm devDependencies). |
Примечание.
После скачивания ngrok зарегистрируйтесь и установите authtoken.
Убедитесь, что у вас есть следующие учетные записи и настройте среду разработки:
- Учетная запись Майкрософт.
- Приложение Teams должно быть установлено для получателя лично, в команде или чате.
- Идентификатор клиента для отправки и получения уведомлений должен совпадать.
Настройка клиента разработки Teams
Клиент похож на пространство или контейнер, в котором вы общаетесь, обмениваются файлами и выполняете собрания для своей организации в Teams. Вы также можете отправить и протестировать пользовательское приложение.
Проверка параметра отправки пользовательских приложений
После создания приложения необходимо загрузить это приложение в Teams, не распространяя его. Функция называется отправкой пользовательского приложения. Войдите в учетную запись Microsoft 365, чтобы просмотреть этот параметр.
Примечание.
Отправка пользовательских приложений необходима для предварительного просмотра и тестирования приложений в локальной среде Teams. Включите отправку пользовательских приложений для предварительного просмотра и тестирования приложения в Teams локально.
У вас уже есть клиент и есть ли у вас доступ администратора? Давайте проверка, если вы действительно делаете!
Чтобы проверить настраиваемую отправку приложений в Teams, выполните приведенные далее действия.
В клиенте Teams щелкните значок Приложения .
Выберите Управление приложениями
Выберите Отправить приложение.
Найдите параметр Отправить пользовательское приложение.
Примечание.
Если не удается отправить пользовательское приложение, обратитесь к администратору Teams.
Create бесплатного клиента разработчика Teams (необязательно)
Если у вас нет учетной записи разработчика Teams, ее можно получить бесплатно. Присоединяйтесь к программе для разработчиков Microsoft 365!
Перейдите в программу для разработчиков Microsoft 365.
Выберите Присоединиться и следуйте инструкциям на экране.
Выберите Настроить подписку E5 на экране приветствия.
Настройка учетной записи администратора. После завершения отобразится следующий экран.
Войдите в Teams с помощью новой учетной записи администратора. Теперь можно выбрать Отправить пользовательское приложение.
Настройка локальной среды
Откройте Microsoft-Teams-Samples.
Выберите Код.
В раскрывающемся меню выберите Открыть с помощью GitHub Desktop.
Выберите Клонировать.
Регистрация единого входа в Teams Auth в Microsoft Entra ID
Следующие действия помогут вам создать и зарегистрировать единый вход проверки подлинности Teams в портал Azure.
- Create и зарегистрируйте новое приложение в Регистрация приложений.
- Используйте ngrok для создания туннеля к конечным точкам веб-сервера.
Добавление регистрации приложения
Перейдите к портал Azure.
Выберите Регистрация приложений.
Выберите + Новая регистрация.
Введите имя приложения.
Выберите Учетные записи в любом каталоге организации (любой клиент Microsoft Entra ID — мультитенантный).
Нажмите Зарегистрировать.
Приложение зарегистрировано в Microsoft Entra ID. Откроется страница обзора приложения.
Примечание.
Сохраните идентификатор приложения из идентификатора приложения (клиента) и каталога (клиента) для дальнейшего использования.
Create туннеля
Откройте Visual Studio.
Выберите Create новый проект.
В поле поиска введите ASP.NET. В результатах поиска выберите ASP.NET Core Веб-приложение.
Нажмите кнопку Далее.
Введите имя проекта и нажмите кнопку Далее.
Нажмите Создать.
Откроется окно обзора.
В раскрывающемся списке отладки выберите Dev Tunnels (без активного туннеля)>Create tunnel....
Открывается всплывающее окно.
Обновите следующие сведения во всплывающем окне:
- Учетная запись. Введите учетную запись Майкрософт или GitHub.
- Имя: введите имя туннеля.
- Тип туннеля: в раскрывающемся списке выберите Временный.
- Доступ: в раскрывающемся списке выберите Общедоступный.
Нажмите OK.
Появится всплывающее окно, показывающее, что туннель разработки успешно создан.
Нажмите OK.
Созданный туннель можно найти в раскрывающемся списке отладки следующим образом:
Нажмите клавишу F5 , чтобы запустить приложение в режиме отладки.
Если появится диалоговое окно Предупреждение системы безопасности , выберите Да.
Открывается всплывающее окно.
Нажмите Продолжить.
В новом окне браузера откроется домашняя страница туннеля разработки, и туннель разработки теперь активен.
Перейдите в Visual Studio и выберите Просмотреть выходные > данные.
В раскрывающемся меню консоли вывода выберите Dev Tunnels (Туннели разработки).
В консоли вывода отображается URL-адрес туннеля разработки.
Добавление URI идентификатора приложения
В области слева в разделе Управление выберите Предоставить API.
Рядом с полем URI идентификатора приложения нажмите кнопку Добавить.
Обновите URI идентификатора
api://your-devtunnel-domain/botid-{AppID}приложения в формате илиapi://your-ngrok-domain/botid-{AppID}и нажмите кнопку Сохранить.
На следующем рисунке показано доменное имя:
Примечание.
Если вы используете службу туннелирования, например ngrok, обязательно обновляйте значение при каждом обновлении поддомена ngrok. Например, api://f631****.ngrok.io/c4e88a5d-e3d4-47f4-accb-0ef9de3bce8a, где f631****.ngrok.io — это имя нового поддомена ngrok.
Добавление область
В области слева в разделе Управление выберите Предоставить API.
Выберите + Добавить область.
Введите access_as_user в качестве имени области.
В разделе Кто может предоставить согласие? выберите Администраторы и пользователи.
Обновите значения остальных полей следующим образом:
Введите Teams может получить доступ к профилю пользователякак Администратор отображаемое имя согласия.
Введите Позволяет Teams вызывать веб-API приложения в качестве текущего пользователяв качестве Администратор описание согласия.
Введите Teams для доступа к профилю пользователя и отправлять запросы от имени пользователя в качестве отображаемого имени согласия пользователя.
Введите Включить Teams для вызова API этого приложения с теми же правами, что и у пользователя , в описании согласия пользователя.
Убедитесь, что параметру Состояние присвоено значение Включено.
Нажмите кнопку Добавить область.
На следующем рисунке показаны поля и значения:
Примечание.
Имя области должно совпадать с URI идентификатора приложения с
/access_as_userдобавлением в конце.
Добавление клиентского приложения
В области слева в разделе Управление выберите Предоставить API.
В разделе Авторизованные клиентские приложения определите приложения, которые вы хотите авторизовать для веб-приложения вашего приложения.
Выберите + Добавить клиентское приложение.
Добавьте мобильное или классическое приложение Teams и веб-приложение Teams.
Для мобильных или классических приложений Teams: введите идентификатор клиента как
1fec8e78-bce4-4aaf-ab1b-5451cc387264.
Для веб-сайта Teams: введите идентификатор клиента как
5e3ce6c0-2b1f-4285-8d4b-75ee78787346.
Установите флажок Авторизованные области .
Нажмите кнопку Добавить приложение.
На следующем рисунке отображается идентификатор клиента:
Добавление разрешения API
В области слева в разделе Управление выберите Разрешения API.
Выберите + Добавить разрешение.
Выберите Microsoft Graph.
Выберите Делегированные разрешения.
Выберите следующие разрешения:
Directory.Read.All
Directory.ReadWrite.All
TeamsActivity.Send
TeamsAppInstallation.ReadForUser
TeamsAppInstallation.ReadWriteForUser
User.Read
Примечание.
Пользователя. Чтение включено по умолчанию.
Выберите Добавить разрешения.
Выберите + Добавить разрешение.
Выберите Microsoft Graph.
Выберите Разрешения приложения.
Выберите следующие разрешения:
- Directory.Read.All
- TeamsActivity.Send
- TeamsAppInstallation.ReadForUser.All
Выберите Добавить разрешения.
Обязательно предоставьте согласие администратора для необходимых разрешений.
Обязательно предоставьте согласие администратора для необходимых разрешений.
Примечание.
- Если приложению не предоставлено согласие ИТ-администратора, пользователи должны предоставить согласие при первом использовании приложения.
- Пользователи должны согласиться на разрешения API только в том случае, если приложение Microsoft Entra зарегистрировано в другом клиенте.
Добавление веб-проверки подлинности
В левой области в разделе Управление выберите Проверка подлинности.
Выберите Добавить одностраничноеприложение платформы>.
Введите URI перенаправления для приложения, добавив
auth-endк полному доменному имени. Например,https://your-devtunnel-domain/auth-endилиhttps://your-ngrok-domain/auth-end.В разделе Неявное предоставление и гибридные потоки установите флажки Маркеры доступа и маркеры идентификаторов .
Нажмите Настроить.
В разделе Интернет выберите Добавить URI.
Введите
https://token.botframework.com/.auth/web/redirect.Выберите Сохранить.
Создание секрета клиента
В левой области в разделе Управление выберите Сертификаты & секреты.
В разделе Секреты клиента выберите + Новый секрет клиента.
Откроется окно Добавление секрета клиента .
Введите Описание.
Нажмите Добавить.
В разделе Значение выберите Копировать в буфер обмена , чтобы сохранить значение секрета клиента для дальнейшего использования.
Настройка параметров приложения
Перейдите к appsettings.json файлу в клонированного репозитория.
Откройте файл appsettings.json в последней версии Visual Studio и обновите следующие сведения:
Задайте
"MicrosoftAppId"для бота идентификатор приложения Майкрософт.Задайте значение
"TenantID"Идентификатор каталога (клиента).Задайте
"MicrosoftAppPassword"значение идентификатора секрета клиента бота.Задайте значение
"BaseUrl"[WebAppDomainName].
Настройка файла манифеста
Перейдите к файлу manifest.json в клонированного репозитория.
Откройте файл manifest.json в последней версии Visual Studio и внесите следующие изменения:
Замените все вхождения
<<Microsoft-App-ID>>идентификатором приложения Microsoft бота.Замените все вхождения
<<Base_URL>>на полное доменное имя.Задайте значение
validDomains[WebAppDomainName].
Сборка и запуск службы
Откройте Visual Studio.
Перейдите в раздел Файл>Открыть>проект или решение....
Выберите файл ActivityFeedBroadcast.sln из папки csharp .
Выберите Открыть.
Нажмите клавишу F5 , чтобы запустить проект.
Выберите Да, если появится следующий диалог:
Откроется веб-страница с сообщением " Ваш бот готов!
Добавление приложения трансляции канала действий в Teams
В клонированного репозитория перейдите в раздел graph-activity-feed-broadcast>csharp>ActivityFeedBroadcast>AppManifest.
Create файл .zip со следующими файлами, которые находятся в папке AppManifest:
manifest.json
outline.png
color.png
В клиенте Teams щелкните значок Приложения .
Выберите Управление приложениями
Выберите Отправить приложение в организацию.
Выберите Открыть , чтобы отправить файл .zip, созданный в папку AppManifest .
Нажмите Добавить.
Взаимодействие с приложением в Teams
Давайте взаимодействовать с приложением в Teams!
В BroadcastTab отображаются заголовок сообщения и описание сообщения.
Введите заголовок и описание сообщения**.
Выберите Отправить сообщение.
Сообщение успешно отображается.
Уведомление веб-канала действий отображается на вкладке Действие получателя с тем же идентификатором клиента.
При выборе сообщения отображаются сведения о сообщении.
Выполнение задачи
Ты придумала что-то вроде этого?
Поздравляем!
Вы завершили руководство, чтобы приступить к работе с приложением трансляции веб-канала действий !
Возникла проблема с этим разделом? Если это так, отправьте нам отзыв, чтобы мы исправили этот раздел.
Platform Docs
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по