Cartões

  • Artigo

Um cartão é um contêiner de interface do usuário (UI) para obter informações curtas ou relacionadas. Os cartões podem ter várias propriedades e anexos e podem incluir botões que disparam ações de cartão. Ao usar os cartões, você pode organizar informações em grupos e dar aos usuários a oportunidade de interagirem com partes específicas das informações.

Os bots do Microsoft Teams dão suporte aos seguintes tipos de cartões:

  • Cartão Adaptável
  • Cartão Hero
  • Cartão de listagem
  • Cartão do conector para Grupos do Microsoft 365
  • Cartão de recebimento
  • Cartão de entrada
  • Cartão de miniatura
  • Coleções de cartões
  • Menu Estouro em Cartões Adaptáveis

Você pode adicionar a formatação Rich Text aos cartões usando Markdown ou HTML, dependendo do tipo de cartão. Cartões usados por bots e extensões de mensagem no Teams, adicionam e respondem a essas ações cartão, openUrl, messageBack, imBack, invokee signin.

O Teams usa cartões em três locais diferentes:

  • Conectores
  • Bots
  • Extensões de mensagens

Cartões em conectores

Os cartões foram definidos pela primeira vez como parte do Outlook e do Microsoft 365 e agora são usados como parte dos conectores para Grupos do Microsoft 365. Como muitos aplicativos do Microsoft 365, o Teams dá suporte a conectores. Para obter mais informações, consulte criar conectores para Grupos do Microsoft 365. Você pode encontrar a especificação para cartões nos conectores em referência de cartão de mensagens acionáveis.

Cartões em bots

O Microsoft Bot Framework estende a especificação de cartões adicionando um conjunto de cartões predefinidos que os bots podem usar como parte das mensagens do bot. O Teams oferece suporte aos bots usando o Bot Framework, mas oferece suporte a um conjunto diferente dessas cartas. Informações gerais sobre cartões no Bot Framework podem ser encontradas em adicionar anexos de cartões avançados para mensagens. Esses cartões são chamados de cartões simples no Teams.

Os bots no Teams podem usar cartões simples, cartões de conector ou Cartões Adaptáveis. Os Tipos de cartões fornecem informações sobre cartões, com suporte dos bots no Teams.

Cartões em extensões de mensagem

As Extensões de mensagens também podem retornar um cartão. As extensões de mensagens podem usar cartões simples, cartões de conector ou Cartões Adaptáveis. Esses cartões são encontrados em tipos de cartões.

Tipos de cartões

Todos os cartões usados pelo Teams estão listados em tipos de cartões. Essa referência também descreve as diferenças entre cartões do Bot Framework e cartões no Teams.

Cartões Adaptáveis

Os Cartões Adaptáveis são uma nova especificação de produto cruzado de cartões nos produtos da Microsoft, incluindo bots, Cortana, Outlook e Windows. Eles são o tipo de cartão recomendado para o novo desenvolvimento do Teams. Para obter informações gerais da equipe dos Cartões Adaptáveis, consulte Visão geral dos Cartões Adaptáveis. Você pode usar cartões adaptáveis em qualquer lugar que usar cartões hero existentes, cartões Microsoft 365 e cartões de miniatura.

Além dos Cartões Adaptáveis, o Teams oferece suporte a dois outros tipos de cartões:

  • Cartões de conector: usados como parte de conectores para Grupos do Microsoft 365.
  • Cartões simples: usados do Bot Framework, como os carões em miniatura e os cartões hero.

Seletor de Pessoas nos Cartões Adaptáveis

O Seletor de Pessoas adicionado como um controle de entrada nos Cartões Adaptáveis permite a pesquisa e seleção de pessoas. Você pode usá-lo em chats, canais, caixas de diálogo (conhecidos como módulos de tarefa no TeamsJS v1.x) e guias. Os clientes móveis e de área de trabalho suportam o Seletor de Pessoas que fornece uma experiência de digitação em linha.

ícone Pessoas em um Cartão Adaptável

Pessoas ícone em um Cartão Adaptável ajuda os usuários a exibir as imagens dos usuários no Cartão Adaptável no Teams. Você pode exibir a imagem de um único usuário ou vários usuários. Pessoas ícone tem suporte em clientes móveis e de área de trabalho do Teams.

Pesquisa de preenchimento automático em cartões adaptáveis

A pesquisa typeahead adicionada como um controle de entrada em Cartões Adaptáveis habilita a experiência de pesquisa dinâmica de um conjunto de dados carregado dinamicamente. Ele também permite que os usuários façam uma pesquisa estática typeahead em uma lista com um número limitado de opções. Os clientes móveis e da área de trabalho dão suporte à experiência de pesquisa dinâmica typeahead.

Elementos de mídia em Cartões Adaptáveis

Os elementos de mídia no Cartão Adaptável fornecem uma experiência de mídia aprimorada e aumentam o envolvimento com o Cartão Adaptável. Você pode adicionar arquivos de mídia, como clipes de áudio ou vídeo ao cartão adaptável. Para obter mais informações, consulte Elementos de mídia no Cartão Adaptável.

Cartões adaptáveis e Webhooks de entrada

Observação

Os Cartões Adaptáveis com Webhooks de Entrada permitem que você use os recursos avançados e flexíveis dos Cartões Adaptáveis. Ele envia dados usando os Webhooks de entrada no Teams do seu serviço Web.

CodeBlock em Cartões Adaptáveis

Compartilhe snippets de código como Cartões Adaptáveis altamente formatados em chats, canais e reuniões do Teams com o CodeBlock elemento. Cartões Adaptáveis com o CodeBlock elemento tornam o snippet de código fácil de ler como o recuo, numeração e realce de sintaxe correspondem à linguagem de programação. Para obter mais informações, consulte CodeBlock em Cartões Adaptáveis.

Layout responsivo do Cartão Adaptável

Você deve criar seus Cartões Adaptáveis para ficar ótimo em qualquer dispositivo para fornecer uma experiência aprimorada do usuário em chat, canais e chat de reunião. O layout responsivo do Cartão Adaptável ajuda você a criar cartões com layouts diferentes que visam diferentes larguras de cartão. Para obter mais informações, consulte Layout responsivo do Cartão Adaptável.

Menu Estouro em Cartões Adaptáveis

O Cartão Adaptável no Teams dá suporte ao menu de estouro. Você pode preencher um menu de estouro para todas as ações secundárias em um Cartão Adaptável.

Suporte para Microsoft Entra ID do objeto e UPN no menção de usuário

Bots com Cartões Adaptáveis dão suporte a IDs de usuário menção, como ID do objeto Microsoft Entra e UPN (Nome de Princípio do Usuário), além das IDs existentes. Os Webhooks de entrada começam a dar suporte a menção de usuário no Cartão Adaptável com a ID do Objeto Microsoft Entra e UPN.

Próxima etapa

Tipos de cartões

Confira também