Estender uma extensão de mensagem do Teams Microsoft 365
Artigo
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 card 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 android e iOS podem receber e efetuar ações em cartões das suas aplicações que lhes foram enviadas pelos 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 as caixas de diálogo.
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.
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.
Pode criar uma aplicação de extensão de mensagens do Teams para o Outlook através da extensão Do Teams Toolkit para Visual Studio Code. Para criar uma aplicação de extensão de mensagem para o Outlook, certifique-se do seguinte:
Selecione Paleta de Comandos... na opção Ver ou Ctrl+Shift+P.
Selecione Teams: Criar uma Nova Aplicação.
Selecione Extensão de Mensagem na lista pendente.
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.
Selecione uma linguagem de programação preferencial.
Selecione uma localização no seu computador local para a pasta da área de trabalho e introduza o nome da aplicação.
Selecione Paleta de Comandos... na opção Ver ou Ctrl+Shift+P.
Introduza Teams: aprovisione para criar os recursos da aplicação relevantes, como Serviço de Aplicativo do Azure, plano Serviço de Aplicativo, Bot do Azure e Identidade Gerida, na sua conta do Azure.
Selecione uma subscrição e um grupo de recursos.
Selecione Aprovisionar. Em alternativa, pode selecionar Aprovisionar na secção CICLO DE VIDA da extensão.
Selecione Paleta de Comandos... na opção Ver ou Ctrl+Shift+P.
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.
Selecione Implantar.
Abra o Visual Studio Code.
Selecione Paleta de Comandos... na opção Ver ou Ctrl+Shift+P.
Selecione Teams: Criar uma Nova Aplicação.
Selecione Extensão de Mensagem na lista pendente.
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).
Selecione a linguagem de programação preferencial.
Selecione uma localização no seu computador local para a pasta da área de trabalho e introduza o nome da aplicação.
Selecione Paleta de Comandos... na opção Ver ou Ctrl+Shift+P.
Introduza Teams: aprovisione para criar os recursos da aplicação relevantes, como Serviço de Aplicativo do Azure, plano Serviço de Aplicativo, Bot do Azure e Identidade Gerida, na sua conta do Azure.
Selecione uma subscrição e um grupo de recursos.
Selecione Aprovisionar. Em alternativa, pode selecionar Aprovisionar na secção CICLO DE VIDA da extensão.
Selecione Paleta de Comandos... na opção Ver ou Ctrl+Shift+P.
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.
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:
Especificar os requisitos de runtime do anfitrião (pré-visualização do programador)
Para garantir que a sua aplicação proporciona sempre aos clientes experiências de alta qualidade, pode personalizar o comportamento da sua aplicação em anfitriões do Microsoft 365 aplicáveis ou omiti-la de surgir em contextos que não está pronto para suportar. Utilize o manifesto da aplicação para especificar quaisquer relações de dependência entre capacidades da sua aplicação e requisitos de runtime específicos dos seus separadores estáticos, extensões de mensagens e bots.
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.
Em Canais disponíveis, selecione Canal do Microsoft 365 .
Selecione Aplicar.
Confirme que o seu canal do Microsoft 365 está listado juntamente com o Microsoft Teams no painel Canais do bot.
Atualizar Microsoft Entra registo de aplicações 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 Microsoft Entra autenticação de início de sessão único.
Microsoft Entra início de sessão único (SSO) 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 à Microsoft Entra registo da aplicação do bot no portal Registros de aplicativo do inquilino.
Entre no portal do Azure com sua conta de locatário da área restrita.
Selecione Registros de aplicativos.
Selecione o nome do aplicativo para abrir o registro do aplicativo.
Selecione Gerir>Expor uma API.
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.
Crie um ficheiro .zip com o manifesto da aplicação e os ícones da aplicação.
Aceda ao Microsoft Teams e inicie sessão com a sua conta de inquilino do sandbox.
Selecione Aplicativos>Gerencie seus aplicativos>Carregue um aplicativo.
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 aplicação em execução no Outlook na Web, siga estes passos:
Inicie sessão no outlook.com com as credenciais de inquilino de teste.
Selecione Nova mensagem.
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.
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.
A fonte deste conteúdo pode ser encontrada no GitHub, onde você também pode criar e revisar problemas e solicitações de pull. Para obter mais informações, confira o nosso guia para colaboradores.
Comentários do Platform Docs
O Platform Docs é um projeto código aberto. Selecione um link para fornecer comentários:
Learn how to build message extensions that allow users to interact with external services within their flow of work in Microsoft Teams and Microsoft 365 Copilot.
Demonstre habilidades para planejar, implantar, configurar e gerenciar o Microsoft Teams para se concentrar na colaboração e comunicação eficientes e eficazes em um ambiente do Microsoft 365.