Carregar um pacote do aplicativo para o Microsoft TeamsUpload an app package to Microsoft Teams

Para testar a experiência do aplicativo no Microsoft Teams, você precisa carregar seu aplicativo para o Teams.To test your app experience within Microsoft Teams, you need to upload your app to Teams. O carregamento adiciona o aplicativo à equipe selecionada e você e os membros da equipe podem interagir com ele, como os usuários finais.Uploading adds the app to the team you select, and you and your team members can interact with it like end users.

Observação

Carregar um pacote atualizado para um aplicativo existente com um bot pode não mostrar as alterações de tabulação quando visualizado por meio da janela conversas.Uploading an updated package for an existing app with a bot might not show tab changes when viewed through the Conversations window. É melhor acessá-lo por meio do surgimento dos aplicativos ou teste em um ambiente de teste limpo.It's better to access it via the Apps fly-out, or test on a clean test environment.

Criar seu pacote de carregamentoCreate your upload package

Para o desenvolvimento, bem como o envio do AppSource (anteriormente Office Store), você deve criar um pacote que contenha as informações para descrever sua experiência.For development as well as AppSource (formerly Office Store) submission you must create an uploadable package that contains the information to describe your experience. O pacote, um arquivo. zip, contém o manifesto do aplicativo e os ícones que definem exclusivamente sua experiência.The package, a .zip file, contains the application manifest and icons that uniquely define your experience.

Para criar um pacote de carregamento, consulte criar o pacote para seu aplicativo do Microsoft Teams.To create an upload package, see Create the package for your Microsoft Teams app.

Com seu pacote criado, agora você pode carregá-lo em uma equipe.With your package created, you can now upload it into a team. Depois de carregado, ele estará disponível para todos os usuários da equipe selecionada e apenas para os usuários dessa equipe.Once uploaded it will be available for all users in the selected team, and only the users of that team.

Carregar seu pacote no Microsoft TeamsLoad your package into Teams

Você pode testar seu pacote carregando-o no Microsoft Teams.You can test your package by uploading it into Teams.

Observação

Para que o carregamento funcione, o administrador de locatário deve primeiro habilitar o carregamento de aplicativos.For uploading to work, your tenant admin must first enable uploading of apps.

Há duas maneiras de carregar seu aplicativo para o Microsoft Teams:There are two ways to upload your app to Teams:

  • Usando o repositórioUsing the Store
  • Usando a guia aplicativosUsing the Apps tab

Carregar seu pacote em uma equipe ou conversa usando a lojaUpload your package into a team or conversation using the Store

  1. No canto inferior esquerdo do Teams, escolha o ícone de armazenamento.In the lower left corner of Teams, choose the Store icon. Na página loja, escolha "carregar um aplicativo personalizado".On the Store page, choose "Upload a custom app".

    Exibir equipe

  2. Na caixa de diálogo abrir , navegue até o pacote que você deseja carregar e escolha abrir.In the Open dialog, navigate to the package you want to upload and choose Open.

O pacote carregado agora deve estar disponível para uso na equipe ou conversa especificada na caixa de diálogo de consentimento.The uploaded package should now be available for use in the team or conversation specified in the consent dialog. Se seu aplicativo não aparecer, o motivo mais comum é um erro no manifesto, principalmente IDs para o aplicativo, bot e extensões de mensagens.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. Se o aplicativo não tiver escopo para conversas, essa opção não será exibida.If the app is not scoped for conversations, that option will not appear.

Observação

Os aplicativos em conversas estão atualmente na visualização do desenvolvedore a opção não será exibida se o Microsoft Teams não estiver em execução nesse modo.Apps in conversations is currently in Developer Preview, and the option will not appear if Teams is not running in that mode.

Exemplo de bot na lista de bots carregados

Carregar seu pacote em uma equipe usando a guia aplicativosUpload your package into a team using the Apps tab

  1. Na equipe de destino, escolha mais opções () e escolha Gerenciar equipe.In the target team, choose More options () and choose Manage team.

    Observação

    Você deve ser o proprietário da equipe ou o proprietário deve permitir que os usuários adicionem os tipos de aplicativos apropriados para que essa funcionalidade seja exibida.You must be the team owner, or the owner must allow users to add the appropriate app types for this functionality to appear.

  2. Selecione a guia aplicativos e, em seguida, escolha carregar um aplicativo personalizado no canto inferior direito.Select the Apps tab, and then choose Upload a custom app on the lower right.

    Carregar ponto de entrada

  3. Navegue até o pacote. zip e selecione-o em seu computador.Browse to and select your .zip package from your computer.

  4. Após uma breve pausa, você verá seu aplicativo carregado na lista.After a brief pause you will see your uploaded app in the list.

    Exemplo de bot na lista de bots carregados

