Tarjetas

Una tarjeta es un contenedor de interfaz de usuario (UI) para información breve o relacionada. Las tarjetas pueden tener varias propiedades y datos adjuntos y pueden incluir botones, que desencadenan acciones de tarjeta. Con las tarjetas, puede organizar la información en grupos y dar a los usuarios la oportunidad de interactuar con partes específicas de la información.

Los bots para Teams admiten los siguientes tipos de tarjetas:

  • Tarjeta adaptable
  • Tarjeta de héroe
  • Tarjeta de lista
  • Office 365 connector
  • Tarjeta de recibo
  • Tarjeta de inicio de sesión
  • Tarjeta miniatura
  • Colecciones de tarjetas

Puede agregar formato de texto enriquecido a las tarjetas mediante Markdown o HTML, según el tipo de tarjeta. Tarjetas usadas por bots y extensiones de mensajería en Microsoft Teams, agregar y responder a estas acciones de tarjeta, openUrl , , , y messageBack imBack invoke signin .

Teams usa tarjetas en tres lugares diferentes:

  • Conectores
  • Bots
  • Extensiones de mensajería

Tarjetas en conectores

Las tarjetas se definieron primero como parte de Outlook y Office 365 y ahora se usan como parte de Office 365 Connectors. Al igual que muchas Office 365, Teams admite conectores. Para obtener más información, vea Office 365 Connectors for Teams. Puede encontrar la especificación de las tarjetas en conectores en referencia de tarjeta de mensaje de acción.

Tarjetas en bots

El Microsoft Bot Framework amplía la especificación de tarjetas agregando un conjunto de tarjetas predefinidas que los bots pueden usar como parte de los mensajes de bot. Teams admite bots con Bot Framework, pero admite un conjunto diferente de estas tarjetas. La información general sobre las tarjetas en Bot Framework se puede encontrar en agregar datos adjuntos de tarjetas enriquecciones a los mensajes. Estas tarjetas se denominan tarjetas sencillas en Teams.

Los bots de Teams pueden usar tarjetas sencillas, tarjetas de conector o tarjetas adaptables. Los tipos de tarjetas proporcionan información sobre tarjetas, admitidas por bots en Teams.

Tarjetas en extensiones de mensajería

Las extensiones de mensajería también pueden devolver una tarjeta. Las extensiones de mensajería pueden usar tarjetas sencillas, tarjetas de conector o tarjetas adaptables. Estas tarjetas se encuentran en tipos de tarjetas.

Tipos de tarjetas

Todas las tarjetas usadas por Teams se enumeran en tipos de tarjetas. Esta referencia también describe las diferencias entre las tarjetas de Bot Framework y las tarjetas Teams.

Tarjetas adaptables

Las tarjetas adaptables son una nueva especificación entre productos para tarjetas en productos de Microsoft, incluidos bots, Cortana, Outlook y Windows. Son el tipo de tarjeta recomendado para el nuevo Teams desarrollo. Para obtener información general del equipo de tarjetas adaptables, vea Adaptive Cards overview. Puedes usar tarjetas adaptables en cualquier lugar que uses tarjetas de héroe existentes, tarjetas Office 365 y tarjetas en miniatura.

Además de las tarjetas adaptables, Teams admite otros dos tipos de tarjetas:

  • Tarjetas de conector: se usan como parte de Office 365 conectores.
  • Tarjetas sencillas: se usan desde Bot Framework, como la miniatura y las tarjetas de héroe.

Búsqueda de tipo por adelantado en tarjetas adaptables

Escriba la búsqueda avanzada agregada como control de entrada en tarjetas adaptables para habilitar la experiencia de búsqueda dinámica desde un conjunto de datos cargado dinámicamente. También permite a los usuarios realizar una búsqueda estática de tipo delante dentro de una lista con un número limitado de opciones. Los clientes móviles y de escritorio admiten el tipo delante de la experiencia de búsqueda dinámica.

Tarjetas adaptables y webhooks entrantes

Nota

Las tarjetas adaptables con webhooks entrantes permiten usar las capacidades enriquecibles y flexibles de las tarjetas adaptables. Envía datos mediante webhooks entrantes en Teams desde su servicio web.

Compatibilidad con AAD identificador de objeto y UPN en la mención del usuario

Los bots con tarjetas adaptables admiten identificadores de mención de usuario, como el identificador de objeto AAD y el nombre de principio de usuario (UPN), además de los identificadores existentes. Los webhooks entrantes comienzan a admitir la mención de usuario en la tarjeta adaptable con el AAD de objeto y UPN.

Paso siguiente

Vea también