Expandir uma aplicação de reunião do Teams para o Outlook

Em todo o ecossistema do Microsoft 365, a maioria dos utilizadores mensais agenda as reuniões do Microsoft Teams a partir do Outlook. Para ajudar os utilizadores a manterem-se no fluxo do seu trabalho, as aplicações de reunião do Teams são agora suportadas no Outlook. Pode configurar e adicionar aplicações de reunião às reuniões do Teams agendadas a partir do Outlook e também executar aplicações de reunião no calendário do Outlook.

As aplicações de reunião são essencialmente aplicações de separador do Teams concebidas para fomentar a colaboração antes, durante e depois das reuniões. Pode especificar os contextos que a sua aplicação de reunião suporta a partir do manifesto da aplicação (anteriormente denominado manifesto de aplicação do Teams) através da propriedade configurbleTabs.context .

Observação

Além do , a sua aplicação configurableTabsde reunião tem de conter, pelo menos, uma capacidade de aplicação no âmbito pessoal (por exemplo, staticTabs), para que esteja disponível no Outlook.

A tabela seguinte mostra os contextos da aplicação de reunião do Teams suportados no Outlook:

Contexto de reunião do Teams	Valor do manifesto da aplicação	Valor do TeamsJS	Suporte do Outlook
Vista de detalhes da reunião	meetingDetailsTab	frameContext.content	✔️
Vista de chat da reunião	meetingChatTab	frameContext.content	✔️
Vista do painel lateral da reunião	meetingSidePanel	frameContext.sidePanel	✔️
Descrição da Fase de Reunião	meetingStage	frameContext.meetingStage	❌

Se a sua aplicação de reunião suportar o Stageview, outros efeitos na reunião ou contiver capacidades como extensões de mensagens e bots, estes continuam a funcionar no Teams quando a reunião está agendada a partir do Outlook, mas não é apresentada ou executada no Outlook.

Pré-requisitos

Para pré-visualizar a sua aplicação de reunião do Teams no Outlook, certifique-se do seguinte:

• Um inquilino do sandbox para programadores do Microsoft 365 com o carregamento ativado.
• Um ambiente de teste com o Outlook para ambiente de trabalho windows instalado a partir do Canal Atual do Microsoft 365 Apps.
• NodeJS (com npm) instalado.
• Biblioteca da CLI v2 do TeamsFx instalada a partir do npm.
• Visual Studio Code instalado no seu ambiente de desenvolvimento.
• Extensão Do Teams Toolkit para Visual Studio Code.

Para pré-visualizar a sua aplicação de reunião do Teams no Outlook, pode criar uma nova aplicação de reunião com o Teams Toolkit ou expandir uma aplicação de reunião existente do Teams no Outlook.

Criar uma aplicação de reunião do Teams para o Outlook

Pode criar uma aplicação de reunião do Teams para o Outlook através da extensão Teams Toolkit para Visual Studio Code. Para criar uma aplicação de reunião do Teams para pré-visualizar no Outlook:

1. Aceda ao Teams e inicie sessão com a sua conta de inquilino do sandbox.

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

   

3. Abra a extensão Teams Toolkit no Visual Studio Code e selecione Ver Exemplos.

4. Selecione A Minha Primeira Aplicação> de ReuniãoCriar e especifique a pasta para criar a área de trabalho.

   

5. Prima a tecla F5 para depurar e executar o exemplo localmente no Teams. O Teams pede-lhe para instalar a aplicação.

6. Selecione Adicionar a uma reunião no menu pendente e selecione a reunião que agendou anteriormente.

   

7. Selecione a configuração do separador de exemplo e selecione Guardar. A aplicação está disponível na vista de chat da reunião.

   

Expandir uma aplicação de reunião existente do Teams para o Outlook

Para expandir a sua aplicação de reunião do Teams existente no Outlook, certifique-se do seguinte:

• Atualize o manifesto da aplicação.
• Utilize a biblioteca de cliente JavaScript do Microsoft Teams (TeamsJS) v2.5.0 ou posterior.
• Configurar cabeçalhos da Política de Segurança de Conteúdo.
• Atualize o registo da aplicação Microsoft Entra para o início de sessão único (SSO).
• Carregue a sua aplicação atualizada no Centro de Administração do Teams.

Se tiver uma aplicação de reunião existente, faça uma cópia ou um ramo do projeto de produção e atualize a sua aplicação id no manifesto da aplicação para utilizar um novo identificador diferente do ID da aplicação de produção para teste.

Atualizar seu manifesto do aplicativo

Atualize a versão de esquema do manifesto da aplicação (anteriormente denominada manifesto de aplicação do Teams) para a versão 1.13 ou posterior.

Abra o manifesto da aplicação Teams e atualize as $schema propriedades e manifestVersion da seguinte forma:

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

Utilizar a versão 2.5.0 ou posterior do TeamsJS

