Estender uma extensão de mensagem do Teams Microsoft 365

As extensões de mensagem permitem que os usuários interajam com seu serviço Web usando botões e formulários. Os usuários podem pesquisar ou iniciar ações em um sistema externo do Microsoft Teams e do Outlook estendendo seus aplicativos do Teams pelo Microsoft 365. Há dois tipos de extensões de mensagem:

• extensões de mensagem baseadas em Pesquisa: permitir que os usuários pesquisem um sistema externo e compartilhem resultados por meio da área de mensagem de composição do cliente.

• Extensões de mensagem baseadas em ação: permitir que usuários com um pop-up modal coletem ou exibam informações, processem a interação e enviem as informações de volta ao cliente como uma cartão avançada.

Observação

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

Os usuários móveis do Outlook no Android e no iOS podem receber e executar ações em cartões de seus aplicativos que foram enviados a eles por usuários no Outlook na Web e no Outlook para Windows.

A extensão de mensagem do Teams no Microsoft 365 também dá suporte à desenrolação de link que exibe cartões para iniciar o Stageview e módulos de tarefa.

Pré-requisitos

Para estender sua extensão de mensagem do Teams ao Outlook, verifique o seguinte:

• Verifique se há suporte a extensões de mensagens no Outlook para área de trabalho, Web e móvel do Windows, confira a tabela de suporte em estender aplicativos do Teams pelo Microsoft 365.
• Um locatário de área restrita do Programa para Desenvolvedores do Microsoft 365. Para extensão de mensagem baseada em ação, registre o locatário do desenvolvedor para versões direcionadas do Microsoft 365.
• Um ambiente de teste com aplicativos do Microsoft 365 instalados do Microsoft 365 Apps Canal Atual.
• (Opcional) Código do Microsoft Visual Studio com a extensão Kit de Ferramentas do Teams.

Para estender sua extensão de mensagem do Teams ao Outlook, você pode criar um novo aplicativo de extensão de mensagens com o Teams Toolkit ou estender um aplicativo de extensão de mensagens do Teams existente para o Outlook.

Criar um aplicativo de extensão de mensagem para o Outlook

Você pode criar um aplicativo de extensão de mensagens do Teams para Outlook por meio da extensão do Teams Toolkit para Visual Studio Code. Para criar um aplicativo de extensão de mensagens para o Outlook, verifique o seguinte:

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

Você pode criar uma extensão de mensagem baseada em pesquisa ou de ação.

Extensão de mensagem baseada em Pesquisa

1. Abra o Visual Studio Code.

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

3. Selecione Teams: criar um novo aplicativo.

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

5. Selecione Resultados Pesquisa Personalizados para baixar o código de exemplo de uma extensão de mensagem baseada em pesquisa do Teams usando o manifesto de aplicativo mais recente (anteriormente chamado de manifesto do aplicativo Teams).

   

   Você também pode baixar o código de exemplo no painel esquerdo, em DESENVOLVIMENTO, selecione Exibir Exemplos. Uma guia Exemplos é exibida, no campo de pesquisa insiraNPM Pesquisa Conector.

   

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

7. Selecione um local no computador local para a pasta workspace e insira o nome do aplicativo.

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

9. Insira o Teams: provisione para criar os recursos de aplicativo relevantes, como Serviço de Aplicativo do Azure, Serviço de Aplicativo plano, Bot do Azure e Identidade Gerenciada, em sua conta do Azure.

10. Selecione uma assinatura e um grupo de recursos.

11. Selecione Provisionar. Como alternativa, você pode selecionar Provisionar na seção LIFECYCLE da extensão.

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

13. Insira Teams: implante para implantar o código de exemplo nos recursos provisionados no Azure e inicie o aplicativo. Como alternativa, você pode selecionar Implantar na seção LIFECYCLE da extensão.

14. Selecione Implantar.

Extensão de mensagem baseada em ação

1. Abra o Visual Studio Code.

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

3. Selecione Teams: criar um novo aplicativo.

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

5. Selecione Coletar Dados de Entrada e Processo de Formulário para baixar o código de exemplo de uma extensão de mensagem baseada em ação do Teams usando o manifesto de aplicativo mais recente (anteriormente chamado de manifesto do aplicativo Teams).

   

6. Selecione linguagem de programação preferencial.

7. Selecione um local no computador local para a pasta workspace e insira o nome do aplicativo.

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

9. Insira o Teams: provisione para criar os recursos de aplicativo relevantes, como Serviço de Aplicativo do Azure, Serviço de Aplicativo plano, Bot do Azure e Identidade Gerenciada, em sua conta do Azure.

10. Selecione uma assinatura e um grupo de recursos.

11. Selecione Provisionar. Como alternativa, você pode selecionar Provisionar na seção LIFECYCLE da extensão.

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

13. Insira Teams: implante para implantar o código de exemplo nos recursos provisionados no Azure e inicie o aplicativo. Como alternativa, você pode selecionar Implantar na seção LIFECYCLE da extensão.

14. Selecione Implantar.

Agora, você pode carregar seu aplicativo no Teams e visualizar sua extensão de mensagem no Outlook. Para compilar seu pacote de aplicativos por meio do Teams Toolkit, consulte build app package.

Estender um aplicativo de extensão de mensagens do Teams existente para o Outlook

Para estender o aplicativo de extensão de mensagens do Teams existente para o Outlook, verifique o seguinte:

• Atualize o manifesto do aplicativo.
• Adicione o canal do Microsoft 365 para seu aplicativo.
• Atualize Microsoft Entra registro de aplicativo para SSO.
• Carregue seu aplicativo atualizado no Teams.
• Visualizar sua extensão de mensagem no Outlook

Atualizar seu manifesto do aplicativo

