Estender uma extensão de mensagem do Teams Microsoft 365

As extensões de mensagens permitem que os utilizadores interajam com o seu serviço Web através de botões e formulários. Os utilizadores podem procurar ou iniciar ações num sistema externo a partir do Microsoft Teams e do Outlook ao expandir as suas aplicações do Teams no Microsoft 365. Existem dois tipos de extensões de mensagens:

• Extensões de mensagens baseadas em pesquisa: permita que os utilizadores pesquisem um sistema externo e partilhem resultados através da área de composição de mensagens do cliente.

• Extensões de mensagens baseadas em ações: permita que os utilizadores com um pop-up modal recolham ou apresentem informações, processem a interação e enviem as informações de volta para o cliente como um cartão avançado.

Observação

As extensões de mensagens baseadas na pesquisa do Teams estão geralmente disponíveis para o Outlook e as extensões de mensagens baseadas em ações estão disponíveis em pré-visualização para o Outlook.

Os utilizadores do Outlook para dispositivos móveis no Android e iOS podem receber e efetuar ações em cartões das suas aplicações que lhes foram enviadas por utilizadores no Outlook na Web e no Outlook para Windows.

A extensão de mensagens do Teams no Microsoft 365 também suporta a desfraldamento de ligações que apresentam cartões para iniciar o Stageview e módulos de tarefas.

Pré-requisitos

Para expandir a extensão de mensagens do Teams para o Outlook, certifique-se do seguinte:

• Verifique se existe suporte para extensões de mensagens no Outlook para ambiente de trabalho, Web e dispositivos móveis windows. Consulte a tabela de suporte na extensão de aplicações do Teams no Microsoft 365.
• Um locatário de área restrita do Programa para Desenvolvedores do Microsoft 365. Para a extensão de mensagem baseada em ações, inscreva o inquilino do programador para Versões Direcionadas do Microsoft 365.
• Um ambiente de teste com aplicações do Microsoft 365 instaladas a partir do Canal Atual do Microsoft 365 Apps.
• (Opcional) Código do Microsoft Visual Studio com a extensão Kit de Ferramentas do Teams.

Para expandir a extensão de mensagens do Teams para o Outlook, pode criar uma nova aplicação de extensão de mensagens com o Teams Toolkit ou expandir uma aplicação de extensão de mensagens do Teams existente para o Outlook.

Criar uma aplicação de extensão de mensagem para o Outlook

Pode criar uma aplicação de extensão de mensagens do Teams para o Outlook através da extensão Teams Toolkit para Visual Studio Code. Para criar uma aplicação de extensão de mensagem para o Outlook, certifique-se do seguinte:

• Carregar seu aplicativo no Teams
• Visualizar sua extensão de mensagem no Outlook

Pode criar uma extensão de mensagem baseada em pesquisa ou com base em ações.

Extensão de mensagem baseada em pesquisa

1. Abra o Visual Studio Code.

2. Selecione Paleta de Comandos... na opção Ver ou Ctrl+Shift+P.

3. Selecione Teams: Criar uma Nova Aplicação.

4. Selecione Extensão de Mensagem na lista pendente.

5. Selecione Resultados da Pesquisa Personalizada para transferir o código de exemplo de uma extensão de mensagem baseada na pesquisa do Teams com o manifesto de aplicação mais recente (anteriormente denominado manifesto de aplicação do Teams).

   

   Também pode transferir o código de exemplo a partir do painel esquerdo, em DESENVOLVIMENTO, selecione Ver Exemplos. É apresentado um separador Exemplos , no campo de pesquisa, introduza Conector de Pesquisa do NPM.

   

6. Selecione uma linguagem de programação preferencial.

7. Selecione uma localização no seu computador local para a pasta da área de trabalho e introduza o nome da aplicação.

8. Selecione Paleta de Comandos... na opção Ver ou Ctrl+Shift+P.

9. Introduza Teams: aprovisione para criar os recursos de aplicações relevantes, como o Serviço de Aplicações do Azure, o plano do Serviço de Aplicações, o Bot do Azure e a Identidade Gerida, na sua conta do Azure.

10. Selecione uma subscrição e um grupo de recursos.

11. Selecione Aprovisionar. Em alternativa, pode selecionar Aprovisionar na secção CICLO DE VIDA da extensão.

12. Selecione Paleta de Comandos... na opção Ver ou Ctrl+Shift+P.

13. Introduza Teams: implemente para implementar o código de exemplo nos recursos aprovisionados no Azure e inicie a aplicação. Em alternativa, pode selecionar Implementar na secção CICLO DE VIDA da extensão.

14. Selecione Implantar.

Extensão de mensagem baseada em ações

1. Abra o Visual Studio Code.

2. Selecione Paleta de Comandos... na opção Ver ou Ctrl+Shift+P.

