Создание почтового робота для Microsoft TeamsBuild a bot for Microsoft Teams

В этом руководстве вы создадите базовое приложение для ленты .You'll build a basic bot app in this tutorial. Bot выступает в качестве посредника между пользователями Teams и веб-службой.A bot acts as an intermediary between Teams users and your web service. Люди могут общаться с программой-роботом, чтобы быстро получить сведения или инициировать рабочие процессы и задачи, выполняемые службой.People can chat with a bot to quickly get information or initiate workflows and tasks performed by your service.

Ваше назначениеYour assignment

Рабочая область создала приложение Teams, в котором используются вкладки для отображения важных контактных сведений.Your workplace created a Teams app that uses tabs to surface important contact information. Например, сотрудники имеют быстрый доступ к номеру телефона службы поддержки.For example, colleagues have quick access to the help desk phone number. Но не звонить, что делать, если пользователи могут обращаться в службу технической поддержки с помощью чатбот?But instead of calling, what if people could contact the help desk using a chatbot? Ваш начальник попросит узнать, как быстро можно получить основной робот и запустить его в Teams.Your boss asks you to look at how quickly you can get a basic conversational bot up and running in Teams.

Что вы узнаетеWhat you'll learn

  • Создание проекта приложения и Bot с помощью набора инструментов Microsoft Teams для Visual Studio CodeCreate an app project and bot using the Microsoft Teams Toolkit for Visual Studio Code
  • Определите некоторые конфигурации приложений и формирование шаблонов, относящихся к БотыIdentify some of the app configurations and scaffolding relevant to bots
  • Локальное размещение приложенияHost an app locally
  • Настройка почтового робота для TeamsConfigure a bot for Teams
  • Загрузка неопубликованных и тестирование ленты в TeamsSideload and test a bot in Teams

Перед началом работыBefore you begin

Если вы еще не сделали это, убедитесь, что вы знаете и установите необходимые компоненты для разработки Teams.If you haven't yet, make sure you understand and install the Teams development prerequisites.

1. Создайте проект приложения.1. Create your app project

Набор средств Microsoft Teams помогает настроить следующие компоненты для вашего приложения:The Microsoft Teams Toolkit helps you set up the following components for your app:

  • Конфигурации приложений и формирование шаблонов, относящиеся к БотыApp configurations and scaffolding relevant to bots
  • Bot , автоматически регистрируемый в службе Microsoft Azure BotBot that's automatically registered with the Microsoft Azure Bot Service

Совет

Если вы еще не создали проект приложения Teams, возможно, вам будет полезно выполнить приведенные выше инструкции по более подробному объяснению проектов.If you haven't created a Teams app project before, you might find it helpful to follow these instructions that explain projects in more detail.

  1. В Visual Studio Code выберите Microsoft Teams на левой панели активности и выберите создать приложение Teams.
  2. При появлении соответствующего запроса войдите в систему с помощью учетной записи разработчика Microsoft 365.When prompted, sign in with your Microsoft 365 development account.
  3. На экране добавить возможности выберите элемент Bot , а затем нажмите кнопку Далее.On the Add capabilities screen, select Bot then Next.
  4. Введите имя приложения Teams.Enter a name for your Teams app. (Это имя приложения по умолчанию, а также имя каталога проекта приложения на локальном компьютере.)(This is the default name for your app and also the name of the app project directory on your local machine.)
  5. Перейдите к разделу Настройка Bot и выберите создать новый робот , а затем создайте регистрацию для ленты.Go to Configure bot and select Create a new Bot then Create Bot Registration. В случае успеха новый робот будет иметь зарегистрированное состояние.If successful, your new bot will have a Registered status.
  6. В нижней части экрана нажмите кнопку Готово и выберите расположение для создания проекта.Select Finish at the bottom of the screen and choose a location to create your project.

2. определение соответствующих компонентов проекта приложения2. Identify relevant app project components

Многие конфигурации приложений и формирование шаблонов настраиваются автоматически при создании проекта с помощью набора инструментов Teams.Much of the app configurations and scaffolding are set up automatically when you create your project with the Teams Toolkit. Рассмотрим основные компоненты для создания ленты.Let's look at the main components for building a bot.

Конфигурации приложенийApp configurations

Чтобы просмотреть или изменить конфигурации ленты, выберите app Studio в наборе инструментов и перейдите к Боты.To view or update your bot's configurations, select App Studio in the toolkit and go to Bots.

Формирование шаблонов приложенийApp scaffolding

Формирование шаблонов приложений предоставляет botActivityHandler.js файл, расположенный в корневом каталоге проекта, для обработки действий ленты в Teams (например, как Bot реагирует на определенные сообщения, такие как "Hello").The app scaffolding provides a botActivityHandler.js file, located in the root directory of your project, for handling how your bot processes activities in Teams (for example, how the bot responds to specific messages such as "Hello").

3. Настройка безопасного туннеля для приложения3. Set up a secure tunnel to your app

