Compilar guias para o Teams

  • Artigo

As guias são páginas da Web com reconhecimento do cliente inseridas no Microsoft Teams, Outlook e Microsoft 365. Elas são marcas de <iframe/> HTML simples que apontam para domínios declarados no manifesto do aplicativo e podem ser adicionadas como parte de um canal dentro de uma equipe, chat em grupo ou aplicativo pessoal para um usuário individual. Você pode incluir guias personalizadas com seu aplicativo para inserir seu próprio conteúdo da Web no Teams ou adicionar funcionalidades específicas do Teams ao conteúdo da Web. Para obter mais informações, consulte Biblioteca de clientes JavaScript do Teams.

Importante

As guias personalizadas estão disponíveis em GCC (Government Community Cloud), GCC-High e DoD (Departamento de Defesa).

A imagem a seguir mostra guias estáticas:

A imagem a seguir mostra as guias do canal Contoso:

Há alguns pré-requisitos pelos quais você deve passar antes de trabalhar nas guias.

Há dois tipos de guias disponíveis no Teams, pessoal e em grupo. As guias pessoais também são conhecidas como guias estáticas. As guias pessoais (estáticas), juntamente com bots de escopo pessoal, fazem parte dos aplicativos pessoais que têm escopo para um único usuário e fixados na barra de navegação esquerda para facilitar o acesso. As guias pessoais (estáticas) no escopo pessoal continuam funcionando da mesma maneira. No entanto, agora você pode estender guias estáticas para chat em grupo ou reuniões com uma experiência personalizável.

Você pode estender guias estáticas para diferentes escopos. Guias estáticos em chats, canais ou reuniões se comportam mais como aplicativos, pois você pode fixar apenas uma guia por aplicativo. Por exemplo, você só pode fixar uma única guia de aplicativo do YouTube em uma reunião. As guias estáticas nas reuniões também podem ser pré-fixadas em reuniões por administradores de TI.

A imagem a seguir mostra guias estáticas com experiência personalizável adicionadas a diferentes contextos no Teams:

  • A imagem a seguir mostra uma guia estática no contexto pessoal no cliente da área de trabalho do Teams:

    A captura de tela mostra a guia configurável adicionada a um escopo pessoal.

  • A imagem a seguir mostra uma guia estática no contexto pessoal no cliente móvel do Teams:

    O exemplo mostra uma guia móvel sendo adicionada em um contexto pessoal.

A seguir estão alguns benefícios das guias estáticas em chats e guias de reunião:

  • Fixável e instantâneo: você pode fixar aplicativos com guias estáticas do ícone adicionar uma guia + em chats e reuniões. Essas guias podem ser desafixadas e não têm a caixa de diálogo de configuração obrigatória, o que permite criar guias que funcionam mais como aplicativos.

  • Unificado: você pode criar uma guia estática que funcione em escopos pessoais e de grupo, como guias de chat e reunião.

  • Configuração opcional: você pode alterar a URL padrão na instância da guia alterando a contentUrl propriedade do seu aplicativo depois que ele estiver fixado no Teams.

Guias de canal ou grupo também conhecidas como guias configuráveis, fornecem conteúdo para canais e chats em grupo e é uma maneira de criar espaços colaborativos em torno de conteúdo dedicado baseado na Web.

A tabela a seguir ajuda você a determinar o melhor ajuste para seu aplicativo:

  Personal Canais Chat em grupo Reuniões
Guias estáticas ✔️ ✔️ ✔️ ✔️
Guias configuráveis ❌ ✔️ ✔️ ✔️

Observação

Se você tiver a guia configurável e a guia estática definida no manifesto do aplicativo para um escopo específico, o Teams fixa a guia estática por padrão.

Você pode criar uma página de conteúdo como parte de uma guia estática pessoal, canal ou guia de grupo ou caixa de diálogo (conhecido como módulo de tarefa no TeamsJS v1.x). Você pode criar uma página de configuração que permite que os usuários configurem o aplicativo Microsoft Teams e o usem para configurar uma guia de chat pessoal, canal ou grupo, uma extensão de mensagens ou um conector cartão para Grupos do Microsoft 365. Você pode permitir que os usuários reconfigurem sua guia após a instalação e criar uma página de remoção de guia para seu aplicativo. Ao criar um aplicativo do Teams que inclui uma guia, você deve testar como seu guia nos clientes do Teams para Android e iOS. Sua guia deve ter contexto por meio de informações básicas, informações de localidade e tema e entityId ou subEntityId que identifica o que está na guia.

