Cartões

Um cartão é um contêiner de interface do usuário (UI) para 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. Usando cartões, você pode organizar informações em grupos e dar aos usuários a oportunidade de interagir com partes específicas das informações.

Os bots para Teams suportam os seguintes tipos de cartões:

  • Cartão Adaptável
  • Cartão de herói
  • Cartão de listagem
  • Office 365 conector
  • Cartão de recebimento
  • Cartão de signin
  • Cartão de miniatura
  • Coleções de cartões

Você pode adicionar formatação de rich text aos cartões usando Markdown ou HTML, dependendo do tipo de cartão. Cartões usados por bots e extensões de mensagens em Microsoft Teams, adicione e responda a essas ações de cartão, openUrl , , , e messageBack imBack invoke signin .

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 Office 365 e agora são usados como parte de Office 365 Conectores. Como muitos Office 365, o Teams dá suporte a conectores. Para obter mais informações, consulte Office 365 Conectores para Teams. Você pode encontrar a especificação para cartões em conectores em referência de cartão de mensagem a ação.

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 bot. Teams oferece suporte a bots usando a Estrutura de Bot, 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ão rich card a mensagens. Esses cartões são chamados de cartões simples Teams.

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

Cartões em extensões de mensagens

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 por Teams estão listados em tipos de cartões. Essa referência também descreve as diferenças entre cartões e cartões da Estrutura de Bot no Teams.

Cartões Adaptáveis

Cartões adaptáveis são uma nova especificação de produto cruzado para cartões em produtos Microsoft, incluindo bots, Cortana, Outlook e Windows. Eles são o tipo de cartão recomendado para novos Teams desenvolvimento. Para obter informações gerais da equipe cartões adaptáveis, consulte Adaptive Cards overview. Você pode usar Cartões Adaptáveis em qualquer lugar que você use cartões de herói existentes, Office 365 cartões de Office 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 conectores: usados como parte de conectores Office 365 conectores.
  • Cartões simples: usados a partir da Estrutura de Bot, como a miniatura e os cartões de herói.

Pesquisa de tipo à frente em Cartões Adaptáveis

Digite a pesquisa à frente adicionada como um controle de entrada em Cartões Adaptáveis habilitam a experiência de pesquisa dinâmica a partir de um conjuntos de dados carregado dinamicamente. Ele também permite que os usuários façam uma pesquisa estática de tipo à frente dentro de uma lista com número limitado de opções. Os clientes móveis e de área de trabalho suportam o tipo de experiência de pesquisa dinâmica à frente.

Cartões adaptáveis e Webhooks de entrada

Observação

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

Suporte para AAD ID de objeto e UPN na menção do usuário

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

Próxima etapa

Confira também