Estender um aplicativo de reunião do Teams para o Outlook

Em todo o ecossistema do Microsoft 365, a maioria dos usuários mensais agenda suas reuniões do Microsoft Teams do Outlook. Para ajudar os usuários a permanecer no fluxo de seu trabalho, os aplicativos de reunião do Teams agora têm suporte no Outlook. Você pode configurar e adicionar aplicativos de reunião às reuniões do Teams agendadas no Outlook e também executar aplicativos de reunião no calendário do Outlook.

Os aplicativos de reunião são essencialmente aplicativos de guia do Teams projetados para promover a colaboração antes, durante e depois das reuniões. Você pode especificar quais contextos o aplicativo de reunião dá suporte no manifesto do aplicativo (anteriormente chamado de manifesto do aplicativo Teams) por meio da propriedade configurbleTabs.context .

Observação

Além de configurableTabs, seu aplicativo de reunião deve conter pelo menos um recurso de aplicativo no escopo pessoal (por exemplo, staticTabs), para que ele esteja disponível no Outlook.

A tabela a seguir mostra os contextos do aplicativo de reunião do Teams com suporte no Outlook:

Contexto de reunião do Teams	Valor do manifesto do aplicativo	Valor do TeamsJS	Suporte ao Outlook
Exibição de detalhes da reunião	meetingDetailsTab	frameContext.content	✔️
Exibição de chat da reunião	meetingChatTab	frameContext.content	✔️
Exibição do painel lateral da reunião	meetingSidePanel	frameContext.sidePanel	✔️
Visão do Estágio de Reunião	meetingStage	frameContext.meetingStage	❌

Se o aplicativo de reunião dá suporte a Stageview, outros efeitos na reunião ou contém recursos como extensões de mensagens e bots, eles continuarão a funcionar no Teams quando a reunião for agendada do Outlook, mas não aparecer ou executar no Outlook.

Pré-requisitos

Para visualizar seu aplicativo de reunião do Teams no Outlook, verifique o seguinte:

• Um locatário de área restrita do desenvolvedor do Microsoft 365 com o carregamento habilitado.
• Um ambiente de teste com o Outlook para a área de trabalho do Windows instalado no canal Microsoft 365 Apps Atual.
• NodeJS (com npm) instalado.
• Biblioteca da CLI do TeamsFx v2 instalada a partir do npm.
• Visual Studio Code instalado em seu ambiente de desenvolvimento.
• Extensão do Teams Toolkit para Visual Studio Code.

Para visualizar seu aplicativo de reunião do Teams no Outlook, você pode criar um novo aplicativo de reunião com o Teams Toolkit ou estender um aplicativo de reunião do Teams existente no Outlook.

Criar aplicativo de reunião do Teams para Outlook

Você pode criar um aplicativo de reunião do Teams para o Outlook por meio da extensão do Teams Toolkit para Visual Studio Code. Para criar um aplicativo de reunião do Teams para visualizar no Outlook:

1. Acesse o Teams e entre usando sua conta de locatário de área restrita.

2. Selecione Calendário>Nova reunião e agende uma reunião.

   

3. Abra a extensão kit de ferramentas do Teams em Visual Studio Code e selecione Exibir Exemplos.

4. Selecione My First Meeting App>Create e especifique a pasta para criar o workspace.

   

5. Pressione a tecla F5 para depurar e executar o exemplo localmente no Teams. O Teams solicita que você instale o aplicativo.

6. Selecione Adicionar a uma reunião na lista suspensa e selecione a reunião agendada anteriormente.

   

7. Selecione a configuração da guia de exemplo e selecione Salvar. O aplicativo está disponível no modo de exibição de chat da reunião.

   

Estender um aplicativo de reunião do Teams existente para o Outlook

Para estender seu aplicativo de reunião do Teams existente no Outlook, verifique o seguinte:

• Atualize o manifesto do aplicativo.
• Use a biblioteca de clientes JavaScript do Microsoft Teams (TeamsJS) v2.5.0 ou posterior.
• Configurar cabeçalhos da Política de Segurança de Conteúdo.
• Atualize Microsoft Entra registro do aplicativo para SSO (logon único).
• Carregue seu aplicativo atualizado no Teams Administração Center.

Se você tiver um aplicativo de reunião existente, faça uma cópia ou um branch do projeto de produção e atualize seu aplicativo id no manifesto do aplicativo para usar um novo identificador diferente da ID do aplicativo de produção para teste.

Atualizar seu manifesto do aplicativo

Atualize a versão do esquema do manifesto do aplicativo (anteriormente chamada de manifesto de aplicativo do Teams) para 1.13 ou posterior.

Abra o manifesto do aplicativo teams e atualize as propriedades e manifestVersion da $schema seguinte maneira:

{
    "$schema" : "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
    "manifestVersion" : "1.16"
}

Usar o TeamsJS versão 2.5.0 ou posterior

Use a biblioteca de clientes do TeamsJS versão 2.5.0 ou posterior para estender seu aplicativo de reunião do Teams para ser executado no Outlook. Se o aplicativo usar o TeamsJS v2.5.0 ou posterior, as alterações no código do aplicativo não serão necessárias para serem executadas no Outlook.

