Отправка упреждающих сообщений
Упреждающее сообщение — это сообщение, отправленное ботом в ответ на простые команды, отправленные пользователем в чате. Ответ на сообщение может быть в одном из следующих форматов:
- Приветствия
- Запланированные сообщения
- Уведомления
Это пошаговое руководство поможет вам отправить упреждающее сообщение от бота. Вы увидите следующие выходные данные:
Предварительные условия
Убедитесь, что установлены следующие средства для создания и развертывания приложений.
| Установка | Для использования | |
|---|---|---|
| Microsoft Visual Studio Code | JavaScript или TypeScript— среды сборки. Используйте последнюю версию. | |
| Набор средств Microsoft Teams | Visual Studio Code расширение, которое создает шаблон проекта для приложения. Используйте последнюю версию. | |
| Node.js | Серверной среды выполнения JavaScript. Дополнительные сведения см . вNode.js таблице совместимости версий для типа проекта. | |
| Microsoft Teams | Команды для совместной работы со всеми пользователями с помощью приложений для чата, собраний, звонков и всех в одном месте. | |
| Microsoft Edge (рекомендуется) или Google Chrome | Браузера со средствами разработчика. | |
| Учетная запись разработчика Microsoft 365 | Доступ к учетной записи Teams с соответствующими разрешениями для установки приложения. |
Подготовка среды разработки
После установки необходимых средств настройте среду разработки.
Установка набора средств Teams
Microsoft Teams Toolkit помогает упростить процесс разработки с помощью средств для подготовки и развертывания облачных ресурсов для приложения и публикации в Магазине Teams.
Набор средств Teams можно использовать с Visual Studio Code или интерфейсом командной строки с именем TeamsFx CLI.
Откройте Visual Studio Code и выберите Расширения (CTRL+SHIFT+X или Просмотреть>расширения).
В поле поиска введите Набор средств Teams.
Нажмите кнопку Установить.
Значок Набора средств
Teams отображается на панели действий Visual Studio Code.
Вы также можете установить Набор средств Teams из Visual Studio Code Marketplace.
Настройка клиента разработки Teams
Клиент — это пространство или контейнер для вашей организации в Teams, где вы общаетесь, обмениваются файлами и выполняете собрания. В этом пространстве также можно отправить и протестировать приложение. Давайте проверим, готовы ли вы к разработке с помощью клиента.
Проверка параметра отправки приложения
После создания пользовательского приложения необходимо отправить приложение в Teams с помощью параметра Отправить пользовательское приложение . Войдите в учетную запись Microsoft 365, чтобы проверка, если этот параметр включен.
Следующие действия помогут вам проверить, можно ли отправлять приложения в Teams.
В клиенте Teams щелкните значок Приложения .
Выберите Управление приложениями
Выберите Отправить приложение.
Найдите параметр Отправить пользовательское приложение. Если параметр отображается, можно отправить пользовательские приложения.
Примечание.
Если вы не нашли параметр для отправки пользовательского приложения, обратитесь к администратору Teams.
Создание бесплатного клиента разработчика Teams (необязательно)
Если у вас нет учетной записи разработчика Teams, присоединитесь к программе разработчика Microsoft 365.
Перейдите в программу для разработчиков Microsoft 365.
Выберите Присоединиться и следуйте инструкциям на экране.
На экране приветствия выберите Настроить подписку E5.
Настройте свою учетную запись администратора. После завершения отобразится следующий экран:
Войдите в Teams с помощью только что настроенной учетной записи администратора. Убедитесь, что у вас есть параметр Отправить пользовательское приложение в Teams.
Создание упреждающего бота сообщений
Чтобы создать упреждающего бота сообщений с помощью Visual Studio Code, выполните следующие действия.
Откройте Visual Studio Code.
Щелкните значок Набора средств
Teams на панели действий Visual Studio Code.В левой области выберите Просмотреть примеры.
В списке примеров выберите Упреждающий обмен сообщениями. Откроется готовый пример, готовый к отладке.
Нажмите Создать.
Выберите Папка по умолчанию , чтобы сохранить корневую папку проекта в расположении по умолчанию.
Если вы хотите изменить расположение по умолчанию, выполните следующие действия.
Нажмите кнопку Обзор.
Выберите расположение рабочей области проекта.
Выберите Выбрать папку.
Бот упреждающих сообщений создается в течение нескольких секунд и отображает успешное диалоговое окно бота с упреждающим сообщением в правом нижнем углу с параметром отладки:
:::Выберите значок Выполнить и отладку
в левом верхнем углу.Выберите Отладка (Edge) или Отладка (Chrome) в раскрывающемся списке.
При успешной отладке вам будет предложено отправить упреждающее сообщение бота в Teams на локальном компьютере.
Нажмите Добавить.
Найдите и выберите необходимый область или выберите канал, чат или собрание из списка, а затем перейдите через диалоговое окно, чтобы выбрать Перейти.
Приложение бота с упреждающим сообщением отправляется в клиент Teams, и в ответ на отправленное сообщение появляется следующее сообщение.
Скопируйте и вставьте URL-адрес или перейдите по URL-адресу в браузере. В чате активируется упреждающее сообщение hello.
Перейдите в Teams. Вы получите упреждающее приветственное сообщение от бота.
Знакомство с исходным кодом
Набор средств Teams предоставляет компоненты для создания приложения. После создания проекта можно просмотреть папки и файлы проекта в области проводника Visual Studio Code.
Папка нового проекта содержит следующее содержимое:
| Папка и файл | Содержание |
|---|---|
.vscode/ |
Visual Studio Code файлы для отладки. |
appManifest/ |
Шаблоны для манифеста приложения (ранее — манифест приложения Teams). |
env/ |
Пары "имя-значение" хранятся в файлах среды и используются для teamsapp.yml настройки правил подготовки и развертывания. |
manifest.json |
Манифест приложения для публикации на портале разработчика для Teams хранится в Properties/manifest.json. |
teamsapp.yml |
Основной файл проекта описывает конфигурацию приложения и определяет набор действий, выполняемых на каждом этапе жизненного цикла. |
teamsapp.local.yml |
Это переопределяет teamsapp.yml действия, которые обеспечивают локальное выполнение и отладку. |
Развертывание упреждающего бота сообщений
Вы научились создавать и запускать приложение Teams с возможностью упреждающего бота сообщений. Давайте развернем первое приложение с возможностью упреждающего бота сообщений в Azure с помощью набора средств Teams.
Вход в учетную запись Azure
Используйте свою учетную запись для доступа к портал Azure Майкрософт и подготовки новых облачных ресурсов для поддержки приложения.
Откройте Visual Studio Code.
Откройте папку проекта, в которой вы создали приложение бота для упреждающих сообщений.
Щелкните значок Набора средств
Teams на панели действий Visual Studio Code.Выберите Войти в Azure с помощью учетных данных.
Совет
Если у вас установлено расширение учетной записи AZURE и вы используете ту же учетную запись, этот шаг можно пропустить.
Откроется веб-браузер по умолчанию, чтобы позволить вам войти в учетную запись.
Закройте браузер при появлении запроса и вернитесь к Visual Studio Code.
В разделе ACCOUNTS боковой панели отображаются две учетные записи по отдельности. В нем также отображается количество доступных для использования подписок Azure. Убедитесь, что у вас есть по крайней мере одна доступная подписка Azure. В противном случае выйдите из нее и используйте другую учетную запись.
Развертывание приложения в Azure
Развертывание состоит из двух этапов. Во-первых, создаются необходимые облачные ресурсы (также известные как подготовка). Затем код приложения копируется в созданные облачные ресурсы. В этом руководстве вы развернете приложение бота.
В чем разница между подготовкой и развертыванием?
Подготовка создает ресурсы в Azure и Microsoft 365 для приложения, но код (HTML, CSS и JavaScript) не копируется в ресурсы. При развертывании код приложения копируется в ресурсы, созданные во время подготовки. Обычно развертывание выполняется несколько раз без подготовки новых ресурсов. Так как подготовка может занять некоторое время, она отделена от развертывания.
Щелкните значок Набора средств
Teams на панели действий Visual Studio Code.Выберите Подготовка в разделе ЖИЗНЕННЫЙ ЦИКЛ.
Выберите одну из существующих подписок.
Выберите существующую группу ресурсов или создайте новую группу ресурсов. Дополнительные сведения см. в статье Создание группы ресурсов.
Примечание.
Появится диалоговое окно с указанием того, что при выполнении ресурсов в Azure могут возникнуть затраты.
Выберите Подготовка.
Процесс подготовки создает ресурсы в облаке Azure. Ход выполнения можно отслеживать в диалоговых окнах, отображаемых в правом нижнем углу. Через несколько минут появится следующее диалоговое окно:
Выберите Развернуть в разделе ЖИЗНЕННЫЙ цикл.
Нажмите Развернуть.
Развертывание занимает некоторое время. Ход выполнения можно отслеживать в диалоговых окнах, отображаемых в правом нижнем углу. Через несколько минут появится следующее диалоговое окно.
Откройте панель отладки (CTRL+SHIFT+D️ / ⇧-D или Просмотр>запуска) из Visual Studio Code.
Выберите Запустить удаленный (edge) в раскрывающемся списке конфигурация запуска.
После успешной отладки вам будет предложено отправить приложение бота с упреждающим сообщением в Teams.
Нажмите Добавить.
Найдите и выберите необходимый область или выберите канал, чат или собрание из списка, а затем перейдите через диалоговое окно, чтобы выбрать Перейти.
Приложение бота с упреждающим сообщением отправляется в клиент Teams, и в ответ на отправленное сообщение появляется следующее сообщение.
Скопируйте и вставьте URL-адрес или перейдите по URL-адресу в браузере. В чате активируется упреждающее сообщение hello.
Перейдите в Teams. Вы получите упреждающее приветственное сообщение от бота.
Выполнение задачи
Ты придумала что-то вроде этого?
Поздравляем!
Вы завершили сценарий.
- Вы можете отправлять уведомления ежедневно или запрашивать отзывы пользователей на периодической основе.
- Вы можете обработать ограничения регулирования, чтобы избежать нескольких уведомлений.
Возникла проблема с этим разделом? Если это так, отправьте нам отзыв, чтобы мы исправили этот раздел.
Platform Docs