3. Selecione Teams: Criar uma Nova Aplicação.

4. Selecione Extensão de Mensagem na lista pendente.

5. Selecione Recolher Dados de Entrada e Processo do Formulário para transferir o código de exemplo de uma extensão de mensagem baseada em ações do Teams com o manifesto de aplicação mais recente (anteriormente denominado manifesto de aplicação do Teams).

   

6. Selecione a linguagem de programação preferencial.

7. Selecione uma localização no seu computador local para a pasta da área de trabalho e introduza o nome da aplicação.

8. Selecione Paleta de Comandos... na opção Ver ou Ctrl+Shift+P.

9. Introduza Teams: aprovisione para criar os recursos de aplicações relevantes, como o Serviço de Aplicações do Azure, o plano do Serviço de Aplicações, o Bot do Azure e a Identidade Gerida, na sua conta do Azure.

10. Selecione uma subscrição e um grupo de recursos.

11. Selecione Aprovisionar. Em alternativa, pode selecionar Aprovisionar na secção CICLO DE VIDA da extensão.

12. Selecione Paleta de Comandos... na opção Ver ou Ctrl+Shift+P.

13. Introduza Teams: implemente para implementar o código de exemplo nos recursos aprovisionados no Azure e inicie a aplicação. Em alternativa, pode selecionar Implementar na secção CICLO DE VIDA da extensão.

14. Selecione Implantar.

Agora, pode carregar a sua aplicação no Teams e pré-visualizar a sua extensão de mensagem no Outlook. Para criar o pacote de aplicações através do Teams Toolkit, veja Criar pacote de aplicações.

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

Para expandir a sua aplicação de extensão de mensagens do Teams existente para o Outlook, certifique-se do seguinte:

• Atualize o manifesto da aplicação.
• Adicione o canal do Microsoft 365 para a sua aplicação.
• Atualize o registo da aplicação Microsoft Entra para SSO.
• Carregue a sua aplicação atualizada no Teams.
• Visualizar sua extensão de mensagem no Outlook

Atualizar seu manifesto do aplicativo

Atualize a versão 1.13 de esquema do manifesto da aplicação (anteriormente denominada manifesto de aplicação do Teams) ou posterior para permitir que a extensão de mensagem do Teams seja executada no Outlook.

Abra o manifesto da aplicação e atualize o $schema e manifestVersion com os seguintes valores:

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

Adicionar o canal do Microsoft 365 para a sua aplicação

No Microsoft Teams, uma extensão de mensagem consiste em um serviço Web que você hospeda e um manifesto do aplicativo, que define onde seu serviço Web está hospedado. O serviço Web tira partido do esquema de mensagens do SDK do Bot Framework e do protocolo de comunicação segura através de um canal do Teams registado para o bot.

Para que os utilizadores interajam com a sua extensão de mensagem a partir do Outlook, tem de ativar o canal do Microsoft 365 para o recurso de bot do Azure da aplicação de extensão de mensagens.

Observação

Se tiver ativado anteriormente o canal do Outlook para o seu bot, terá de ativar o canal do Microsoft 365 para que a extensão de mensagem funcione corretamente no Microsoft Outlook. O canal do Outlook já não é utilizado para extensões de mensagens em execução no Outlook e pode ser desativado.

1. Aceda ao portal do Microsoft Azure ou ao portal do Bot Framework (se já se registou anteriormente), aceda ao recurso do bot.

2. Em Canais de Definições>.

3. Em Canais disponíveis, selecione Canal do Microsoft 365 .

   

4. Selecione Aplicar.

   

5. Confirme que o seu canal do Microsoft 365 está listado juntamente com o Microsoft Teams no painel Canais do bot.

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

Observação

Pode ignorar este passo se estiver a criar uma aplicação para o Outlook com o Teams Toolkit, uma vez que o cenário não envolve a autenticação de início de sessão único do Microsoft Entra.

O início de sessão único (SSO) do Microsoft Entra para extensões de mensagens funciona da mesma forma no Outlook como no Teams. No entanto, tem de adicionar vários identificadores de aplicação cliente ao registo da aplicação Microsoft Entra do bot no portal de Registos de aplicações do seu inquilino.

1. Entre no portal do Azure com sua conta de locatário da área restrita.

2. Selecione Registros de aplicativos.

3. Selecione o nome do aplicativo para abrir o registro do aplicativo.

4. Selecione Gerir>Expor uma API.