Se seu aplicativo não carregar, o motivo mais comum é um erro no manifesto, principalmente IDs para o aplicativo, bot e extensões de mensagens.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.

Acessar a guia configurável do carregadoAccessing your uploaded configurable tab

Se o aplicativo contiver guias, os usuários poderão fixá-los em qualquer conversa ou canal de equipe usando o fluxo da Galeria de guias padrão:If the app contains tabs, users can pin them to any conversation or team channel using the standard tab gallery flow:

  1. Vá para um canal da equipe.Go to a channel in the team. Escolha + (Adicionar uma guia) à direita das guias existentes.Choose + (Add a tab) to the right of the existing tabs.

  2. Selecione sua guia na galeria que aparece.Select your tab from the gallery that appears.

  3. Aceite o prompt de consentimento.Accept the consent prompt.

  4. Configure sua guia por meio de sua página de configuração e escolha salvar.Configure your tab via its configuration page and choose Save.

A caixa de diálogo Adicionar uma guia, apresentando uma galeria de guias disponíveis

Acessar o bot carregadoAccessing your uploaded bot

Quando você adiciona um bot a uma equipe, ele deve ser útil para qualquer pessoa nessa equipe, dentro e fora dos canais da equipe, dependendo da definição do escopo do 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. Você e outros membros da equipe verão uma postagem no canal geral indicando que o bot foi adicionado à equipe.You and other team members will see a post in the General channel indicating that the bot has been added to the team.

Para um bot habilitado para o Microsoft Teams, você pode começar invocando o bot, @mentioning o nome do bot, que deve ser concluído.For a teams-enabled bot, you can start by invoking your bot by @mentioning the name of the bot, which should autocomplete.

Para testar chats diretos com o bot, você pode acessá-lo por meio da página inicial do aplicativo, @mention-lo em um canal ou procurá-lo na nova janela de chat .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.

Ao adicionar o bot a uma conversa para testar chats diretos com o bot, você pode @mention-lo em uma conversa ou procurá-lo na nova janela de chat .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.

Acessando seu conector carregadoAccessing your uploaded Connector

Com o aplicativo carregado na equipe ou na conversa, os usuários podem configurar um conector usando o fluxo da Galeria de conectores padrão:With the app loaded in the team or conversation, users can set up a Connector using the standard Connectors gallery flow:

  1. Vá para um canal da equipe.Go to a channel in the team. Escolha mais opções () e escolha conectores.Choose More options () and choose Connectors.

  2. Selecione seu conector na seção suplementos foi feito na parte inferior.Select your Connector from the Sideloaded section at the bottom.

  3. Configure seu conector por meio de sua página de configuração e escolha salvar.Configure your Connector via its configuration page and choose Save.

A caixa de diálogo Adicionar uma guia, apresentando uma galeria de guias disponíveis.

Acessar sua extensão de mensagens carregadasAccessing your uploaded messaging extension

Um aplicativo carregado com uma extensão de mensagens aparece automaticamente no menu mais opções () na caixa de composição.An uploaded app with a messaging extension automatically appears in the More options () menu in the compose box.

Extensões de mensagens

Remover ou atualizar seu aplicativoRemoving or updating your app

Se você deseja remover o aplicativo, selecione o ícone Lixeira ao lado do nome do aplicativo na lista de bots do modo de exibição do teams.If you want to remove your app, select the trash-can icon next to the app name in the View Teams bots list.

Se você alterar as informações do manifesto, remova primeiro o aplicativo e, em seguida, adicione o pacote atualizado (por carregar seu pacote em uma equipe).If you change manifest information, you must first remove the app and then add the updated package (per Load your package into a team). Observe que, em geral, as alterações de código no serviço não exigem que você carregue novamente seu manifesto, a menos que essas alterações exijam atualizações de manifesto (como alterações na URL ou na ID do aplicativo da Microsoft para seu bot).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).

Observação

Não é possível remover completamente um bot do contexto pessoal.There is no way to completely remove a bot from personal context. Se o bot for removido e adicionado novamente, a comunicação adicional com o bot será acrescentada à conversa anterior.If the bot is removed and re-added, additional communication with the bot will append to the previous conversation.

Notas de solução de problemasTroubleshooting notes

  • Se o manifesto não carregar, verifique se você seguiu todas as instruções em criar o pacote e validou seu manifesto no esquema.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.