Cartões

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 são compatíveis com os seguintes tipos de cartões:

  • Cartão Adaptável
  • Cartão Hero
  • Cartão de listagem
  • Conector card para Grupos do Microsoft 365
  • Cartão de recebimento
  • Cartão de entrada
  • Cartão de miniatura
  • Coleções de cartões
  • Menu flutuante 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, adicione e responda a essas ações de card, openUrl, messageBack, imBackinvoke, e signin.

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

  • Conectores
  • Bots
  • Extensões de mensagens

Cartões em conectores

Importante

Os Conectores do Microsoft 365 (anteriormente chamados de Conectores do Office 365) estão se aproximando do preterimento, e a criação de novos Conectores do Microsoft 365 será bloqueada em breve. Para obter mais informações sobre a agenda e como o aplicativo Fluxos de trabalho oferece uma experiência mais flexível e segura, consulte desativação dos conectores do Microsoft 365 no Microsoft Teams.

Como você pode criar um webhook no Teams?

  • Para postar automaticamente em um chat ou canal quando uma solicitação de webhook for recebida, use os modelos de fluxo de trabalho predefinidos ou crie um fluxo de trabalho do zero usando o gatilho Quando uma solicitação de webhook do Teams for recebida . Para obter mais informações, consulte Enviar mensagens no Teams usando webhooks de entrada.

  • Para obter mais informações sobre o gatilho Quando uma solicitação de webhook do Teams é recebida , consulte Microsoft Teams - Webhook.

Se você já criou conectores do Office 365:

  • Criar um conector do Power Automate: o Power Automate aprimora os aplicativos de Fluxos de Trabalho amplamente usados no Teams. É a abordagem escalonável e segura para transmitir dados programaticamente dentro e fora do Teams. Se você adotar esse método, poderá criar modelos de fluxo de trabalho para postar alertas do seu produto nos canais do Teams. Essa abordagem simplifica a adoção do novo método pelo usuário. Para obter mais informações, consulte Power Automate para desenvolvedores corporativos, ISVs e parceiros.

  • Atualize seu aplicativo Teams: Você pode aprimorar seu aplicativo Teams atual. Por exemplo, você pode permitir que os usuários configurem mensagens proativas com base em eventos de gatilho em seu sistema. Para obter mais informações, veja como os bots podem postar em canais por meio de mensagens proativas.

Problemas conhecidos

  • O aplicativo Fluxos de trabalho pode postar como um bot de fluxo em canais compartilhados. O suporte para postagem como um bot de fluxo em canais privados está em desenvolvimento. Atualmente, os fluxos de trabalho podem postar mensagens em nome de um usuário.
  • Os fluxos de trabalho dão suporte ao formato de Cartões Adaptáveis e Cartão de Mensagem (não há suporte para renderização de botão).

Limites

Os fluxos de trabalho são vinculados apenas a usuários específicos (chamados de proprietários do fluxo de trabalho) e não a uma equipe ou canal do Teams. Os fluxos de trabalho poderão se tornar fluxos órfãos na ausência de um proprietário se nenhum coproprietário for atribuído. Para manter a continuidade no processo de negócios automatizado pelo fluxo, os administradores podem adicionar um ou mais coproprietários e conceder a eles controle total sobre o fluxo de trabalho. Eles também podem adicionar autenticação para conexões, se houver, e habilitar o fluxo se ele tiver sido desabilitado. Para obter mais informações, consulte gerenciar fluxos órfãos.

Os cartões foram definidos pela primeira vez como parte do Outlook e do Microsoft 365 e agora são usados como parte de conectores para Grupos do Microsoft 365. Como muitos aplicativos do Microsoft 365, o Teams oferece 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

Importante

Essa documentação é considerada herdada. Para obter informações e recursos abrangentes relacionados a Cartões Adaptáveis, visite o hub de documentação de Cartões Adaptáveis.

A captura de tela mostra a página inicial do site de Cartões Adaptáveis da Microsoft.

