Publicar um aplicativo personalizado enviado por meio da API de Envio de Aplicativos do TeamsPublish a custom app submitted through the Teams App Submission API

Visão GeralOverview

Observação

Quando você publica um aplicativo personalizado do Teams, ele está disponível para os usuários na loja de aplicativos da sua organização.When you publish a custom Teams app, it's available to users in your organization's app store. Há duas maneiras de publicar um aplicativo personalizado e a maneira como você usa depende de como você obter o aplicativo.There are two ways to publish a custom app and the way that you use depends on how you get the app. Este artigo se concentra em como aprovar e publicar um aplicativo personalizado que um desenvolvedor envia por meio da API de Envio de Aplicativos do Teams.This article focuses on how to approve and publish a custom app that a developer submits through the Teams App Submission API. O outro método, carregando um aplicativo personalizado, é usado quando um desenvolvedor envia um pacote de aplicativo no formato .zip.The other method, uploading a custom app, is used when a developer sends you an app package in .zip format. Para saber mais sobre esse método, consulte Publicar um aplicativo personalizado carregando um pacote de aplicativos.To learn more about that method, see Publish a custom app by uploading an app package. O widget aprovar aplicativo não está disponível em locatários GCC.The approve app widget isn't available in GCC tenants.

Importante

Este método não está disponível atualmente para ambientes GCC.This method is not currently available for GCC environments. Você deve usar o método de carregamento de um aplicativo personalizado.You must use the uploading a custom app method.

Este artigo fornece orientações de ponta a ponta sobre como levar seu aplicativo do Teams do desenvolvimento à implantação até a descoberta.This article provides end-to-end guidance for how to take your Teams app from development to deployment to discovery. Você obterá uma visão geral das experiências conectadas que o Teams fornece em todo o ciclo de vida do aplicativo para simplificar como desenvolver, implantar e gerenciar aplicativos personalizados na loja de aplicativos da sua organização.You'll get an overview of the connected experiences that Teams provides across the app lifecycle to streamline how to develop, deploy, and manage custom apps in your organization's app store.

Vamos abranger cada etapa do ciclo de vida, incluindo como os desenvolvedores podem usar a API de Envio de Aplicativos do Teams para enviar aplicativos personalizados diretamente ao centro de administração do Microsoft Teams para que você revise e aprove, como definir políticas para gerenciar aplicativos para usuários em sua organização e como seus usuários os descobrirão no Teams.We'll cover each step of the lifecycle, including how developers can use the Teams App Submission API to submit custom apps directly to the Microsoft Teams admin center for you to review and approve, how to set policies to manage apps for users in your organization, and how your users discover them in Teams.

Visão geral do seu aplicativo do desenvolvimento à implantação

Essa orientação se concentra nos aspectos do Teams do aplicativo e destina-se a administradores e profissionais de IT.This guidance focuses on the Teams aspects of the app and is intended for admins and IT pros. Para obter informações sobre o desenvolvimento de aplicativos do Teams, consulte a documentação de desenvolvedores do Teams.For information about developing Teams apps, see the Teams developer documentation.

DesenvolverDevelop

Criar o aplicativoCreate the app

A plataforma de desenvolvedores do Microsoft Teams facilita que os desenvolvedores integrem seus próprios aplicativos e serviços para melhorar a produtividade, tomar decisões mais rapidamente e criar colaboração em torno de conteúdo e fluxos de trabalho existentes.The Microsoft Teams developer platform makes it easy for developers to integrate your own apps and services to improve productivity, make decisions faster, and create collaboration around existing content and workflows. Os aplicativos construídos na plataforma Teams são pontes entre o cliente do Teams e seus serviços e fluxos de trabalho, trazendo-os diretamente para o contexto de sua plataforma de colaboração.Apps built on the Teams platform are bridges between the Teams client and your services and workflows, bringing them directly into the context of your collaboration platform. Para obter mais informações, acesse a documentação de desenvolvedores do Teams.For more information, go to the Teams developer documentation.