Utilize a versão 2.5.0 ou posterior da biblioteca de cliente do TeamsJS para expandir a sua aplicação de reunião do Teams para ser executada no Outlook. Se a sua aplicação utilizar o TeamsJS v2.5.0 ou posterior, as alterações ao código da aplicação não são necessárias para ser executadas no Outlook.

Se precisar de atualizar o seu pacote npm do TeamsJS de v1.x.x para o TeamsJS v2.x.x mais recente, pode utilizar o Teams Toolkit para ajudar a identificar e automatizar as alterações de código necessárias. Para obter mais informações, veja Biblioteca teamsJS.

Siga estes passos para atualizar o TeamsJS para a versão mais recente com o Teams Toolkit:

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

As referências de ficheiro package.json e os ficheiros @microsoft/teams-js@2.x.x*.js/.ts e *.jsx/.tsx são atualizados com:

• Instruções de importação para teams-js@2.x.x.
• As chamadas de Função, Enumeração e Interface para teams-js@2.x.x.
• Novos "TODO" lembretes de comentários que sinalizam áreas que podem ser afetadas pelas alterações da interface de contexto .
• Novos "TODO" lembretes de comentários para converter funções de chamada de retorno em promessas.

Observação

Atualizar para a versão mais recente do TeamsJS através do Teams Toolkit não atualiza o código nos ficheiros html. Tem de atualizar os ficheiros html manualmente.

Configurar cabeçalhos CSP para o Outlook

As aplicações de separador do Teams estão alojadas em elementos iframe no Outlook, tal como no Teams. Se a sua aplicação utilizar cabeçalhos de Política de Segurança de Conteúdo (CSP), adicione outlook.office.com como predecessor de frames.

Atualizar o registo da aplicação Microsoft Entra para SSO

O início de sessão único (SSO) do Microsoft Entra para aplicações de reunião funciona da mesma forma no Outlook como no Teams. No entanto, tem de adicionar manualmente o ID da aplicação Outlook ao registo da aplicação Microsoft Entra.

1. Inicie sessão no portal do Azure com a sua conta de inquilino de teste.

2. Abra Registros de aplicativo.

3. Selecione a sua aplicação.

4. Selecione Gerir>Expor uma API.

5. Na secção Aplicações cliente autorizadas , 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 os IDs de aplicação cliente utilizados para expandir as aplicações do Teams no Microsoft 365, consulte Separadores do Teams no Microsoft 365 e Outlook.

Pode carregar a sua aplicação personalizada no centro de administração do Teams e pré-visualizar a sua aplicação de reunião no Outlook.

Carregar a sua aplicação personalizada no centro de administração do Teams

Para testar a sua aplicação no Microsoft 365 e no Outlook, carregue o pacote de aplicações para o centro de administração do Teams.

1. Empacote o seu manifesto de aplicação do Teams e os ícones da aplicação num ficheiro zip. Para criar um pacote de aplicações através do Teams Toolkit, veja Criar pacote de aplicações.

2. Aceda ao centro de administração do Teams e selecione Aplicações> do TeamsGerir aplicações.

3. Selecione Carregar nova aplicação e selecione o pacote de aplicações.

Depois de a sua aplicação de reunião ser carregada para o centro de administração do Teams, está disponível no Teams e no Outlook. Para que a sua aplicação seja apresentada no menu Aplicações , aguarde alguns minutos e reinicie o Outlook para Windows.

Pré-visualizar a sua aplicação de reunião no Outlook

Para pré-visualizar a sua aplicação de reunião no Outlook para Windows, certifique-se de que a aplicação está a ser executada localmente e siga os passos:

1. Abra o Outlook para Windows com sessão iniciada com a sua conta de inquilino de teste. Se o Outlook já estiver em execução, feche-o e reinicie-o novamente.

2. Abra aNova Reuniãodo Calendário>. Para que uma aplicação de reunião seja executada no Outlook, certifique-se de que a reunião é uma Reunião do Teams , uma vez que não são suportadas outras reuniões agendadas a partir do Outlook.

3. Na janela de agendamento da reunião, selecione Todas as Aplicações. A sua aplicação de reunião carregada é apresentada entre as suas aplicações de reunião instaladas.

   

4. Selecione a sua aplicação de reunião. É apresentada uma caixa de diálogo de configuração, onde o utilizador configura quaisquer definições de aplicação relevantes para a reunião específica.

   

5. Selecione Adicionar. A sua aplicação de reunião é apresentada na secção Aplicações e no painel lateral da janela de agendamento.

Para remover ou configurar a aplicação na janela de agendamento, selecione o menu pendente na sua aplicação e selecione o seguinte:

• Acerca de: como a aplicação é apresentada na Microsoft Teams Store.
• Definições: atualize a configuração da aplicação para a reunião específica.
• Remover: remova a aplicação da reunião.

Exemplo de código

Nome de exemplo	Descrição	Node.js
Aplicação HelloWorld In-meeting	Aplicação de reunião simples que demonstra a vista de detalhes da reunião, a vista de chat e o painel lateral. Funciona no Teams e no Outlook.	Exibir

Confira também

Suporte e comentários