Componentes do Loop baseados em Cartão Adaptável

Observação

Os componentes do Loop baseados em Cartão Adaptável não estão disponíveis no Microsoft Teams e no Microsoft Outlook em clientes móveis e macOS.

Os componentes do Loop baseados em Cartão Adaptável permitem que você crie experiências colaborativas em suas extensões de mensagem do Teams que funcionam em todo o Microsoft 365. Os componentes do Loop baseados em Cartão Adaptável têm conteúdo acionável que permite que os usuários façam atualizações dinâmicas sem precisar alternar contextos entre aplicativos do Microsoft 365, como Teams e Outlook.

Veja a seguir um exemplo de um componente do Loop baseado em Cartão Adaptável:

A captura de tela mostra um componente do Loop baseado em Cartão Adaptável.

Criar um componente do Loop baseado em Cartão Adaptável

Para criar um componente do Loop baseado em Cartão Adaptável, siga estas etapas:

  1. Crie uma extensão de mensagem com um comando de pesquisa.

  2. Adicione o desfralamento de link à extensão de mensagem.

  3. Use Ações Universais para Cartões Adaptáveis e defina a refresh propriedade para garantir que o card esteja sempre atualizado. Para obter mais informações, consulte cartões atualizados.

  4. Estenda sua extensão de mensagem pelo Microsoft 365. Esta etapa inclui as seguintes ações:

    1. Atualize o manifesto do aplicativo para a versão 1.13 ou posterior.
    2. Adicione o canal do Microsoft 365 para o bot.
    3. Atualize o registro do aplicativo Microsoft Entra para logon único (SSO).

  5. Adicione a URL que identifica exclusivamente o card na propriedade metadata.webUrl. A metadata.webUrl propriedade oferece suporte à portabilidade por meio do botão Copiar componente presente no cabeçalho do componente do Loop.

  6. Adicione sua extensão de mensagem ao Teams e visualize sua extensão de mensagem no Outlook. Como alternativa, você também pode depurar seu aplicativo no Portal do Desenvolvedor do Teams usando o botão Visualizar no Teams na página Visão geral .

    Uma captura de tela da página de visão geral do Portal do Desenvolvedor com o botão Visualizar no Teams destacado em vermelho.

Observação

Verifique se o componente do Loop baseado em Cartão Adaptável segue as diretrizes de design para criar uma experiência baseada em Cartão Adaptável acionável e coerente para seus usuários.

Exemplo

O conteúdo JSON a seguir é um exemplo de um componente do Loop baseado em Cartão Adaptável com as metadata propriedades andwebUrl:

{
  "type": "AdaptiveCard",
  "version": "1.6",
  "metadata": {
    "webUrl": "https://contoso.com/tab"
  },
  "refresh": {
    "action": {
      "type": "Action.Execute",
      "title": "Submit",
      "verb": "personalDetailsCardRefresh"
    },
    "userIds": []
  },
  "body": [
    {
      ....
    },
  ]
  }

Esquema

Propriedade Tipo Descrição
metadata Metadata Define várias propriedades de metadados normalmente não usadas para renderizar o card.
webUrl Cadeia de caracteres URL que identifica exclusivamente o card e serve como um fallback do navegador que pode ser usado por alguns hosts.

Observação

  • Quando você copia um componente do Loop baseado em Cartão Adaptável, a URL do componente do Loop é copiada. Quando você cola a URL em um chat do Teams ou no aplicativo Loop, o link é descompactado no componente do Loop baseado em Cartão Adaptável.
  • Os componentes do Loop baseados em Cartão Adaptável usam o mesmo mecanismo de atualização que os Cartões Adaptáveis normais. O conteúdo em um componente do Loop baseado em Cartão Adaptável é atualizado somente quando um usuário abre o componente do Loop.

Exemplo de código

Nome de exemplo Descrição Node.js .NET Manifesto
Extensão de mensagem com o componente do Loop baseado em Cartão Adaptável Este exemplo demonstra uma extensão de mensagem que usa componentes de loop baseados em Cartão Adaptável para habilitar o desenrolamento de links e interações dinâmicas na área de redação. View View Exibir

Confira também

  • Last updated on