O que são extensões de mensagens?

  • 5 minutos

Quando cria uma extensão de mensagem, cria uma aplicação para o Microsoft Teams que é expandida através do Microsoft 365. Expandir a aplicação permite-lhe aparecer no Microsoft Outlook e no Microsoft 365 Copilot como um plug-in.

Uma aplicação alargada do Microsoft Teams é referida como uma aplicação do Microsoft 365. Uma aplicação do Microsoft 365 utiliza um manifesto de aplicação comum, o formato de empacotamento de aplicações e as ferramentas de programador e administrador que utiliza para criar uma aplicação para o Microsoft Teams.

Uma extensão de mensagem é uma funcionalidade de aplicação e utiliza um bot para comunicar entre o utilizador e o sistema externo.

Capacidades da extensão de mensagens

As capacidades da sua extensão de mensagem, como aparece na interface de utilizador e as interações que pode suportar, são definidas no manifesto da aplicação.

Os comandos e os processadores de mensagens são capacidades que uma extensão de mensagem pode ter. Uma extensão de mensagem pode utilizar uma combinação de comandos de pesquisa e ação e processadores de mensagens.

Existem dois tipos de comandos:

  • Os comandos de pesquisa permitem que os utilizadores pesquisem sistemas externos e insiram os resultados dessa pesquisa numa mensagem sob a forma de um card.
  • Comandos de ação, permitem que os utilizadores atuem em mensagens no Teams, apresentando um pop-up modal que pode ser utilizado para recolher ou apresentar informações.

Infográfico que mostra as diferenças visuais e funcionais entre um comando de pesquisa e ação na interface de utilizador do Microsoft Teams.

Os processadores de mensagens permitem que a extensão de mensagem desfralda as ligações quando um URL com um determinado domínio é colado na caixa de mensagem de composição.

Captura de ecrã de uma ligação na caixa de mensagem de composição do Microsoft Teams. É apresentada uma card adaptável incorporada na área de composição de mensagens.

Comandos de pesquisa

Os comandos de pesquisa são utilizados para procurar sistemas externos e devolver resultados como cartões formatados avançados. Ao criar um plug-in de extensão de mensagem Microsoft 365 Copilot, precisa de uma aplicação que contenha um comando de pesquisa de extensão de mensagem.

Captura de ecrã a mostrar os resultados da pesquisa devolvidos por uma extensão de mensagem baseada em pesquisa no Microsoft Teams.

Como funciona uma extensão de mensagem?

As extensões de mensagens utilizam um bot registado no Bot Framework para comunicar entre um cliente e o sistema externo.

O Bot Framework é uma plataforma fornecida pela Microsoft, que lhe fornece as ferramentas e serviços de que precisa para criar, testar, implementar e gerir bots.

Uma extensão de mensagem é composta por um recurso de bot, um Microsoft Entra registo de aplicações e código que utiliza o SDK do Bot Framework para processar interações do utilizador.

A imagem seguinte mostra uma estrutura de alto nível de uma extensão de mensagem:

Diagrama a mostrar a estrutura de alto nível de uma extensão de mensagem.

O serviço de bot regista um bot com o Bot Framework e recebe pedidos do cliente quando o utilizador interage com a extensão de mensagem. Envia pedidos para um serviço Web, que contém o código do bot. O serviço Web utiliza as credenciais de registo da aplicação de bot no Microsoft Entra para autenticar com o serviço de bot. Recolhe dados do sistema externo e devolve os dados ao serviço de bot, que é transmitido de volta para o cliente.

Suponha que um utilizador inicia uma pesquisa com uma extensão de mensagem. O diagrama de sequência seguinte mostra as interações:

Diagrama a mostrar as interações entre os componentes da extensão de mensagens quando um utilizador inicia uma pesquisa e a extensão da mensagem devolve os resultados da pesquisa ao utilizador.

  1. O utilizador abre a extensão de mensagem no cliente e introduz uma consulta de pesquisa.
  2. O cliente envia um pedido para o serviço de bot através de um ponto final de canal, que contém informações sobre a consulta do utilizador.
  3. O serviço de bot envia um pedido para um ponto final de mensagens exposto no serviço Web para processar a consulta do utilizador.
  4. O ponto final de mensagens recebe o pedido e invoca o adaptador de bot. O adaptador de bot utiliza o bot Microsoft Entra credenciais de registo de aplicações para proteger a comunicação entre o serviço Web e o serviço de bot.
  5. O adaptador de bot invoca o OnTeamsMessageExtensionQuery método na classe de processador de atividade do bot, que contém a lógica para processar o pedido recebido.
  6. O processador de atividade do bot obtém dados do sistema externo. Cria um MessageExtensionResult, que contém os dados externos como cartões formatados avançados e cria um MessageExtensionResponse, que contém o MessageExtensionResult.
  7. O adaptador de bot recebe a resposta do processador de atividade do bot e cria uma resposta HTTP.
  8. O ponto final de mensagens devolve a resposta ao serviço de bot.
  9. O serviço de bot devolve a resposta através do ponto final do canal para a extensão da mensagem.
  10. A extensão de mensagem compõe a resposta no cliente e apresenta os resultados da pesquisa ao utilizador.

Quer a extensão da sua mensagem suporte, comandos de pesquisa ou ação ou a desfraldamento da ligação, ocorre o mesmo fluxo. O serviço de bot reencaminha um pedido para o seu serviço Web que processa e responde ao mesmo.