Se você precisar atualizar o pacote npm do TeamsJS do v1.x.x para o v2.x.x TeamsJS mais recente, poderá usar o Teams Toolkit para ajudar a identificar e automatizar as alterações de código necessárias. Para obter mais informações, confira Biblioteca do TeamsJS.

Siga estas etapas para atualizar o TeamsJS para a versão mais recente usando o Teams Toolkit:

1. Abra seu aplicativo no Visual Studio Code e selecione extensão do Teams Toolkit.
2. Em Exibição, selecione Paleta de Comandos... ou Ctrl+Shift+P.
3. Execute o comando Teams: Upgrade Teams JS SDK and code references.

Suas referências @microsoft/teams-js@2.x.x de arquivo package.json e seus *.js/.ts arquivos e *.jsx/.tsx são atualizados com:

• Importar instruções para teams-js@2.x.x.
• Chamadas de função, Enum e Interface para teams-js@2.x.x.
• Novos "TODO" lembretes de comentários sinalizando áreas que podem ser afetadas por alterações de interface de contexto .
• Novos "TODO" lembretes de comentários para converter funções de retorno de chamada em promessas.

Observação

Atualizar para a versão mais recente do TeamsJS por meio do Teams Toolkit não atualiza o código nos arquivos html. Você deve atualizar os arquivos html manualmente.

Configurar cabeçalhos CSP para o Outlook

Os aplicativos de guia do Teams são hospedados dentro de elementos iframe no Outlook, como estão no Teams. Se o aplicativo usar cabeçalhos CSP ( Política de Segurança de Conteúdo ), adicione outlook.office.com como um ancestral de quadro.

Atualizar Microsoft Entra registro de aplicativo para SSO

Microsoft Entra SSO (logon único) para aplicativos de reunião funciona da mesma maneira no Outlook que no Teams. No entanto, você precisa adicionar manualmente a ID do aplicativo do Outlook ao seu registro de aplicativo Microsoft Entra.

1. Entre em portal do Azure com sua conta de locatário de teste.

2. Abra Registros de aplicativo.

3. Selecione seu aplicativo.

4. Selecione Gerenciar>Expor uma API.

5. Na seção Aplicativos cliente autorizados , adicione o seguinte Client Id valor:

   Microsoft 365 aplicativo cliente	ID do cliente
   Outlook para área de trabalho	d3590ed6-52b3-4102-aeff-aad2292ab01c

   Para obter mais informações sobre IDs de aplicativo cliente usadas para estender aplicativos do Teams no Microsoft 365, confira Guias do Teams no Microsoft 365 e no Outlook.

Você pode carregar seu aplicativo personalizado no centro de administração do Teams e visualizar seu aplicativo de reunião no Outlook.

Carregar seu aplicativo personalizado no centro de administração do Teams

Para testar seu aplicativo no Microsoft 365 e no Outlook, carregue seu pacote de aplicativo no centro de administração do Teams.

1. Empacotar o manifesto do aplicativo do Teams e os ícones do aplicativo em um arquivo zip. Para criar um pacote de aplicativos por meio do Teams Toolkit, consulte build app package.

2. Acesse o centro de administração do Teams e selecione Aplicativos> do TeamsGerenciar aplicativos.

3. Selecione Carregar novo aplicativo e selecione seu pacote de aplicativos.

Depois que o aplicativo de reunião for carregado no centro de administração do Teams, ele estará disponível no Teams e no Outlook. Para que seu aplicativo seja exibido no menu Aplicativos aguarde alguns minutos e reinicie o Outlook para Windows.

Visualizar seu aplicativo de reunião no Outlook

Para visualizar seu aplicativo de reunião no Outlook para Windows, verifique se o aplicativo está em execução localmente e siga as etapas:

1. Abra o Outlook para Windows conectado com sua conta de locatário de teste. Se o Outlook já estiver em execução, feche-o e reinicie-o novamente.

2. Abrir Calendário>Nova Reunião. Para que um aplicativo de reunião seja executado no Outlook, verifique se a reunião é uma Reunião do Teams , pois outras reuniões agendadas do Outlook não têm suporte.

3. Na janela de agendamento da reunião, selecione Todos os Aplicativos. Seu aplicativo de reunião carregado aparece entre seus aplicativos de reunião instalados.

   

4. Selecione seu aplicativo de reunião. Uma caixa de diálogo de configuração é exibida, em que o usuário configura as configurações relevantes do aplicativo para sua reunião específica.

   

5. Selecione Adicionar. Seu aplicativo de reunião exibido na seção Aplicativos e no painel lateral da janela de agendamento.

Para remover ou configurar seu aplicativo na janela de agendamento, selecione o menu suspenso em seu aplicativo e selecione o seguinte:

• Sobre: como o aplicativo aparece na Microsoft Teams Store.
• Configurações: atualize a configuração do aplicativo para a reunião específica.
• Remover: remova o aplicativo da reunião.

Exemplo de código

Nome de exemplo	Descrição	Node.js
Aplicativo de reunião Do HelloWorld	Aplicativo de reunião simples que demonstra a exibição de detalhes da reunião, a exibição do chat e o painel lateral. Funciona no Teams e no Outlook.	Exibir

Confira também

• Estender aplicativos do Teams pelo Microsoft 365
• Suporte e comentários