5. Na secção Aplicações cliente autorizadas , certifique-se de que todos os seguintes Client Id valores estão listados:

   Microsoft 365 aplicativo cliente	ID do cliente
   Área de trabalho e dispositivos móveis do Teams	1fec8e78-bce4-4aaf-ab1b-5451cc387264
   Web do Teams	5e3ce6c0-2b1f-4285-8d4b-75ee78787346
   Microsoft 365 Web	4765445b-32c6-49b0-83e6-1d93765276ca
   Microsoft 365 para ambiente de trabalho	0ec893e0-5785-4de6-99da-4ed124e5296c
   Microsoft 365 mobile	d3590ed6-52b3-4102-aeff-aad2292ab01c
   Outlook para área de trabalho	d3590ed6-52b3-4102-aeff-aad2292ab01c
   Outlook Web Access	bc59ab01-8403-45c6-8796-ac3ef710b3e3
   Outlook Mobile	27922004-5251-4030-b22d-91ecd9a37ea4

Carregar a sua aplicação personalizada no Teams

Carregue a extensão de mensagem atualizada (pacote de aplicações) para o Teams. Depois de concluir, a extensão de mensagem é apresentada nas Aplicações instaladas a partir da área de composição de mensagens.

1. Crie um ficheiro .zip com o manifesto da aplicação e os ícones da aplicação.

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

3. Selecione Aplicativos>Gerencie seus aplicativos>Carregue um aplicativo.

   

4. Selecione a opção Carregar uma aplicação personalizada , selecione o seu ficheiro de .zip e instale-o (Adicionar) ao seu cliente do Teams.

   

Depois de ser carregada através do Teams, a sua extensão de mensagem está disponível no Outlook para ambiente de trabalho e na Web do Outlook para Windows.

Visualizar sua extensão de mensagem no Outlook

Eis como testar a extensão de mensagem em execução no Outlook na Web. Para pré-visualizar a sua aplicação em execução no Outlook na Web, siga estes passos:

1. Inicie sessão no outlook.com com as credenciais de inquilino de teste.

2. Selecione Nova mensagem.

3. Selecione Aplicações no friso.

   

A extensão da sua mensagem está listada. Você pode invocá-lo de lá e usá-lo da mesma forma que faria ao redigir uma mensagem no Teams.

Depuração

À medida que depura a extensão da mensagem, pode identificar a origem (proveniente do Teams versus Outlook) dos pedidos de bot pelo campo channelId do objeto Atividade . Quando um usuário executa uma consulta, seu serviço recebe um objeto Bot Framework Activity padrão. Uma das propriedades no objeto Atividade é channelId, que tem o valor de msteams ou m365extensions, consoante a origem do pedido de bot. Para obter mais informações, veja Search based message extensions SDK and action based messaging extensions SDK (SDK de extensões de mensagens baseadas em pesquisas e extensões de mensagens baseadas em ações).

Limitações

Embora a extensão de mensagens atualizada continue a ser executada no Teams, tem de estar ciente das seguintes limitações:

• As extensões de mensagens no Outlook só são suportadas no compose contexto. No manifesto da aplicação Teams, os contextos de extensão de mensagens, como commandBox e message não são suportados no Outlook.

• As extensões de mensagens baseadas em ações que enviam cartões para a caixa de composição são suportadas no Outlook. No entanto, a utilização de bots para entregar cartões não é suportada. Neste cenário, pode converter a extensão de mensagem para enviar cartões para a caixa de composição no Outlook.

• Não pode inserir mais do que cinco Cartões Ajustáveis num e-mail.

• As ações de cartão do tipo messageBack, imBack, invokee signin não são suportadas. openURL é a única ação de cartão suportada.

• As ações do Cartão Ajustável são suportadas. Para Action.Submit apenas a visão de fase e o início do taskmodule são suportados.

Observação

Quando testar uma aplicação com a ligação a desenrolar-se, certifique-se de que remove a aplicação manualmente após o teste. Se várias aplicações estiverem a monitorizar o mesmo domínio, a aplicação instalada mais recentemente poderá não ser invocada para desvendar a ligação no Outlook, tal como no Teams.

Use os canais daComunidade de desenvolvedores do Microsoft Teams para relatar problemas e fornecer comentários.

Exemplo de código

Nome de exemplo	Descrição	Node.js
Conector de Pesquisa do NPM	Aplicação de exemplo do Teams Toolkit para criar uma aplicação de extensão de mensagem. Funciona no Teams e no Outlook.	View
Desfraldamento da Ligação do Teams	Aplicação Teams simples para demonstrar a desfraldamento da ligação. Funciona no Teams, Outlook.	Exibir
Separador em Stageview	Aplicação de exemplo do separador Microsoft Teams para demonstrar um separador no Stageview. Funciona na aplicação Teams, Outlook e Microsoft 365.	View
Extensão de mensagem baseada em ação do Teams para o Microsoft 365	Aplicação de exemplo do Teams Toolkit para criar uma aplicação de extensão de mensagem. Funciona no Teams e no Outlook.	View

Próxima etapa

Publicar aplicações do Teams para o Outlook e a aplicação Microsoft 365