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 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.
• 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 Microsoft 365 Apps Canal Atual.
• (Opcional) O Microsoft Visual Studio Code com a extensão Toolkit de Agentes do Microsoft 365.

Criar ou expandir uma extensão de mensagem

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 Toolkit de Agentes do Microsoft 365 (anteriormente conhecido como Toolkit do Teams) 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 Toolkit de Agentes 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 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.

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 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.

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 Toolkit de Agentes, veja Criar pacote de aplicações.

Detetei um problema

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 Microsoft Entra registo de aplicações do 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"
}

Pode utilizar o Toolkit de Agentes para validar o manifesto da aplicação e identificar quaisquer erros.

Especificar os requisitos de runtime do anfitrião

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.

Para obter mais informações, veja como especificar os requisitos de runtime do anfitrião do Microsoft 365 no manifesto da sua aplicação.

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 portal do Azure ou 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 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 Toolkit de Agentes, 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.

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

Detetei um problema

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 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 card 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	Esta aplicação de exemplo apresenta um bot Node.js que implementa a desfraldamento de ligações nas extensões de mensagens do Microsoft Teams.	View
Separador em Stageview	Esta aplicação de exemplo demonstra a utilização do separador Teams na vista de fase com Node.js, com elementos colaborativos e capacidades interativas.	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