Создание исходящих веб-перехватчиков
Важно!
Существующие соединители Microsoft 365 (ранее — Office 365) на всех облачных платформах почти устареют, и создание новых соединителей Microsoft 365 вскоре будет заблокировано. Дополнительные сведения о расписании и о том, как приложение "Рабочие процессы" обеспечивает более гибкий и безопасный интерфейс, см. в статье Прекращение использования соединителей Microsoft 365 в Microsoft Teams.
Веб-перехватчики помогают Microsoft Teams интегрироваться с внешними приложениями. В Teams исходящие веб-перехватчики выполняют роль бота и выполняют поиск сообщений в каналах с помощью @mention. Исходящие веб-перехватчики позволяют пользователям отправлять сообщения в веб-службы без выполнения всего процесса создания ботов с помощью Microsoft Bot Framework. Исходящие веб-перехватчики публикуют данные из Teams в любую службу, которая может принимать полезные данные JSON.
Основные функции исходящих веб-перехватчиков
- Отправка уведомлений в любую внешнюю веб-службу.
- Отвечайте с помощью форматированных текстовых сообщений, включая карточки и изображения.
- Получать сообщения в общедоступных каналах, а не в личной или частной области.
- Отправьте HTTP POST в веб-службу и получите ответ.
Примечание.
Исходящие веб-перехватчики не могут получить доступ к другим API, например получить список или список каналов в команде.
Это пошаговое руководство поможет вам создать исходящие веб-перехватчики в Teams. Вы увидите следующие выходные данные:
Предварительные требования
Убедитесь, что установлены следующие средства и настроена среда разработки:
| Установка | Для использования... | |
|---|---|---|
| Microsoft Teams | Microsoft Teams позволяет взаимодействовать со всеми пользователями, с которыми вы работаете, с помощью приложений для чата, собраний и звонков в одном месте. | |
| Visual Studio 2022 | Вы можете установить корпоративную версию в Visual Studio 2022, а также рабочие нагрузки ASP.NET и веб-разработки. Используйте последнюю версию. | |
| Туннель разработки | Функции приложений Teams (диалоговые боты, расширения сообщений и входящие веб-перехватчики) требуют входящих подключений. Туннель соединяет систему разработки с Teams. Туннель разработки — это мощный инструмент для безопасного открытия локального узла в Интернете и контроля доступа. Туннель разработки доступен в Visual Studio 2022 версии 17.7.0 или более поздней. или вы также можете использовать ngrok в качестве туннеля для подключения системы разработки к Teams. Он не требуется для приложений, которые содержат только вкладки. Этот пакет устанавливается в каталоге проекта (с помощью npm devDependencies). |
Примечание.
После скачивания ngrok зарегистрируйтесь и установите authtoken.
Настройка локальной среды
Откройте Microsoft-Teams-Samples.
Выберите Код.
В раскрывающемся меню выберите Открыть с помощью GitHub Desktop.
Выберите Клонировать.
Создание исходящих веб-перехватчиков
Создание туннеля
Откройте Visual Studio.
Выберите Создать новый проект.
В поле поиска введите ASP.NET. В результатах поиска выберите ASP.NET Core Web App.
Нажмите кнопку Далее.
Введите имя проекта и нажмите кнопку Далее.
Нажмите Создать.
Откроется окно обзора.
В раскрывающемся списке отладки выберите Dev Tunnels (без активного туннеля)>Создать туннель....
Открывается всплывающее окно.
Обновите следующие сведения во всплывающем окне:
- Учетная запись. Введите учетную запись Майкрософт или GitHub.
- Имя: введите имя туннеля.
- Тип туннеля: в раскрывающемся списке выберите Временный.
- Доступ: в раскрывающемся списке выберите Общедоступный.
Нажмите OK.
Появится всплывающее окно, показывающее, что туннель разработки успешно создан.
Нажмите OK.
Созданный туннель можно найти в раскрывающемся списке отладки следующим образом:
Нажмите клавишу F5 , чтобы запустить приложение в режиме отладки.
Если появится диалоговое окно Предупреждение системы безопасности , выберите Да.
Открывается всплывающее окно.
Нажмите Продолжить.
В новом окне браузера откроется домашняя страница туннеля разработки, и туннель разработки теперь активен.
Перейдите в Visual Studio и выберите Просмотреть выходные > данные.
В раскрывающемся меню консоли вывода выберите Dev Tunnels (Туннели разработки).
В консоли вывода отображается URL-адрес туннеля разработки.
Перейдите к Teams и выберите Teams в области слева.
Перейдите к нужной команде, выберите Дополнительные параметры (•••), а затем выберите Управление командой.
Выберите вкладку Приложения на панели навигации.
Выберите Создать исходящий веб-перехватчик в правом нижнем углу окна.
Введите следующие сведения:
Имя: заголовок веб-перехватчика на вкладке @mention .
URL-адрес обратного вызова: URL-адрес, созданный из ngrok, который принимает полезные данные JSON и получает запросы POST от Teams. Чтобы использовать
api/Sampleилиapi/authenticatedSample, сделайте следующее:Для примера API скопируйте и вставьте
dev tunnelURL-адрес илиngrokи добавьте его с/api/sampleпомощью .Для api authenticatedSample скопируйте и вставьте
dev tunnelURL-адрес илиngrokи добавьте его с/authenticatedSample?id=contosoпомощью .
Описание: подробная строка, которая отображается в карточке профиля и на панели мониторинга приложения уровня команды.
Изображение профиля (необязательно): значок приложения для веб-перехватчика.
Нажмите Создать. Исходящий веб-перехватчик добавляется в канал текущей команды.
Откроется
Hash-based Message Authentication Code (HMAC)диалоговое окно. Маркер безопасности в файле AuthProvider.cs можно использовать для проверки подлинности вызовов между Teams и любыми назначенными внешними службами.Примечание.
Исходящий веб-перехватчик доступен пользователям команды только в том случае, если URL-адрес действителен, а маркеры проверки подлинности сервера и клиента равны. Например, рукопожатие HMAC.
Сборка и запуск службы
Откройте Visual Studio.
Перейдите в раздел Файл>Открыть>проект или решение....
В папке csharp выберите WebhookSampleBot.sln файл.
Перейдите в файл AuthProvider.cs . Обновите
contosoиM365x70471008добавьте HMAC.
Нажмите клавишу F5 , чтобы запустить проект.
Выберите Да, если появится следующий диалог:
На веб-странице отображаются сведения о локальном узле.
Взаимодействие с приложением в Teams
Перейдите к Teams и выберите Teams в области слева.
Перейдите в раздел Общие>Новая беседа.
Чтобы вызвать исходящий веб-перехватчик в канале, @mention имя исходящего веб-перехватчика и щелкните значок Отправить .
Примечание.
Вы можете отправлять адаптивные карточки, карточки главного имиджевого баннера и текстовые сообщения в виде вложений с помощью исходящего веб-перехватчика.
В чате собрания отображается новое сообщение.
Выполнение задачи
Ты придумала что-то вроде этого?
Поздравляем!
Вы завершили руководство по началу работы с приложением исходящих веб-перехватчиков!
Возникла проблема с этим разделом? Если это так, отправьте нам отзыв, чтобы мы исправили этот раздел.
Platform Docs