Publicar um aplicativo personalizado enviado usando a API de Envio de Aplicativos do Teams

  • Artigo
  • Aplica-se a:
    Microsoft Teams

Este artigo fornece diretrizes de ponta a ponta sobre como levar seu aplicativo do Teams do desenvolvimento à implantação até a descoberta. Você terá uma visão geral das experiências conectadas que o Teams oferece ao longo do ciclo de vida do aplicativo para simplificar como desenvolver, implantar e gerenciar aplicativos personalizados na app store da sua organização.

Os desenvolvedores podem usar a API de Envio de Aplicativo do Teams para enviar aplicativos personalizados diretamente ao centro de administração do Microsoft Teams para que você examine e aprove. Você pode definir políticas para gerenciar aplicativos para usuários em sua organização e seus usuários descobrem esses aplicativos no cliente do Teams.

Visão geral do seu aplicativo, desde o desenvolvimento até a implantação.

Ao publicar um aplicativo personalizado do Teams, ele fica disponível para os usuários na loja de aplicativos da sua organização. Há três maneiras de publicar um aplicativo personalizado e seu método de aprovação depende de como você recebe o aplicativo do desenvolvedor do aplicativo.

Desenvolvedor de aplicativos envia o aplicativo

Quando o aplicativo estiver pronto para uso na produção, o desenvolvedor poderá enviá-lo usando a API de envio de aplicativos do Teams, que pode ser chamada a partir da API do Graph, um ambiente de desenvolvimento integrado (IDE), como o Visual Studio Code, ou uma plataforma, como o Power Apps e os Agentes Virtuais do Power. Isso torna o aplicativo disponível na página Gerenciar aplicativos do centro de administração do Teams, onde você pode examiná-lo e aprová-lo.

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 de aplicativos personalizados no Teams.

Este é um exemplo de como essa etapa de envio de aplicativo se parece no Visual Studio Code:

Captura de tela do envio do aplicativo no Visual Studio Code.

Lembre-se de que isso ainda não publica o aplicativo na app store da sua organização. Esta etapa envia o aplicativo para o centro de administração do Teams, onde você pode aprová-lo para publicação na app store da sua organização.

Para obter mais informações sobre como usar a API do Graph para enviar aplicativos, confira aqui.

Notificação para envios de aplicativos

Você pode ativar as notificações para saber quando os desenvolvedores enviarem um novo aplicativo para análise e aprovação. Você também receberá notificações quando os desenvolvedores enviarem as atualizações do aplicativo. Para ativar as notificações de envio de aplicativos no centro de administração do Teams, acesse Notificações e alertas> Regras>Envio de aplicativos e ative a regra alterando o status para Ativo. Por padrão, essa configuração é desabilitada. Você precisa ser um administrador global ou um administrador do Teams para ativar essa configuração.

Depois de ativar essa configuração, você receberá notificações na equipe de Alertas e Notificações do Administrador em um novo canal denominado Envio de aplicativos . Alternativamente, você pode escolher uma equipe e um canal existentes para receber as notificações entregues a uma equipe e um canal especificados. Para fazer isso, execute estas etapas:

  1. Na regra Envios de aplicativos, marque a caixa de seleção Alerta de canal em Ações.

  2. Escolha o botão Selecionar canal.

  3. Pesquisar uma equipe para adicionar.

  4. Pesquisar um canal para adicionar.

  5. Selecione Aplicar.

    Caixa de seleção de notificações de alertas do canal personalizado.

Nota

Selecione a caixa de seleção Alerta de canal padrão para receber notificações para a equipe Alertas e Notificações do Administrador no canal Envio de Aplicativos.

Caixa de seleção de notificações de alertas do canal padrão.

Você também pode configurar notificações para um webhook externo especificando uma URL pública do webhook depois de selecionar a caixa de seleção Webhook. Um conteúdo de notificação JSON será enviado para a URL do seu webhook.

Notificação de envio do aplicativo.

Após configurar a regra de envio de aplicativos, você pode revisar os cartões de notificação no canal especificado para ver os detalhes do aplicativo e selecionar Exibir detalhes para abrir aplicativos no centro de administração do Teams.

Aprovar o aplicativo enviado

A página Gerenciar aplicativos no centro de administração do Teams (no painel de navegação esquerdo, vá para Aplicativos do Teams>Gerenciar aplicativos), fornece uma visão de todos os aplicativos do Teams para sua organização. O widget Aprovação pendente na parte superior da página permite que você saiba quando um aplicativo personalizado é enviado para aprovação.

Na tabela, um aplicativo enviado recentemente mostra automaticamente um Status de publicação de Enviado e Status de Bloqueado. Você pode classificar a coluna Status da publicação em ordem decrescente para encontrar rapidamente o aplicativo.