Enviar o aplicativoSubmit the app

Quando o aplicativo está pronto para ser usado em produção, o desenvolvedor pode enviar o aplicativo usando a API de Envio de Aplicativos do Teams, que pode ser chamada da API graph, um ambiente de desenvolvimento integrado (IDE), como o código Visual Studio, ou uma plataforma como Power Apps e Power Virtual Agents.When the app is ready for use in production, the developer can submit the app using the Teams App Submission API, which can be called from Graph API, an integrated development environment (IDE) such as Visual Studio Code, or a platform such as Power Apps and Power Virtual Agents. Isso disponibiliza o aplicativo na página Gerenciar aplicativos do Centro de administração do Microsoft Teams, onde você, o administrador, pode revisá-lo e aprove.thisDoing this makes the app available on the Manage apps page of the Microsoft Teams admin center, where you, the admin, can review and approve it.this

A API de Envio de Aplicativos do Teams, criada no Microsoft Graph,permite que sua organização se desenvolva na plataforma de sua escolha e automatiza o processo de envio para aprovação para aplicativos personalizados no Teams.The Teams App Submission API, built on Microsoft Graph, allows your organization to develop on the platform of your choice and automates the submission-to-approval process for custom apps on Teams.

Aqui está um exemplo de como essa etapa de envio de aplicativo se parece Visual Studio Código:Here's an example of what this app submission step looks like in Visual Studio Code:

enviando um aplicativo no Visual Studio Code

Lembre-se de que isso ainda não publica o aplicativo na loja de aplicativos da sua organização.Keep in mind that this doesn't publish the app to your organization's app store yet. Esta etapa envia o aplicativo para o centro de administração do Microsoft Teams, onde você pode aprove-lo para publicação na loja de aplicativos da sua organização.This step submits the app to the Microsoft Teams admin center where you can approve it for publishing to your organization's app store.

Para obter mais informações sobre como usar a API do Graph para enviar aplicativos, consulte aqui.For more information about using the Graph API to submit apps, see here.

ValidarValidate

A página Gerenciar aplicativos no centro de administração do Microsoft Teams (na navegação à esquerda, vá para Aplicativos do Teams Gerenciar aplicativos ), fornece uma exibição em todos os aplicativos > do Teams para sua organização.The Manage apps page in the Microsoft Teams admin center (in the left navigation, go to Teams apps > Manage apps), gives you a view into all Teams apps for your organization. O widget de aprovação pendente na parte superior da página permite que você saiba quando um aplicativo personalizado é enviado para aprovação.The Pending approval widget at the top of the page lets you know when a custom app is submitted for approval.

Na tabela, um aplicativo recém-enviado mostra automaticamente um status de publicação de Submitted e Status de Bloqueado.In the table, a newly submitted app automatically shows a Publishing status of Submitted and Status of Blocked. Você pode classificar a coluna de status de publicação em ordem decrescente para encontrar rapidamente o aplicativo.You can sort the Publishing status column in descending order to quickly find the app.

status de publicaçãopublishing status

Clique no nome do aplicativo para ir até a página de detalhes do aplicativo.Click the app name to go to the app details page. Na guia Sobre, você pode exibir detalhes sobre o aplicativo, incluindo descrição, status, envio e ID do aplicativo.On the About tab, you can view details about the app, including description, status, submitter, and app ID.

página de detalhes do aplicativo para um aplicativo enviado

Para obter mais informações sobre como usar a API do Graph para verificar o status de publicação, consulte aqui.For more information about using the Graph API to check the Publishing status, see here.

PublicarPublish

