Отправка уведомления веб-канала действий

Веб-канал действий Microsoft Teams помогает пользователям оценивать элементы, требующие внимания, уведомляя об изменениях. Чтобы расширить функциональные возможности приложения, вы можете использовать API уведомлений веб-канала действий в Microsoft Graph.

Ключевые функции трансляции канала действий

Обеспечивает расширенный интерфейс.
Следить за обновлениями пользователей.
Транслирует сообщение для всех участников.
Отображает уведомление веб-канала действий.
Транслирует сведения, доступные для участников.

Это пошаговое руководство поможет вам транслировать сообщения и уведомлять всех участников организации с помощью уведомления веб-канала действий. Вы увидите следующие выходные данные:

Снимок экрана: выходные данные широкого приведения канала

Снимок экрана: окончательные выходные данные

Предварительные требования

Осталось 9 мин

Убедитесь, что вы установили следующие средства и настроили среду разработки:

	Установка	Для использования...
	Visual Studio 2022 версии 17.3	Вы можете установить корпоративную версию в Visual Studio 2022, а также рабочие нагрузки ASP.NET и веб-разработки. Используйте последнюю версию.
	Пакет SDK для .NET Core версии 3.1	Настраиваемые привязки для локальной отладки и Функции Azure развертываний приложений. Если вы не установили пакет SDK для .NET 3.1 (или более поздней версии) глобально, переносимая версия для установки.
	ngrok	Функции приложений Teams (диалоговые боты, расширения сообщений и входящие веб-перехватчики) требуют входящих подключений. Туннель соединяет систему разработки с Teams. Он не требуется для приложений, которые содержат только вкладки. Этот пакет устанавливается в каталоге проекта (с помощью npm `devDependencies`).

Примечание.

После скачивания ngrok зарегистрируйтесь и установите authtoken.

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

Учетная запись Майкрософт.
Приложение Teams должно быть установлено для получателя лично, в команде или чате.
Идентификатор клиента для отправки и получения уведомлений должен совпадать.

Настройка клиента разработки Teams

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

Проверка параметра отправки пользовательских приложений

После создания приложения необходимо загрузить это приложение в Teams, не распространяя его. Функция называется отправкой пользовательского приложения. Войдите в учетную запись Microsoft 365, чтобы просмотреть этот параметр.

Примечание.

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

У вас уже есть клиент и есть ли у вас доступ администратора? Давайте проверка, если вы действительно делаете!

Чтобы проверить настраиваемую отправку приложений в Teams, выполните приведенные далее действия.

 1. In the Teams client, select the **Apps** icon.
 1. Select **Manage your apps**.
 1. Select **Upload an app**.
 1. Look for the option to **Upload a custom app**.

    :::image type="content" source="~/assets/images/teams-toolkit-v2/prerequisites/upload-app.png" alt-text="Screenshot shows the custom upload app in Teams.":::

> [!NOTE]
> Contact Teams administrator, if you can't upload a custom app.

Создание бесплатного клиента разработчика Teams (необязательно)

Если у вас нет учетной записи разработчика Teams, ее можно получить бесплатно. Присоединяйтесь к программе для разработчиков Microsoft 365!

Перейдите в программу для разработчиков Microsoft 365.
Выберите Присоединиться и следуйте инструкциям на экране.
Выберите Настроить подписку E5 на экране приветствия.
Настройка учетной записи администратора. После завершения отобразится следующий экран.
Войдите в Teams с помощью новой учетной записи администратора. Теперь можно выбрать Отправить пользовательское приложение.

Настройка локальной среды

Осталось 8 мин

Откройте примеры Microsoft Teams.
Выберите Код.
В раскрывающемся меню выберите Открыть с помощью GitHub Desktop.
Выберите Клонировать.

Регистрация единого входа в Teams Auth с помощью идентификатора Microsoft Entra

Осталось 7 мин

Следующие действия помогут вам создать и зарегистрировать единый вход проверки подлинности Teams в портал Azure.

Создание и регистрация нового приложения в Регистрация приложений
Использование ngrok для создания туннеля к конечным точкам веб-сервера

Создание и регистрация нового приложения

Перейдите на портал Azure. Система предложит вам войти с учетными данными учетной записи Майкрософт.
Выберите идентификатор Microsoft Entra.
В области навигации слева выберите Регистрация приложений.
Выберите Новая регистрация.

Откроется страница регистрации приложения.
Введите следующие сведения, чтобы зарегистрировать приложение.
1. Задайте имя приложения
2. Задайте для параметра Поддерживаемые типы учетных записей любой тип учетной записи.
3. Оставьте URI перенаправления пустым.
Нажмите Зарегистрировать.

Откроется страница "Обзор приложения".

Важно!

Сохраните идентификатор приложения (клиента) и идентификатор каталога (клиента) для дальнейшего использования.

Создание туннеля для локального веб-сервера

Используйте ngrok или командную строку для создания туннеля к общедоступным конечным точкам HTTPS локального веб-сервера. Выполните следующую команду в ngrok:

ngrok http --host-header=localhost 3978

Снимок экрана: создание туннеля в ngrok.

Совет

Если вы столкнулись с ERR_NGROK_4018, выполните действия, описанные в командной строке, чтобы зарегистрироваться и проверить подлинность ngrok. Затем выполните ngrok http --host-header=localhost 3978 команду .

Обновление регистрации приложения Microsoft Entra

Осталось 6 мин