Observação

Postagens e Arquivos que não podem ser movidos de suas posições.

Recursos da guia

Os recursos da guia são os seguintes:

  • Se uma guia for adicionada a um aplicativo que também tem um bot, o bot também será adicionado à equipe.
  • Consciência do Microsoft Entra ID do usuário atual.
  • Reconhecimento de localidade para o usuário indicar o idioma en-us.
  • Funcionalidade de SSO (logon único), se houver suporte.
  • Capacidade de usar bots ou notificações de aplicativo para vincular profundamente à guia ou a uma sub entidade dentro do serviço, por exemplo, um item de trabalho individual.
  • A capacidade de abrir uma caixa de diálogo modal de links dentro de uma guia.
  • Reutilização de Web Parts do SharePoint na guia.

Guias de cenários de usuário

Cenário: Traga um recurso web existente para o Teams. Exemplo: Você cria uma guia estática no aplicativo teams que apresenta um site corporativo informativo aos usuários.

Cenário: Adicione páginas de suporte a um bot ou extensão de mensagens do Teams. Exemplo: Você cria guias estáticas que fornecem eajudam o conteúdo da página da Web aos usuários.

Cenário: Forneça acesso aos itens com os quais os usuários interagem regularmente para diálogo cooperativo e colaboração. Exemplo: Você cria uma guia de canal ou grupo com vinculação profunda a itens individuais.

Entender como as guias funcionam

Você pode usar um dos seguintes métodos para criar guias:

Declarar guia personalizada no manifesto do aplicativo

Uma guia personalizada é declarada no manifesto do aplicativo do pacote do aplicativo. Para cada página da web que você deseja incluir como uma guia em seu aplicativo, defina uma URL e um escopo. Além disso, você pode adicionar a biblioteca de clientes JavaScript do Teams à sua página e chamar microsoftTeams.initialize() após o carregamento da página. O Teams exibe sua página e fornece acesso a informações específicas do Teams, por exemplo, o cliente do Teams está executando o tema escuro.

Se você optar por expor sua guia no canal ou no grupo ou no escopo pessoal, deverá apresentar uma <página de conteúdo HTML iframe> na guia. Para guias estáticas, a URL de conteúdo é definida diretamente no manifesto do contentUrl aplicativo teams pela propriedade na staticTabs matriz. O conteúdo da guia é o mesmo para todos os usuários.

Observação

O aplicativo Teams não reconhece subiframes. Portanto, ele não será carregado se houver um iframe dentro do aplicativo da guia.

Para guias de canal ou grupo, você também pode criar uma página de configuração extra. Esta página permite configurar a URL da página de conteúdo, normalmente usando parâmetros de cadeia de caracteres de consulta de URL para carregar o conteúdo apropriado para esse contexto. Isso ocorre porque seu canal ou guia de grupo pode ser adicionado a várias equipes ou chats em grupo. Em cada instalação subsequente, os usuários podem configurar a guia, permitindo que você personalize a experiência conforme necessário. Quando os usuários adicionam ou configuram uma guia, uma URL é associada à guia apresentada na interface do usuário do Teams. A configuração de uma guia simplesmente adiciona mais parâmetros a essa URL. Por exemplo, quando você adiciona a guia Azure Boards, a página de configuração permite que você escolha qual placa a guia carrega. A URL da página de configuração é especificada pela configurationUrl propriedade na matriz no configurableTabsmanifesto do aplicativo.

Para guias estáticas, você pode fixar uma contentUrl guia de chat ou reunião. Isso permite ignorar a caixa de diálogo de configuração obrigatória e fazer com que os usuários usem o aplicativo muito mais rapidamente. Você também pode alterar o contentUrl em runtime. Isso permite criar um objeto de guia que funciona em todas as áreas de superfície do Teams. Para obter mais informações, confira migrar sua guia configurável para a guia estática.

Você pode ter vários canais ou guias de grupo e até 16 guias estáticas por aplicativo.

Ferramentas para criar guias

Próxima etapa

Pré-requisitos

Confira também