Quando você estiver pronto para disponibilizar o aplicativo aos usuários, publique o aplicativo.When you're ready to make the app available to users, publish the app.

  1. Na navegação à esquerda do Centro de Administração do Microsoft Teams, vá para Aplicativos do Teams > Gerenciar aplicativos.In the left navigation of the Microsoft Teams admin center, go to Teams apps > Manage apps.

  2. Clique no nome do aplicativo para ir para a página de detalhes do aplicativo e, na caixa Status de Publicação, selecione Publicar.Click the app name to go to the app details page, and then in the Publishing status box, select Publish.

    Depois de publicar o aplicativo, o status de publicação muda para Publicado e o Status muda automaticamente para Permitido.After you publish the app, the Publishing status changes to Published and the Status automatically changes to Allowed.

Configurar e gerenciarSet up and manage

Controlar o acesso ao aplicativoControl access to the app

Por padrão, todos os usuários em sua organização podem acessar o aplicativo na loja de aplicativos da sua organização.By default, all users in your organization can access the app in your organization's app store. Para restringir e controlar quem tem permissão para usar o aplicativo, você pode criar e atribuir uma política de permissão de aplicativo.To restrict and control who has permission to use the app, you can create and assign an app permission policy. Para saber mais, confira Gerenciar políticas de permissão de aplicativos no Teams.To learn more, see Manage app permission policies in Teams.

Fixar e instalar o aplicativo para que os usuários descubramPin and install the app for users to discover

Por padrão, para os usuários encontrarem o aplicativo, eles precisam ir até a loja de aplicativos da sua organização e procurar ou pesquisar por ele.By default, for users to find the app they have to go to your organization's app store and browse or search for it. Para facilitar o acesso dos usuários ao aplicativo, você pode fixar o aplicativo na barra de aplicativos no Teams.To make it easy for users to get to the app, you can pin the app to the app bar in Teams. Para fazer isso, crie uma política de configuração de aplicativo e atribua-a aos usuários.To do this, create an app setup policy and assign it to users. Para saber mais, confira Gerenciar políticas de configuração de aplicativos no Teams.To learn more, see Manage app setup policies in Teams.

Pesquisar o log de auditoria para eventos de aplicativo do TeamsSearch the audit log for Teams app events

Você pode pesquisar o log de auditoria para exibir a atividade de aplicativos do Teams em sua organização.You can search the audit log to view Teams apps activity in your organization. Para saber mais sobre como pesquisar o log de auditoria e ver uma lista de atividades do Teams que estão registradas no log de auditoria, consulte Pesquisar o log de auditoria para eventos no Teams.To learn more about how to search the audit log and to see a list of Teams activities that are logged in the audit log, see Search the audit log for events in Teams.

Antes de poder pesquisar o log de auditoria, você precisa ativar a auditoria no Centro de Conformidade e Segurança.Before you can search the audit log, you have to first turn on auditing in the Security & Compliance Center. Para obter instruções, confira Ativar ou desativar a pesquisa de log de auditoria.To learn more, see Turn audit log search on or off. Tenha em mente que os dados de auditoria só estão disponíveis a partir do ponto em que você ativou a auditoria.Keep in mind that audit data is only available from the point at which you turned on auditing.

Descobrir e adotarDiscover and adopt

Os usuários que têm permissões para o aplicativo podem encontrá-lo na loja de aplicativos da sua organização.Users who have permissions to the app can find it in your organization's app store. Vá para Built for Your Organization Name na página Aplicativos para encontrar os aplicativos personalizados da sua organização.Go to Built for Your Organization Name on the Apps page to find your organization's custom apps.

Página Aplicativos mostrando aplicativo publicadoApps page showing published app

Se você criou e atribuiu uma política de configuração de aplicativo, o aplicativo é fixado na barra de aplicativos no Teams para facilitar o acesso para os usuários que foram atribuídos à política.If you created and assigned an app setup policy, the app is pinned to the app bar in Teams for easy access for those users who were assigned the policy.

AtualizarUpdate

Para atualizar um aplicativo, os desenvolvedores devem continuar seguindo as etapas na seção Desenvolver.To update an app, developers should continue to follow the steps in the Develop section.

