Tarjetas

Una tarjeta es un contenedor de interfaz de usuario (UI) para información breve o relacionada. Las tarjetas pueden tener diversas propiedades y datos adjuntos y pueden incluir botones para activar las acciones de las tarjetas. 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
  • Tarjeta del conector para Grupos de Microsoft 365
  • Tarjeta de recibo
  • Tarjeta de inicio de sesión
  • Tarjeta miniatura
  • Colecciones de tarjetas
  • Menú Desbordamiento en tarjetas adaptables

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, messageBack, imBack, invoke y signin.

Teams usa tarjetas en tres lugares diferentes:

  • Conectores
  • Bots
  • Extensiones de mensajería

Tarjetas en conectores

Las tarjetas se definieron por primera vez como parte de Outlook y Microsoft 365 y ahora se usan como parte de conectores para Grupos de Microsoft 365. Al igual que muchas aplicaciones de Microsoft 365, Teams admite conectores. Para obtener más información, consulte Creación de conectores para Grupos de Microsoft 365. 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 que usan el Bot Framework, pero admite un conjunto diferente de estas tarjetas. La información general sobre las tarjetas de Bot Framework se puede encontrar en agregar datos adjuntos de tarjetas enriquecidas a mensajes. Estas tarjetas se denominan tarjetas sencillas en Teams.

Los bots de Teams pueden usar tarjetas sencillas, tarjetas de conector o tarjetas adaptables. Tipos de tarjetas proporciona información sobre las tarjetas compatibles con bots en Teams.

Tarjetas en extensiones de mensajería

Las extensiones de mensajería también pueden entregar una tarjeta. Las extensiones de mensajería pueden usar tarjetas simples, 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 en 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 desarrollo de Teams. Para obtener información general del equipo de tarjetas adaptables, consulte Información general sobre tarjetas adaptables adaptable. Puede usar tarjetas adaptables en cualquier lugar donde use las tarjetas principales existentes, las tarjetas de Microsoft 365 y las tarjetas en miniatura.

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

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

Selector de usuarios en Tarjetas adaptables

El selector de usuarios agregado como control de entrada en Tarjetas adaptables habilita la búsqueda y la selección de usuarios. Puede usarlo en chats, canales, módulos de tareas y pestañas. Los clientes móviles y de escritorio admiten el selector de usuarios, lo que proporciona una experiencia de escritura en línea.

Búsqueda de escritura anticipada en Tarjetas adaptables

La búsqueda de encabezados de tipo agregada como un control de entrada en tarjetas adaptables habilita 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 escritura anticipada dentro de una lista con un número limitado de opciones. Los clientes móviles y de escritorio admiten la experiencia de búsqueda dinámica de escritura anticipada.

Tarjetas adaptables y webhooks entrantes

Nota:

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

Menú Desbordamiento en tarjetas adaptables

La tarjeta adaptable en Teams admite el menú de desbordamiento. Puede rellenar un menú de desbordamiento para todas las acciones secundarias de una tarjeta adaptable.

Compatibilidad con el identificador de objeto de Azure AD y el UPN en la mención de usuario

Los bots con Tarjetas adaptables admiten identificadores de mención de usuario, como el identificador de objeto de Microsoft Azure Active Directory (Azure AD) y el nombre principal de usuario (UPN), además de los identificadores existentes. Los webhooks entrantes comienzan a admitir la mención del usuario en la tarjeta adaptable con el identificador de objeto de Azure AD y el UPN.

Paso siguiente

Consulte también