Atualize o manifesto do aplicativo (anteriormente chamado de manifesto de aplicativo do Teams) ou 1.13 posterior para permitir que sua extensão de mensagem do Teams seja executada no Outlook.

Abra o manifesto do aplicativo 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 seu aplicativo

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 aproveita o esquema de mensagens do SDK do Bot Framework e o protocolo de comunicação segura por meio de um canal do Teams registrado para o bot.

Para que os usuários interajam com sua extensão de mensagem do Outlook, você precisa habilitar o canal do Microsoft 365 para o recurso de bot do Azure do aplicativo de extensão de mensagem.

Observação

Se você tiver habilitado anteriormente o canal do Outlook para seu bot, precisará habilitar o canal do Microsoft 365 para que sua extensão de mensagem funcione corretamente no Microsoft Outlook. O canal do Outlook não é mais usado para extensões de mensagem em execução no Outlook e pode ser desabilitado.

1. Acesse o microsoft portal do Azure ou o portal do Bot Framework (se você já registrou lá), acesse o recurso do bot.

2. Em Canais de Configurações>.

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

   

4. Selecione Aplicar.

   

5. Confirme se o canal do Microsoft 365 está listado junto com o Microsoft Teams no painel Canais do bot.

Atualizar Microsoft Entra registro de aplicativo para SSO

Observação

Você pode ignorar essa etapa se estiver criando um aplicativo para o Outlook usando o Teams Toolkit, pois o cenário não envolve Microsoft Entra autenticação de logon único.

Microsoft Entra SSO (logon único) para extensões de mensagem funciona da mesma maneira no Outlook que no Teams. No entanto, você precisa adicionar vários identificadores de aplicativo cliente ao Microsoft Entra registro de aplicativo do bot no portal Registros de aplicativo do locatário.

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 Gerenciar>Expor uma API.

5. Na seção Aplicativos cliente autorizados , verifique se 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
   Área de trabalho do Microsoft 365	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 seu aplicativo personalizado no Teams

Carregue sua extensão de mensagem atualizada (pacote de aplicativo) no Teams. Depois de concluir, a extensão de mensagem será exibida em seus Aplicativos instalados da área de mensagem de composição.

1. Crie um arquivo .zip com ícones de manifesto de aplicativo e aplicativo.

2. Acesse o Microsoft Teams e entre usando sua conta de locatário de área restrita.

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

   

4. Selecione a opção Carregar um aplicativo personalizado , selecione seu arquivo .zip e instale -o (Adicionar) ao cliente do Teams.

   

Depois de ser carregada pelo Teams, sua extensão de mensagem estará disponível no Outlook para área de trabalho e Web do Windows.

Visualizar sua extensão de mensagem no Outlook

Veja como testar sua extensão de mensagem em execução no Outlook na Web. Para visualizar o aplicativo em execução no Outlook na Web, siga estas etapas:

1. Entre em outlook.com usando suas credenciais de locatário de teste.

2. Selecione Nova mensagem.

3. Selecione Aplicativos na faixa de opções.

   

Sua extensão de 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

Ao depurar sua extensão de mensagem, você pode identificar a origem (proveniente do Teams versus Outlook) das solicitações de bot pelo campo channelId do objeto Activity . Quando um usuário executa uma consulta, seu serviço recebe um objeto Bot Framework Activity padrão. Uma das propriedades no objeto Activity é channelId, que tem o valor de ou m365extensions, dependendo de msteams onde a solicitação do bot se origina. Para obter mais informações, consulte SDK de extensões de mensagem baseadas em pesquisa e extensões de mensagens baseadas em ação SDK.

Limitações

Enquanto sua extensão de mensagem atualizada continua a ser executada no Teams, você deve estar ciente das seguintes limitações:

• As extensões de mensagem no Outlook só têm suporte no compose contexto. No manifesto do aplicativo do Teams, contextos de extensão de mensagem como commandBox e message não têm suporte no Outlook.

• Extensões de mensagem baseadas em ação que enviam cartões para a caixa de composição têm suporte no Outlook. No entanto, não há suporte para o uso de bots para entregar cartões . Nesse cenário, você pode converter sua extensão de mensagem para enviar cartões para a caixa de composição no Outlook.

• Você não pode inserir mais de cinco Cartões Adaptáveis em um email.

• Ações de cartão do tipo messageBack, imBack, invokee signin não têm suporte. openURLé a única ação de cartão com suporte.

• Há suporte para ações de Cartão Adaptável. Para Action.Submit apenas a visão de estágio e o lançamento de taskmodule , há suporte.

Observação

Ao testar um aplicativo com a desenrolação de link, verifique se você remove o aplicativo manualmente após o teste. Se vários aplicativos estiverem monitorando o mesmo domínio, o aplicativo instalado mais recentemente poderá não ser invocado para desenrolar o link no Outlook, como faria 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	Aplicativo de exemplo do Teams Toolkit para criar um aplicativo de extensão de mensagem. Funciona no Teams e no Outlook.	View
Teams Link Unfurling	Aplicativo do Teams simples para demonstrar a desenrolação de link. Funciona no Teams, Outlook.	Exibir
Tab in Stageview	Aplicativo de exemplo de guia do Microsoft Teams para demonstrar uma guia no Stageview. Funciona no Teams, Outlook, aplicativo do Microsoft 365.	View
Extensão de mensagem baseada em ação do Teams para o Microsoft 365	Aplicativo de exemplo do Teams Toolkit para criar um aplicativo de extensão de mensagem. Funciona no Teams e no Outlook.	View

Próxima etapa

Publicar aplicativos do Teams para o Outlook e o aplicativo Microsoft 365

Confira também

Extensões de mensagens