Quando o desenvolvedor enviar uma atualização para um aplicativo personalizado publicado, você será notificado no widget de aprovação pendente da página Gerenciar aplicativos.When the developer submits an update to a published custom app, you'll get notified in the Pending approval widget of the Manage apps page. Na tabela, o status de publicação do aplicativo será definido como Update enviado.In the table, the Publishing status of the app will be set to Update submitted.

Gerenciar página de aplicativos mostrando solicitações pendentes e status do aplicativoManage apps page showing pending requests and app status

Para revisar e publicar uma atualização de aplicativo:To review and publish an app update:

  1. Na navegação à esquerda do Centro de Administração do Microsoft Teams, vá para Aplicativos do Teams > Gerenciar aplicativos.In the left navigation of the Microsoft Teams admin center, go to Teams apps > Manage apps.

  2. Clique no nome do aplicativo para ir até a página de detalhes do aplicativo e selecione Atualizar disponível para revisar detalhes da atualização.Click the app name to go to the app details page, and then select Update available to review details of the update.

    página de detalhes do aplicativo

  3. Quando estiver pronto, selecione Publicar para publicar a atualização.When you're ready, select Publish to publish the update. Fazer isso substitui o aplicativo existente, atualiza o número da versão e altera o status de Publicação para Publicado.Doing this replaces the existing app, updates the version number, and changes the Publishing status to Published. Todas as políticas de permissão de aplicativo e políticas de configuração de aplicativo permanecem impostas para o aplicativo atualizado.All app permission policies and app setup policies remain enforced for the updated app.

    Se você rejeitar a atualização, a versão anterior do aplicativo permanecerá publicada.If you reject the update, the earlier version of the app remains published.

Lembre-se do seguinte:Keep in mind the following:

  • Quando um aplicativo é aprovado, qualquer um pode enviar uma atualização para o aplicativo.When an app is approved, any one can submit an update to the app. Isso significa que outros desenvolvedores, incluindo o desenvolvedor que originalmente enviou o aplicativo, podem enviar uma atualização para o aplicativo.This means other developers, including the developer who originally submitted the app, can submit an update to the app.
  • Quando um desenvolvedor envia um aplicativo e a solicitação está pendente, somente esse mesmo desenvolvedor pode enviar uma atualização para o aplicativo.When a developer submits an app and the request is pending, only that same developer can submit an update to the app. Outros desenvolvedores só podem enviar uma atualização depois que o aplicativo for aprovado.Other developers can submit an update only after the app is approved.

Para obter mais informações sobre como usar a API do Graph para atualizar aplicativos, consulte aqui.For more information about using the Graph API to update apps, see here.

Experiência de atualização para usuáriosUpdate experience for users

Na maioria dos casos, depois de publicar uma atualização de aplicativo, a nova versão aparece automaticamente para os usuários.In most cases, after you publish an app update, the new version automatically appears for users. No entanto, há algumas atualizações para o manifesto do Microsoft Teams que exigem que a aceitação do usuário seja concluída:However, there are some updates to the Microsoft Teams manifest that require user acceptance to complete:

  • Um bot foi adicionado ou removidoA bot was added or removed
  • A propriedade "botId" de um bot existente foi alteradaAn existing bot's "botId" property changed
  • A propriedade "isNotificationOnly" de um bot existente foi alteradaAn existing bot's "isNotificationOnly" property changed
  • A propriedade "supportsFiles" do bot foi alteradaThe bot's "supportsFiles" property changed
  • Uma extensão de mensagens foi adicionada ou removidaA messaging extension was added or removed
  • Um novo conector foi adicionadoA new connector was added
  • Uma nova guia estática foi adicionadaA new static tab was added
  • Uma nova guia configurável foi adicionadaA new configurable tab was added
  • Propriedades dentro de "webApplicationInfo" alteradasProperties inside "webApplicationInfo" changed

nova versão disponível

opção de atualização para um aplicativo