O hub de documentação de Cartões Adaptáveis oferece documentação de referência completa e mais recente, um Designer de Cartão Adaptável atualizado, exemplos de JSON internos, práticas recomendadas de design e um histórico de versão detalhado dos recursos do Cartão Adaptável. Para obter mais informações, consulte introdução ao hub de documentação de Cartões Adaptáveis e novas atualizações de 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 em que usar cartões de herói, cartões do Microsoft 365 e cartões de miniatura existentes.

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 (chamados de módulos de tarefas 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.

People icon em um Cartão Adaptável

O ícone People 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 de vários usuários. O ícone People tem suporte em clientes móveis e de desktop do Teams.

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

A pesquisa de digitação antecipada adicionada como um controle de entrada em Cartões Adaptáveis permite 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 de digitação antecipada em uma lista com número limitado de opções. Os clientes móveis e de computador dão suporte à experiência de pesquisa dinâmica de digitação antecipada.

Entradas dependentes em Cartões Adaptáveis

Você pode criar Cartões Adaptáveis no Teams em que o valor de uma entrada depende do valor de outra. Por exemplo, considere um Cartão Adaptável com duas Input.ChoiceSet listas suspensas: uma para selecionar um país e outra para selecionar uma cidade específica dentro desse país. A primeira lista suspensa deve filtrar as cidades exibidas na segunda lista suspensa. Isso pode ser feito criando uma Input.ChoiceSet lista suspensa com pesquisa dinâmica de digitação antecipada que depende de uma ou mais outras entradas no card. Para obter mais informações, consulte Entradas dependentes.

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 a interação com o Cartão Adaptável. Você pode adicionar arquivos de mídia, como clipes de áudio ou vídeo, vídeos do YouTube, Vimeo ou Dailymotion ao seu 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 ricamente formatados em chats, canais e reuniões do Teams com o CodeBlock elemento. Os Cartões Adaptáveis com o CodeBlock elemento facilitam a leitura do trecho de código, pois o recuo, a numeração e o 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 projetar seus Cartões Adaptáveis para terem uma ótima aparência em qualquer dispositivo para fornecer uma experiência de usuário aprimorada 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 larguras de card diferentes. Para obter mais informações, consulte Layout responsivo do Cartão Adaptável.

Bordas e cantos arredondados

Você pode adicionar bordas ao Container, ColumnSet, Columne Table elementos em Cartões Adaptáveis para delinear diferentes seções do card. Você pode adicionar cantos arredondados ao Container, ColumnSet, Column, Tablee Image elementos em Cartões Adaptáveis para tornar o design do card moderno e visualmente atraente. Para obter mais informações, consulte bordas e cantos arredondados em Cartões Adaptáveis.

Contêineres roláveis

Um contêiner com muitos elementos pode levar a um card longo e ilegível. Use a maxHeight propriedade para definir a altura máxima do contêiner. Quando o contêiner tiver uma altura máxima e seu conteúdo exceder essa altura, uma barra de rolagem vertical será exibida. Para obter mais informações, consulte Contêineres roláveis em Cartões Adaptáveis.

Botão composto

O botão composto é um tipo especial de botão com um ícone, título e descrição. Você pode adicionar um botão Composto usando o CompoundButton elemento. Esse elemento permite replicar a aparência dos prompts em um Cartão Adaptável. Para obter mais informações, consulte Botão Composto em Cartões Adaptáveis.

Ícones do Fluent

Os Cartões Adaptáveis dão suporte à adição de ícones da biblioteca de ícones do Fluent usando o Icon elemento. Para obter mais informações, consulte ícones no Cartão Adaptável.

Classificações por estrelas

Você pode adicionar uma entrada de classificação por estrelas ao seu Cartão Adaptável usando o Input.Rating elemento. Você também pode incluir uma classificação por estrelas somente leitura usando o Rating elemento. Para obter mais informações, consulte classificações em Cartões Adaptáveis.

Habilitação condicional de botões de ação

Você pode usar a conditionallyEnabled propriedade para desabilitar os botões de ação até que o usuário altere o valor de pelo menos uma das entradas necessárias. Essa propriedade só pode ser usada com Action.Submit ações and Action.Execute . Para obter mais informações, consulte habilitação condicional de botões de ação.

Menu flutuante 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 ID de Objeto e UPN do Microsoft Entra na menção do usuário

Os bots com Cartões Adaptáveis dão suporte a IDs de menção do usuário, como a ID de Objeto do Microsoft Entra e o Nome Principal 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 a ID do Objeto do Microsoft Entra e o UPN.

Gráficos em Cartões Adaptáveis

Os bots podem menção usuários por ID de Objeto ou Nome Principal do Usuário (UPN) do Microsoft Entra, além de IDs de usuário. Os Webhooks de entrada também dão suporte a menções de usuários em Cartões Adaptáveis usando esses tipos de ID.

Layouts de contêiner em Cartões Adaptáveis

Você pode criar contêineres responsivos para diferentes larguras de Cartão Adaptável com o Layout.Stack, Layout.Flow, e layouts Layout.AreaGrid . Para obter mais informações, consulte Layouts de contêiner.

Próxima etapa

Tipos de cartões

Confira também

  • Last updated on