Diretrizes gerais para publicar aplicações do Teams extensíveis no Microsoft 365

Concluído

Para desenvolver e publicar aplicações do Teams extensíveis em clientes do Microsoft 365, tem de cumprir um conjunto de requisitos específicos. Esta secção fornece diretrizes detalhadas que ajudam a tornar a sua aplicação compatível e a aumentar as suas hipóteses de publicação com êxito.

Neste artigo, encontrará mais informações sobre as seguintes diretrizes:

• Diretrizes gerais
• Diretrizes de compatibilidade
• Diretrizes de experiência móvel

Diretrizes gerais

• As aplicações do Teams concebidas para se expandirem pelos clientes do Microsoft 365 têm de utilizar a versão 1.13 ou posterior do manifesto da aplicação.

• O URL de suporte da sua aplicação tem de ter conteúdos relevantes para a aplicação em todos os clientes do Microsoft 365 e não deve referenciar apenas um único cliente.

• Os conteúdos oferecidos nas páginas Introdução, Início de Sessão, Inscrição, Fim de Sessão, Ajuda ou encaminhar mensagens da sua aplicação têm de fazer referência a todos os clientes suportados.

• A aplicação tem de fornecer um valor significativo em cada um dos clientes a que é extensível. Por exemplo, se tiver uma aplicação apenas de separador no Teams e quiser que a sua aplicação seja extensível para o Microsoft 365 e o Outlook, tem de garantir que a aplicação fornece fluxos de trabalho adequados nos clientes do Microsoft 365 e do Outlook. A sua aplicação tem de fornecer uma solução viável compatível com todos os clientes da Microsoft aos quais a aplicação é extensível.

  Para explicar a necessidade de a sua aplicação fornecer um valor significativo aos utilizadores em todos os clientes extensíveis, eis alguns cenários em que vemos uma aplicação Contoso expandida para o Microsoft 365 e o Outlook a fornecer um valor significativo aos utilizadores no Teams, mas não oferece fluxos de trabalho utilizáveis nos clientes do Microsoft 365 e do Outlook.

  Cenário 1

  A Contoso é uma aplicação agregadora de notícias ao nível da empresa que agrega todas as notícias internas e informações importantes que circulam numa empresa num separador pessoal no Teams em benefício dos utilizadores finais. Os utilizadores da Contoso podem adicionar a aplicação Contoso Teams ao âmbito pessoal e estar cientes dos artigos de notícias em tempo real da empresa. A Contoso também tem um separador Ajuda que contém instruções completas da funcionalidade caso os utilizadores precisem de orientação sobre como utilizar todo o potencial da aplicação. A Contoso suporta a extensibilidade do Microsoft 365 e do Outlook nos separadores pessoais destes clientes. No entanto, depois de um utilizador adicionar a aplicação Contoso a partir do Microsoft 365 ou da Loja Outlook, os utilizadores só veem o separador Ajuda, mas o separador pessoal com o conteúdo de notícias agregado não é apresentado no Microsoft 365 e no Outlook. Como tal, a aplicação Contoso no Microsoft 365 e no Outlook não oferece nenhuma solução de software utilizável e não cumpre um valor significativo nestes clientes.

  Aplicação Contoso no Outlook:
  

  
  

  Aplicação Contoso no Microsoft 365:
  

  
  

  Recomendação:

  Para fornecer um valor significativo, o programador da aplicação Contoso tem de garantir que o separador pessoal no Teams com o conteúdo de notícias agregado também é apresentado nos clientes do Microsoft 365 e do Outlook.

  Cenário 2

  A Contoso é uma aplicação CRM (Gestão de relações com o cliente) com um separador pessoal que permite que os agentes vejam e atuem em pedidos no Teams. Numa atualização de aplicação, o programador da Contoso atualizou a versão do manifesto da aplicação para a versão 1.16, sinalizando uma intenção para suportar a extensibilidade da aplicação CRM da Contoso para clientes do Microsoft 365 e do Outlook. No entanto, o programador da aplicação CRM da Contoso não testou os fluxos de trabalho da aplicação nos clientes Microsoft 365 e Outlook antes de submeter para revisão de aplicações ou atualizou sem saber o manifesto da aplicação sem qualquer intenção real de suportar a extensibilidade do CRM da Contoso no Microsoft 365 e no Outlook e, consequentemente, a aplicação CRM da Contoso nestes clientes apresenta uma mensagem a pedir ao utilizador para utilizar a aplicação no Teams.

  Aplicação CRM da Contoso no Outlook:
  

  

  Aplicação CRM da Contoso no Microsoft 365:
  

  

  Estes cenários também são vistos frequentemente na revisão de aplicações e falham, uma vez que a aplicação não fornece um valor significativo no Microsoft 365 e no Outlook.

  Recomendação:

  Os programadores são aconselhados a criar fluxos de trabalho que forneçam valor de utilizador suficiente no cliente do Microsoft 365 e outlook ou para mudar a aplicação para uma versão inferior do manifesto da aplicação.

Diretrizes de compatibilidade

• As aplicações do Teams que se estendem por todos os clientes do Microsoft 365 têm de ser totalmente reativas e funcionais na versão mais recente dos clientes microsoft Edge e Google Chrome.
• O utilizador tem de conseguir invocar e utilizar separadores pessoais ou extensões de mensagens na versão mais recente do seguinte:
  • Outlook no ambiente de trabalho, Web e iOS.
  • Microsoft 365 no ambiente de trabalho, Web, Android e iOS.

Diretrizes de experiência móvel

• Os utilizadores têm de conseguir iniciar a aplicação a partir do menu de lista de opções de ações nos clientes do Microsoft 365 e do Outlook em dispositivos móveis e o nome da aplicação tem de ser apresentado na barra de ação.
• Os utilizadores têm de conseguir iniciar e alternar entre vários separadores estáticos no cliente do Microsoft 365 em dispositivos móveis e os separadores têm de ser carregados. Se existirem mais de três separadores estáticos, os restantes separadores têm de estar visíveis na secção Mais .
• Se a sua aplicação utilizar o início de sessão único (SSO), tem de autenticar o utilizador com êxito no cliente em que a aplicação é iniciada pela primeira vez, sem a necessidade de reautentorizar em cada cliente.
• Quando o utilizador muda ou termina sessão nos clientes do Microsoft 365 e do Outlook em dispositivos móveis, a aplicação tem de fechar a instância do utilizador.
• Os utilizadores têm de poder regressar ao estado de trabalho anterior. Se o utilizador estiver na página raiz, a navegação anterior tem de terminar a instância da aplicação no cliente no dispositivo móvel.
• As aplicações que suportam uma ligação avançada a um fluxo de trabalho têm de conseguir redirecionar o utilizador para a experiência de página de destino adequada.
• Os indicadores de progresso têm de aparecer quando a aplicação está a ser carregada e dispensada automaticamente depois de a aplicação estar totalmente carregada.
• Tem de ser apresentado um ecrã de erro quando uma aplicação não carrega devido a uma falha de rede incoerente ou quebrada, tempo limite excedido e falha de autenticação.