Отправка пакета приложения в Microsoft TeamsUpload an app package to Microsoft Teams

Чтобы протестировать работу приложений в Microsoft Teams, необходимо отправить приложение в Teams.To test your app experience within Microsoft Teams, you need to upload your app to Teams. При отправке приложение добавляется в выбранную вами команду, а члены вашей группы могут взаимодействовать с ней, как конечные пользователи.Uploading adds the app to the team you select, and you and your team members can interact with it like end users.

Примечание

При отправке обновленного пакета для существующего приложения с помощью ленты может не отображаться изменение вкладки при просмотре в окне беседы.Uploading an updated package for an existing app with a bot might not show tab changes when viewed through the Conversations window. Лучше получить доступ к нему через приложение или тестировать его в чистой тестовой среде.It's better to access it via the Apps fly-out, or test on a clean test environment.

Создание пакета отправкиCreate your upload package

Для разработки, а также AppSource (прежнее название — магазин Office) необходимо создать пакет с перегрузкой, содержащий сведения для описания взаимодействия с пользователем.For development as well as AppSource (formerly Office Store) submission you must create an uploadable package that contains the information to describe your experience. Пакет, ZIP-файл содержит манифест приложения и значки, которые уникально определяют ваш интерфейс.The package, a .zip file, contains the application manifest and icons that uniquely define your experience.

Чтобы создать пакет отправки, ознакомьтесь со статьей Создание пакета для приложения Microsoft Teams.To create an upload package, see Create the package for your Microsoft Teams app.

После создания пакета его можно отправить в команду.With your package created, you can now upload it into a team. После отправки он будет доступен всем пользователям выбранной команды и только пользователям этой команды.Once uploaded it will be available for all users in the selected team, and only the users of that team.

Загрузка пакета в TeamsLoad your package into Teams

Вы можете протестировать пакет, отправив его в Teams.You can test your package by uploading it into Teams.

Примечание

Для отправки в работу администратор клиента должен сначала Разрешить отправку приложений.For uploading to work, your tenant admin must first enable uploading of apps.

Существует два способа отправки приложения в teams:There are two ways to upload your app to Teams:

  • Использование хранилищаUsing the Store
  • Использование вкладки "приложения"Using the Apps tab

Отправка пакета в группу или беседу с помощью магазинаUpload your package into a team or conversation using the Store

  1. В левом нижнем углу Teams выберите значок магазин.In the lower left corner of Teams, choose the Store icon. На странице Store выберите "Отправить настраиваемое приложение".On the Store page, choose "Upload a custom app".

Просмотр команды

  1. В диалоговом окне Открыть перейдите к пакету, который требуется отправить, и нажмите кнопку Открыть.In the Open dialog, navigate to the package you want to upload and choose Open.

    Меню "Добавить"

Переданный пакет теперь должен быть доступен для использования в команде или беседе, указанной в диалоговом окне согласия.The uploaded package should now be available for use in the team or conversation specified in the consent dialog. Если ваше приложение не отображается, наиболее распространенной причиной является ошибка в манифесте, особенно идентификаторы для расширений приложения, Bot и сообщений.If your app does not appear, the most common reason is an error in the manifest, particularly ids for the app, bot and messaging extensions. Если приложение не ограничено для бесед, этот параметр не будет отображаться.If the app is not scoped for conversations, that option will not appear.

Примечание

Приложения в беседах в настоящее время находятся в предварительной версии Developer, и этот параметр не отображается, если Teams не работает в этом режиме.Apps in conversations is currently in Developer Preview, and the option will not appear if Teams is not running in that mode.

Пример кода робота в списке отправленных Боты

Отправка пакета в команду с помощью вкладки "приложения"Upload your package into a team using the Apps tab

  1. В Целевой группе выберите Дополнительные параметры () и выберите пункт Управление командой.In the target team, choose More options () and choose Manage team.

    Примечание

    Вы должны быть владельцем группы, или владелец должен разрешить пользователям добавлять соответствующие типы приложений для отображения этой функции.You must be the team owner, or the owner must allow users to add the appropriate app types for this functionality to appear.

  2. Перейдите на вкладку приложения, а затем выберите Отправить настраиваемое приложение в правом нижнем углу.Select the Apps tab, and then choose Upload a custom app on the lower right.

    Отправка точки входа

  3. Найдите и выберите ZIP-пакет на своем компьютере.Browse to and select your .zip package from your computer.

  4. После короткой паузы вы увидите ваше отправленное приложение в списке.After a brief pause you will see your uploaded app in the list.

    Пример кода робота в списке отправленных Боты

Если ваше приложение не загружается, наиболее распространенной причиной является ошибка в манифесте, особенно идентификаторы для расширений приложения, Bot и сообщений.If your app does not load, the most common reason is an error in the manifest, particularly ids for the app, bot and messaging extensions.

