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 suportam os seguintes tipos de cartões:

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

Você pode adicionar a formatação Rich Text aos cartões usando Markdown ou HTML, dependendo do tipo de cartão. Cartões utilizados por bots e extensões de mensagens no Teams, adicione e responda a estas ações de 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 são agora utilizados como parte dos conectores dos Grupos do Microsoft 365. Tal como muitas aplicações do Microsoft 365, o Teams suporta 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. Pode utilizar Cartões Ajustáveis em qualquer lugar onde utilize cartões de destaque existentes, cartões do Microsoft 365 e cartões de miniaturas.

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

  • Cartões de conector: utilizados como parte dos conectores dos 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. Pode utilizá-lo em chats, canais, caixas de diálogo (referidos como módulos de tarefas no TeamsJS v1.x) e separadores. 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 num Cartão Ajustável

O ícone Pessoas num Cartão Ajustável ajuda os utilizadores a ver as imagens dos utilizadores no Cartão Ajustável no Teams. Pode ver a imagem de um único utilizador ou de vários utilizadores. O ícone Pessoas é suportado em clientes móveis e de ambiente de trabalho do Teams.

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

A pesquisa typeahead adicionada como um controlo de entrada em Cartões Ajustáveis permite a experiência de pesquisa dinâmica a partir de um conjunto de dados carregado dinamicamente. Também permite que os utilizadores façam uma pesquisa estática typeahead numa lista com um número limitado de opções. Os clientes móveis e de ambiente de trabalho suportam a experiência de pesquisa dinâmica typeahead.

Elementos multimédia em Cartões Ajustáveis

Os elementos multimédia no Cartão Ajustável proporcionam uma experiência multimédia melhorada e aumentam a interação com o Cartão Ajustável. Pode adicionar ficheiros de multimédia, como clips de áudio ou vídeo, ao seu Cartão Ajustável. Para obter mais informações, veja Elementos multimédia no Cartão Ajustá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 Ajustáveis

Partilhe fragmentos de código como Cartões Ajustáveis formatados em chats, canais e reuniões do Teams com o CodeBlock elemento . Os Cartões Adaptáveis com o CodeBlock elemento tornam o fragmento de código mais fácil de ler à medida que o avanço, a numeração e o realce da sintaxe correspondem à linguagem de programação. Para obter mais informações, veja CodeBlock em Cartões Ajustáveis.

Esquema reativo do Cartão Ajustável

Tem de estruturar os seus Cartões Ajustáveis para ter um ótimo aspeto em qualquer dispositivo para proporcionar uma experiência de utilizador melhorada em chat, canais e chat de reunião. O esquema reativo do Cartão Adaptável ajuda-o a estruturar cartões com esquemas diferentes que visam diferentes larguras de cartão. Para obter mais informações, veja Esquema reativo do Cartão Adaptável.

Menu Overflow em Cartões Ajustáveis

O Cartão Ajustável no Teams suporta o menu de capacidade excedida. Pode preencher um menu de capacidade excedida para todas as ações secundárias num Cartão Ajustável.

Suporte para Microsoft Entra Object ID e UPN na menção de utilizador

Os bots com Cartões Ajustáveis suportam IDs de menção de utilizador, como o ID de Objeto do Microsoft Entra e o Nome principal de utilizador (UPN), além dos IDs existentes. Os Webhooks recebidos começam a suportar a menção do utilizador no Cartão Ajustável com o ID de Objeto do Microsoft Entra e o UPN.

Próxima etapa

Tipos de cartões

Confira também