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 do Windows instalado a partir do Microsoft 365 Apps Canal Atual.
• NodeJS (com npm) instalado.
• Biblioteca da CLI v2 do Teams Toolkit instalada a partir do npm.
• Visual Studio Code instalado no seu ambiente de desenvolvimento.
• Extensão do Toolkit de Agentes do Microsoft 365 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 Toolkit de Agentes do Microsoft 365 (anteriormente conhecido como Toolkit do Teams) ou expandir uma aplicação de reunião do Teams existente 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 Toolkit de Agentes 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 Microsoft 365 Agents 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. Selecione F5 para depurar e executar o exemplo localmente no Teams. O Teams pede-lhe para instalar a aplicação.

6. Selecione Adicionar.

   

7. Procure e selecione a reunião que agendou anteriormente e percorra a caixa de diálogo para selecionar Ir.

   

8. 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 Microsoft Entra registo de aplicações para o início de sessão único (SSO).
• Carregue a sua aplicação atualizada no Teams Administração Center.

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 Toolkit de Agentes 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 Toolkit de Agentes:

1. Abra a sua aplicação no Visual Studio Code e selecione Extensão do Toolkit de Agentes do Microsoft 365.
2. Em Ver, selecione Paleta de Comandos... ou Ctrl+Shift+P.
3. Execute o comando Microsoft 365 Agents: 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 Toolkit de Agentes 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 Microsoft Entra registo de aplicações para SSO

Microsoft Entra início de sessão único (SSO) 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 Do 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 Toolkit de Agentes, 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	Um modelo para aplicações que utiliza apenas no contexto de uma reunião do Teams.	Exibir

Confira também

Suporte e comentários