Добавление боты в приложения Microsoft TeamsAdd bots to Microsoft Teams apps

Важно!

Статьи, приведенные в этом разделе, основаны на пакете SDK "V3 Bot Framework".The articles in this section are based on the v3 Bot Framework SDK. Если вы ищете текущую документацию (версия 4,6 или более поздняя версия пакета SDK), ознакомьтесь с разделом " беседы Боты ".If you're looking for current documentation (version 4.6 or later of the SDK) see the Conversational Bots section.

Создавайте и соединяют интеллектуальные боты для взаимодействия с пользователями Microsoft Teams с помощью чата.Build and connect intelligent bots to interact with Microsoft Teams users naturally through chat. Или предоставьте простой командный Bot на основе команд, который будет использоваться в качестве интерфейса командной строки для более широкого взаимодействия с приложением Teams.Or provide a simple commands-based bot, to be used as your "command-line" interface for your broader Teams app experience. Вы можете сделать Bot-робота, который может отправлять сведения, относящиеся к пользователям, непосредственно к ним в канале или прямом сообщении.You can make a notification-only bot, which can push information relevant to your users directly to them in a channel or direct message. Вы можете даже перенести существующий Bot на основе ленты и добавить поддержку, зависящую от Teams, чтобы сделать свою работу.You can even bring your existing Bot Framework-based bot and add Teams-specific support to make your experience shine.

Пример почтовых роботов, почтовых пользователей

Что нужно знать: БотыWhat you need to know: Bots

Элемент Bot отображается точно так же, как и любой другой участник группы, с которым вы взаимодействуете в беседе, за исключением того, что он имеет значок шестиугольника и всегда находится в сети.A bot appears just like any other team member you interact with in a conversation except that it has a hexagonal avatar icon and is always online.

По-разному ведет себя по-разному в зависимости от типа используемой беседы.A bot behaves differently depending on what kind of conversation it is involved in. Боты в Teams поддерживают несколько видов бесед (называемых областями в манифесте приложения).Bots in Teams support several kinds of conversations (called scopes in the app manifest).

  • teamsТакже называется "беседы по каналу"teams Also called channel conversations
  • personalБеседы между Bot и одним пользователемpersonal Conversations between a bot and a single user
  • groupChatБеседа между Bot и 2 или более пользователямиgroupChat A conversation between a bot and 2 or more users

Дополнительные сведения можно найти в беседе с роботом Microsoft Teams .See Have a conversation with a Microsoft Teams bot for more information.

С помощью приложений Microsoft Teams вы можете сделать так, чтобы он был "звезда", или только вспомогательный.With Microsoft Teams apps, you can make the bot the star of your experience, or just a helper. Боты распространяется в составе более широкого пакета приложений, который может включать в себя другие возможности, такие как вкладки или расширения обмена сообщениями.Bots are distributed as part of your broader app package which can include other capabilities such as tabs or messaging extensions.

API-интерфейсы лентыBot APIs

Microsoft Teams поддерживает большинство Microsoft Bot Framework.Microsoft Teams supports most of the Microsoft Bot Framework. (Если у вас уже есть Bot, основанный на Bot Framework, вы можете легко адаптировать его для работы в Microsoft Teams.) Мы рекомендуем использовать язык C# или Node. js, чтобы воспользоваться преимуществами наших пакетов SDK.(If you already have a bot that's based on the Bot Framework, you can easily adapt it to work in Microsoft Teams.) We recommend you use either C# or Node.js to take advantage of our SDKs. Эти пакеты расширяют базовые классы и методы пакета SDK для Bot построителя:These packages extend the basic Bot Builder SDK classes and methods:

  • Использование специализированных типов карточек, таких как соединительная карта Office 365Using specialized card types like the Office 365 Connector card
  • Использование и Настройка данных о каналах для конкретных действий в TeamsConsuming and setting Teams-specific channel data on activities
  • Обработка запросов на расширение обмена сообщениямиProcessing messaging extension requests

Расширения пакета SDK устанавливают зависимости, в том числе пакет SDK для программы "Bot Builder".The SDK extensions install dependencies, including the Bot Builder SDK.

  • .NET Чтобы использовать расширения Microsoft Teams для пакета SDK построителя построителя для .NET, установите пакет NuGet Microsoft. Bot. Connector. Teams в проекте Visual Studio..NET To use the Microsoft Teams extensions for the Bot Builder SDK for .NET, install the Microsoft.Bot.Connector.Teams NuGet package in your Visual Studio project. Для разработки Node. js функция Ботбуилдер для Microsoft Teams встроена в пакет SDK для Bot Framework версии 4.6.For Node.js development, the BotBuilder for Microsoft Teams functionality has been incorporated into the Bot Framework SDK as of v4.6.

В этой статье также приведены примеры кода Bot Framework.See also Bot Framework samples.

Важно!

Вы можете разрабатывать приложения Teams в любой другой технологии веб-программирования и напрямую вызывать API REST для REST Framework , но вы должны выполнить всю обработку маркеров самостоятельно.You can develop Teams apps in any other web-programming technology and call the Bot Framework REST APIs directly, but you must perform all token handling yourself.

Team Studio App Studio позволяет создавать и настраивать манифест приложения, а также создавать ленты ленты.Teams App Studio helps you create and configure your app manifest, and can create your Bot Framework bot for you. Кроме того, она содержит библиотеку управления реагируем и интерактивную построитель карточек.It also contains a React control library and an interactive card builder.

Исходящие веб-перехватчикиOutgoing webhooks

Исходящие веб-Перехватчики позволяют создать простой Bot для базового взаимодействия, например, при включении рабочего процесса или других простых команд, которые могут потребоваться.Outgoing webhooks allow you to create a simple bot for basic interaction, like kicking off a workflow or other simple commands you may need. Исходящие веб-перехватчики Live доступны только в той команде, в которой они созданы, и предназначены для простых процессов, относящихся к рабочему процессу вашей компании.Outgoing webhooks live only in the team in which you create them and are intended for simple processes specific to your company's workflow. Для получения дополнительных сведений см исходящие веб-перехватчики .See outgoing webhooks for more information.

Создание привлекательного командного роботаBuild a great Teams bot

В следующих разделах описывается процесс создания отличного почтового робота для Teams.The following topics will guide you through the process of creating a great bot for Teams.