Доступ к отправленной настраиваемой вкладкеAccessing your uploaded configurable tab

Если приложение содержит вкладки, пользователи могут закреплять их во всех беседах или каналах команд с помощью стандартного процесса коллекции вкладок.If the app contains tabs, users can pin them to any conversation or team channel using the standard tab gallery flow:

  1. Перейдите к каналу в группе.Go to a channel in the team. Выберите + (Добавить вкладку) справа от существующих вкладок.Choose + (Add a tab) to the right of the existing tabs.

  2. Выберите вкладку в появившейся коллекции.Select your tab from the gallery that appears.

  3. Примите запрос согласия.Accept the consent prompt.

  4. Настройте вкладку с помощью страницы ее конфигурации и нажмите кнопку сохранить.Configure your tab via its configuration page and choose Save.

Диалоговое окно "Добавление вкладки" с коллекцией доступных вкладок

Доступ к переданному почтовому роботуAccessing your uploaded bot

Когда вы добавляете робота в группу, он должен работать с другими участниками группы, в зависимости от определения области действия Bot.When you add a bot to a team, it should be usable by anyone on that team, inside and outside the team channels, depending on bot scope definition. Вы и другие участники группы увидят запись в общем канале, указывающую на то, что Bot добавлен в команду.You and other team members will see a post in the General channel indicating that the bot has been added to the team.

Для ленты с включенной поддержкой Teams можно начать с запуска ленты, @mentioning имя ленты, которая должна быть автозаполнена.For a teams-enabled bot, you can start by invoking your bot by @mentioning the name of the bot, which should autocomplete.

Чтобы протестировать прямые беседы с помощью ленты, вы можете получить доступ к нему через домашнюю страницу приложения, @mention его в канале или выполнить поиск в новом окне чата .To test direct chats with your bot, you can either access it via the App home, @mention it in a channel, or search for it in the New Chat window.

Когда вы добавляете робота в беседу, чтобы протестировать прямые сеансы связи с роботом, вы можете @mention его в беседе или найти в новом окне чата .When you add your bot to a conversation To test direct chats with your bot, you can @mention it in a conversation, or search for it in the New Chat window.

Доступ к переданному соединителюAccessing your uploaded Connector

Когда приложение загружено в группе или беседе, пользователи могут настроить соединитель с помощью процесса коллекции стандартных соединителей:With the app loaded in the team or conversation, users can set up a Connector using the standard Connectors gallery flow:

  1. Перейдите к каналу в группе.Go to a channel in the team. Нажмите кнопку Дополнительные параметры () и выберите пункт соединители.Choose More options () and choose Connectors.

  2. Выберите свой соединитель из раздела Неопубликованные в нижней части страницы.Select your Connector from the Sideloaded section at the bottom.

  3. Настройте соединитель с помощью страницы конфигурации и нажмите кнопку сохранить.Configure your Connector via its configuration page and choose Save.

Диалоговое окно "Добавление вкладки" с коллекцией доступных вкладок.

Доступ к переданному расширению обмена сообщениямиAccessing your uploaded messaging extension

Загруженное приложение с расширением обмена сообщениями автоматически отображается в меню дополнительных параметров () в поле "создание".An uploaded app with a messaging extension automatically appears in the More options () menu in the compose box.

расширения для обмена сообщениями;

Удаление или обновление приложенияRemoving or updating your app

Если вы хотите удалить приложение, выберите значок Корзина — может находиться рядом с именем приложения в списке вид Teams Боты.If you want to remove your app, select the trash-can icon next to the app name in the View Teams bots list.

При изменении сведений манифеста необходимо сначала удалить приложение, а затем добавить обновленный пакет (на загрузку пакета в группу).If you change manifest information, you must first remove the app and then add the updated package (per Load your package into a team). Обратите внимание, что в общем случае изменения кода для службы не требуют повторной отправки манифеста, если эти изменения не требуют обновления манифеста (например, изменения URL-адреса или идентификатора приложения Microsoft для ленты).Note that, in general, code changes on your service do not require you to re-upload your manifest, unless those changes require manifest updates (such as changes to the URL or the Microsoft app ID for its bot).

Примечание

Невозможно полностью удалить Bot из личного контекста.There is no way to completely remove a bot from personal context. При удалении и повторном добавлении канала ленты к предыдущей беседе добавляется дополнительное соединение с Bot.If the bot is removed and re-added, additional communication with the bot will append to the previous conversation.

Рекомендации по устранению неполадокTroubleshooting notes

  • Если манифест не загружается, дважды убедитесь, что вы выполнили все инструкции, приведенные в разделе Create a Package и проверили манифест в соответствии со схемой.If the manifest doesn't load, please double-check that you followed all the instructions in Create the package and validated your manifest against the schema.