В области навигации слева выберите Предоставить API.
Нажмите Добавить.
Задайте универсальный код ресурса (URI) идентификатораapi://{AppID}приложения в формате .
WebAppDomain Вставьте значение между api:// и /{AppID}.
api:// your ngrok/{AppID}

На следующем рисунке показано доменное имя:

Примечание.

Если вы используете службу туннелирования, например ngrok, обязательно обновляйте значение при каждом изменении поддомена ngrok. For example: api://f631****.ngrok.io/c4e88a5d-e3d4-47f4-accb-0ef9de3bce8a, где f631****.ngrok.io — имя нового поддомена ngrok.
Нажмите Добавить область.

Откроется страница добавления область.
Введите данные для конфигурации области действия.
1. Введите access_as_user в качестве имени области.
Примечание.

Имя области должно совпадать с URI идентификатора приложения с /access_as_user добавлением в конце.
api://bff2****.ngrok.io/00000000-0000-0000-0000-000000000000/access_as_user.
1. Укажите , кто может предоставить согласиеадминистраторам и пользователям.
2. Чтобы настроить запросы согласия администратора и пользователя с соответствующими значениями для access_as_user область, укажите в полях следующие сведения:
  - Введите, что Teams может получить доступ к профилю пользователяв качестве отображаемого имени Администратор согласия
  - Введите Позволяет Teams вызывать веб-API приложения в качестве текущего пользователя в качестве Администратор описание согласия.
  - Введите, что Teams может получить доступ к профилю пользователя и отправлять запросы от имени пользователя в качестве отображаемого имени согласия пользователя.
  - Введите Включить Teams для вызова API этого приложения с теми же правами , что и у пользователя, в описании согласия пользователя.
3. Убедитесь, что параметру Состояние присвоено значение Включено.
4. Выберите Добавить область для сохранения.
URI идентификатора приложения создается с область именем.
В разделе Авторизованные клиентские приложения укажите приложения, которые необходимо авторизовать для веб-приложения вашего приложения.
Выберите Добавить клиентское приложение.

Откроется область добавления клиентского приложения.

Введите идентификатор клиента для классического и веб-приложения отдельно, для которого требуется авторизоваться. Это идентификатор клиентского приложения, которое вы хотите авторизовать.

Идентификатор клиента	Для авторизации
`1fec8e78-bce4-4aaf-ab1b-5451cc387264`	Классическое или мобильное приложение Teams
`5e3ce6c0-2b1f-4285-8d4b-75ee78787346`	Веб-приложение Teams

Выберите Авторизованные области , чтобы определить тип маркера, возвращающего службу.

На следующем рисунке отображается идентификатор клиента:
В левой области выберите Разрешения API.

Примечание.

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

Откроется страница разрешения 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
Выберите Добавить разрешения.
Обязательно предоставьте согласие администратора для необходимых разрешений.
В левой области выберите Проверка подлинности , чтобы задать URI перенаправления.

Примечание.

Если приложению не предоставлено согласие ИТ-администратора, пользователи должны предоставить согласие при первом использовании приложения.
1. Выберите Добавить платформу.
2. Для работы с этим руководством выберите Интернет.
3. Введите URI перенаправления для приложения, добавив Auth/end к полному доменному имени:
  https://ngrok.io/Auth/end.
4. Включите неявное предоставление и гибридные потоки , установив следующие флажки:
  - Маркеры идентификаторов
  - Маркеры доступа
5. Нажмите Настроить.
6. Выберите Добавить URI и введите https://ngrok.io/Auth/Start.
7. Нажмите кнопку Сохранить.

Создание секрета клиента

В левой области выберите Сертификаты & секреты.
В разделе Секреты клиента выберите Новый секрет клиента.

Откроется окно Добавление секрета клиента .
Введите значение в поле Описание.
Нажмите Добавить.
В столбце Значение выберите Копировать в буфер обмена.

Важно!

Сохраните значение Секреты клиента или пароль приложения для дальнейшего использования.

Настройка параметров приложения и файлов манифеста

Осталось 5 мин

Перейдите в файл 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].

Сборка и запуск службы

Осталось 4 мин

Откройте Visual Studio.
Перейдите в раздел Файл>Открыть>проект или решение....
Выберите Файл ActivityFeedBroadcast.sln из папки csharp .
Выберите Открыть.
Нажмите клавишу F5 , чтобы запустить проект.
Выберите Да, если появится следующий диалог:

Откроется веб-страница с сообщением " Ваш бот готов!

Добавление приложения трансляции канала действий в Teams

Осталось 3 мин

В клонированного репозитория перейдите к graph-activity-feed-broadcast>csharp>ActivityFeedBroadcast>AppPackage.
Создайте файл .zip со следующими файлами, которые находятся в папке AppPackage :
- manifest.json
- outline.png
- color.png
Перейдите в Microsoft Teams.
Выберите Приложения>Управление приложениями.
Выберите Отправить приложение в организацию.
Нажмите кнопку Открыть , чтобы отправить файл .zip, созданный в папке AppPackage .
Нажмите Добавить.

Приложение отображается в собрании SidePanel.

Взаимодействие с приложением в Teams

Осталось 2 мин

Давайте взаимодействовать с приложением в Teams!

В BroadcastTab отображаются заголовок сообщения и описание сообщения.
Введите заголовок и описание сообщения, а затем выберите Отправить сообщение.

Сообщение успешно отображается.
Уведомление веб-канала действий отображается на вкладке Действие получателя с тем же идентификатором клиента.
При выборе сообщения отображаются сведения о сообщении.