В целях тестирования давайте разместите свое приложение на локальном веб-сервере (порт 3978).For testing purposes, let's host your app on a local web server (port 3978).

  1. Если вы еще не сделали это, установите ngrok.If you haven't already, install ngrok.
  2. В терминале запустите ngrok http -host-header=rewrite 3978 .In a terminal, run ngrok http -host-header=rewrite 3978.
  3. Скопируйте URL-адрес HTTPS в выходных данных (например, https://468b9ab725e9.ngrok.io ), так как для Teams необходимы HTTPS-подключения.Copy the HTTPS URL in the output (for example, https://468b9ab725e9.ngrok.io) since Teams requires HTTPS connections.

При использовании этого URL-адреса Teams (для которых требуются HTTPS-подключения) смогут подключаться к месту размещения приложения ( localhost на порте 3978).With this URL, Teams (which requires HTTPS connections) will be able tunnel to where you're hosting your app (localhost on port 3978).

4. Настройка ленты4. Configure your bot

Чтобы использовать Bot в Teams, необходимо зарегистрировать его в службе Azure Bot.To use a bot in Teams, you must register it with the Azure Bot Service. Счастливого Вам, это выполняется автоматически при настройке приложения с помощью набора инструментов Teams.Lucky for you, this is done automatically when you set up your app using the Teams Toolkit.

По-прежнему необходимо указать адрес конечной точки для получения и обработки сообщений пользователя (например, запросов), отправляемых в Bot.You still must specify an endpoint address to receive and process user messages (i.e., requests) sent to the bot. Как правило, URL-адрес выглядит так https://HOST_URL/api/messages :Typically, the URL looks like https://HOST_URL/api/messages. Вы можете быстро настроить его в наборе инструментов.You can configure this quickly in the toolkit.

  1. В Visual Studio Code выберите Microsoft Teams на левой панели действий, а затем выберите пункт Открыть набор средств Microsoft Teams.
  2. Перейдите в боты > существующие регистрации Bot и выберите робот, созданный во время установки.Go to Bots > Existing bot registrations and select the bot you created during setup.
  3. В поле адрес конечной точки Bot введите URL-адрес ngrok (например,), на https://468b9ab725e9.ngrok.io котором размещается Bot и добавьте /api/messages к нему.In the Bot endpoint address field, enter the ngrok URL (for example, https://468b9ab725e9.ngrok.io) where you're hosting the bot and append /api/messages to it.
    Иллюстрация, на которой показано, как настроить URL-адрес конечной точки Bot в наборе инструментов Teams.

Ваш робот сможет отвечать на сообщения в Teams.Your bot will be able to respond to messages in Teams.

5. Построение и запуск приложения5. Build and run your app

Вы настроили URL-адрес для размещения ленты и настроен для обработки сообщений.You've set up a URL to host your bot and configured it to handle messages. Самое время заставить ваше приложение работать и работать.It's time to get your app up and running.

  1. В терминале перейдите к корневому каталогу проекта приложения и запустите его npm install .In a terminal, go to the root directory of your app project and run npm install.
  2. Выполните команду npm start .Run npm start.

В случае успеха вы увидите следующее сообщение, указывающее на то, что Bot ожидает активности localhost :If successful, you see the following message indicating your bot is listening for activity at your localhost:

Bot/ME service listening at http://localhost:3978

6. Загрузка неопубликованных ваш Bot в Teams6. Sideload your bot in Teams

С помощью программы Bot вы можете установить его в Teams.With your bot running, you can install it in Teams.

Совет

Если вы еще не неопубликованные приложение Teams до и не выпустили проблемы, выполните указанные ниже действия.If you haven't sideloaded a Teams app before and run into issues, follow these instructions.

  1. В Visual Studio Code нажмите клавишу F5 , чтобы запустить веб-клиент Teams.In Visual Studio Code, press the F5 key to launch a Teams web client.
  2. В диалоговом окне Установка приложения нажмите кнопку " Добавить ".In the app install dialog, select Add for me. (Вы можете добавить робота в канал или чат, но это не является более подправной стороны для проверки ленты в одном сеансе.)(You could add the bot to a channel or chat, but it's less intrusive to others to test a bot in a one-on-one chat.)

7. Тестирование ленты7. Test your bot

Теперь скажите "Привет", чтобы приступить к развлечениям.Now for the fun part: Let's say "Hello" to your bot.

  1. В поле создать отправьте Hello сообщение.In the compose box, send a Hello message.

Ваш робот отправляется примерно следующим сообщениям.Your bot replies with something like the following message.

Снимок экрана, на котором показано, как пользователь наводит _OL_QUOTE_PLACEHOLDER_Hello_OL_QUOTE_PLACEHOLDER_ на робот команд и получает ответ.

ПрекрасноWell done

Поздравляем!Congratulations! У вас есть простая пользовательская Командная ленты Teams, которая может общаться с пользователями один-к одному или в параметрах группы (каналы и сеансы).You have a basic Teams bot that can communicate with users one-on-one or in group settings (channels and chats).

Устранение неполадокTroubleshooting

Приведенные ниже сведения помогут вам устранить проблемы, связанные с выполнением этого руководства.The following information may help if you had issues completing this tutorial.

Bot не подключены к TeamsBot isn't connected to Teams

Если вы установили приложение, но Bot не работает, убедитесь, что он подключен к каналу команд службы Azure Bot.If you installed your app but the bot isn't working, make sure the bot is connected to the Azure Bot Service's Teams channel.

Важно понимать, что это не то же самое, что и канал в Teams.It's important to understand that this isn't the same as a channel in Teams. В этом случае каналом является способ подключения службы Azure Bot к Teams или другому поддерживаемому Microsoft или стороннему приложению для общения.In this case, a channel is how the Azure Bot Service connects your bot to Teams or another supported Microsoft or third-party communications app.

ПодробнееLearn more