Status da publicação.

Selecione o nome do aplicativo para acessar a página de detalhes do aplicativo. Na guia Sobre, você pode visualizar detalhes sobre o aplicativo, incluindo descrição, status, remetente e ID do aplicativo.

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 da publicação, confira aqui.

Publicar o aplicativo para seus usuários

Quando estiver pronto para disponibilizar o aplicativo para os usuários, publique o aplicativo.

  1. Entre no centro de administração do Teams e acesse Aplicativos do Teams>Gerenciar aplicativos.

  2. Selecione o nome do aplicativo para acessar a página de detalhes do aplicativo e, em seguida, na caixa Status da publicação, selecione Publicar.

    Botão Publicar na página de detalhes do aplicativo.

Depois de publicar o aplicativo, o Status da publicação é alterado para Publicado e o Status é alterado para Permitido.

Configurar e gerenciar

Controlar o acesso ao aplicativo

Por padrão, todos os usuários em sua organização podem acessar o aplicativo na loja de aplicativos da sua organização. 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. Para saber mais, confira Gerenciar políticas de permissão de aplicativos no Teams.

Fixar e instalar o aplicativo para que os usuários descubram

Por padrão, para que os usuários localizem o aplicativo, eles precisam acessar a loja de aplicativos da sua organização e procurar ou pesquisar por ele. Para facilitar o acesso dos usuários ao aplicativo, você pode fixar o aplicativo na barra de aplicativos no Teams. Para fazer isso, crie uma política de configuração de aplicativo e atribua-a aos usuários. Para saber mais, confira Gerenciar políticas de configuração de aplicativos no Teams.

Pesquisar o log de auditoria para eventos de aplicativos do Teams

Você pode pesquisar o log de auditoria para exibir a atividade de aplicativos do Teams em sua organização. 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 eventos no log de auditoria no Teams .

Para examinar o log de auditoria, você precisa ativar a auditoria no Centro de Conformidade e Segurança. Para obter instruções, confira Ativar ou desativar a pesquisa de log de auditoria. Tenha em mente que os dados de auditoria só estão disponíveis a partir do ponto em que você ativou a auditoria.

Descobrir e adotar

Os usuários que têm permissões para o aplicativo podem encontrá-lo na app store da sua organização. No cliente do Teams, na página Aplicativos, esses aplicativos estão disponíveis na seção Built for your org .

Página de aplicativos mostrando o aplicativo publicado.

Você pode criar uma política de instalação de aplicativo e atribuí-la a todos ou a alguns usuários para fixar mais um minério de aplicativos no cliente do Teams. Ele melhora o acesso fácil e a adoção de aplicativos para os aplicativos relevantes para as necessidades de seus usuários.

Atualizar um aplicativo personalizado

Quando o desenvolvedor envia uma atualização para um aplicativo personalizado publicado, você é notificado no widget de aprovação pendente na página Gerenciar aplicativos no centro de administração. Na listagem de aplicativos na página Gerenciar aplicativos, o status de Publicação do aplicativo está definido como Atualizar enviado.

A captura de tela mostra a página Gerenciar aplicativos com uma solicitação pendente e status de um aplicativo recém-enviado.

Para examinar e publicar uma atualização do aplicativo:

  1. Na navegação à esquerda do centro de administração do Teams, acesse Aplicativos do Teams>Gerenciar aplicativos.

  2. Selecione o nome do aplicativo para acessar a página de detalhes do aplicativo e selecione Atualizar disponível para examinar os detalhes da atualização.

    Página de detalhes do aplicativo.

  3. Quando estiver pronto, selecione Publicar para publicar a atualização. Isso substitui o aplicativo existente, atualiza o número da versão e altera o Status da publicação para Publicado. Todas as políticas de permissão de aplicativo e as políticas de configuração de aplicativo permanecem aplicadas ao aplicativo atualizado.

    Se você rejeitar a atualização, a versão anterior do aplicativo permanecerá publicada.

Lembre-se do seguinte:

  • Quando um aplicativo é aprovado, qualquer pessoa pode enviar uma atualização para o aplicativo. Isso significa que outros desenvolvedores, incluindo o desenvolvedor que enviou o aplicativo originalmente, podem enviar uma atualização para o aplicativo.
  • Quando um desenvolvedor envia um aplicativo e a solicitação está pendente, apenas esse mesmo desenvolvedor pode enviar uma atualização para o aplicativo. Outros desenvolvedores só podem enviar uma atualização depois que o aplicativo for aprovado.

Para obter mais informações sobre como usar a API do Graph para atualizar aplicativos, confira aqui.