¿Qué son las aplicaciones de Microsoft Teams?

Completado

Una aplicación creada con la plataforma de Microsoft Teams amplía el cliente de Microsoft Teams (web, móvil y de escritorio) con los servicios web que hospeda. La plataforma de Teams proporciona un conjunto completo y flexible de puntos de extensibilidad, creaciones de interfaz de usuario y API para que lo aproveche mientras crea su aplicación. La aplicación puede ser tan sencilla como incrustar su sitio web existente en una pestaña para su equipo, o bien una aplicación sofisticada y polifacética para interactuar con sus usuarios en toda la extensión del cliente de Teams. Puede elegir integrar una aplicación existente o crear una nueva experiencia construida íntegramente para Teams.

Con la plataforma de Microsoft Teams, puede aumentar el nivel de sus servicios con información específica del contexto disponible de las distintas API de Microsoft Teams, como información sobre el equipo o canal en el que está instalada la aplicación o mensajes desde los que se activó la aplicación. Puede crear aplicaciones para un usuario individual, un equipo, toda la organización, o bien puede publicar la aplicación en la tienda de aplicaciones pública para que todos la usen.

¿Cómo está compuesta una aplicación de Microsoft Teams?

Las aplicaciones creadas en la plataforma de Microsoft Teams se componen de tres partes principales.

  • El cliente de Microsoft Teams proporciona los puntos de extensión y los elementos de la interfaz de usuario que empleará la aplicación para interactuar con los usuarios.
  • El paquete de la aplicación de Teams es el paquete que se instala en Microsoft Teams. Contiene un icono pequeño, un icono grande y un archivo JSON de manifiesto. El archivo de manifiesto contiene los metadatos de la aplicación (como el nombre de la aplicación, el nombre del desarrollador, entre otros), qué puntos de extensibilidad usa la aplicación (como pestañas y extensiones de mensajería) y punteros a los servicios web que alimentan la aplicación (como el id. del bot o la dirección URL de la pestaña).
  • Los servicios web hospedados por usted que proporcionan las API y la lógica que alimentan su aplicación.

Es importante tener en cuenta que la plataforma de Microsoft Teams no es un servicio de hospedaje; usted debe hospedar los servicios web que alimentan la aplicación, y se debe poder acceder a ellos mediante HTTPS a través de Internet.

¿Dónde se puede ampliar el cliente de Teams?

Hay varios lugares en los que el cliente de Microsoft Teams se puede ampliar para permitir que los usuarios interactúen con la aplicación. Según el escenario, puede elegir centrarse en un único punto de extensión (como un bot de conversación personal) o combinar varios puntos de extensión.

Equipos, canales y chats de grupo

Los equipos, canales y chats de grupo permiten que varios usuarios puedan colaborar. Las aplicaciones que amplían el contexto están disponibles para todos los miembros del grupo o conversación. Normalmente se centran en habilitar otros flujos de trabajo de colaboración o desbloquear nuevas interacciones sociales. La aplicación tendrá acceso a las API para que pueda obtener información sobre los miembros de la conversación, los canales de un equipo y los metadatos sobre el equipo o la conversación.

Se pueden expandir con:

  • Bots de conversación que interactúan con los miembros de la conversación a través del chat y responden a eventos (como agregar un nuevo miembro o cambiar el nombre de un canal). Todas las conversaciones con un bot en este contexto son visibles para todos los miembros del canal o grupo, por lo que necesitará asegurarse de que la conversación es relevante para todos.
  • Pestañas de chat de grupo y canal que ofrecen una experiencia web insertada en pantalla completa configurada para el chat de canal o grupo en el que se instalan. Todos los miembros interactuarán en la misma aplicación web compartida, por lo que es habitual una experiencia de aplicación de una sola página sin estado.
  • Los webebhooks y conectores que habilitan los servicios externos para publicar mensajes en la conversación. Puede aprovechar las acciones de tarjetas y tarjetas para crear mensajes que requieren acción y enriquecidos. Los conectores web le proporcionan un método simple, unidireccional y sin autenticación para publicar mensajes en un canal, mientras que los conectores ofrecen una experiencia de intercambio un poco más sólida.

Aplicaciones personales

Las aplicaciones personales son la parte de la aplicación de Teams que se centra en las interacciones con un solo usuario. La experiencia es única para cada usuario individual. Esta parte de la aplicación se puede anclar al panel de navegación izquierdo, lo que permite el acceso de un solo clic a los usuarios.

Puede contener:

  • Bots de conversación con una conversación uno a uno con el usuario. Dado que se trata de una conversación privada, si la aplicación necesita tener una conversación con varios turnos con un usuario o proporcionar una notificación relevante para un solo usuario, normalmente es mejor tener esa interacción en una aplicación personal.
  • Pestañas personales que proporcionan una experiencia web incrustada en pantalla completa.

Mensajes

Los mensajes son el núcleo de la colaboración de Teams. Con un comando de acción de la extensión de mensajería, la aplicación puede permitir que los usuarios invoquen la API de la aplicación desde un mensaje, lo que envía el contenido del mensaje a la aplicación para su procesamiento o acción. La aplicación puede responder presentándole un formulario (un módulo de tareas) para recopilar más información, enviar una respuesta al mensaje original o enviar un mensaje directamente al usuario.

Escribir mensajes

Su aplicación puede ayudar a los usuarios a crear mensajes más eficaces permitiéndoles buscar o realizar acciones en un sistema externo, e insertar los resultados en un formato extenso y estructurado con botones accionables.

Hay tres formas en que la aplicación puede ayudar a los usuarios a crear mensajes mejores:

  • Extensión de mensajería: comandos de acción que presentan al usuario un formulario modal (un módulo de tareas), envían los resultados del formulario a la aplicación y, a continuación, insertan un mensaje en la conversación directamente, o bien crean parte de un mensaje que el usuario puede editar antes de enviar a la conversación.
  • Extensión de mensajería: comandos de búsqueda que permiten buscar rápidamente en un sistema externo, obtener una vista previa de los resultados de la búsqueda e insertar el resultado en el chat como una tarjeta enriquecida.
  • Extensión de mensajería: apertura de vínculo que permite a la aplicación supervisar los dominios web que le interesan. Cuando se pega una dirección URL que contiene ese dominio en el cuadro de redactar mensaje, la API de la aplicación se invoca, lo que le permite agregar una tarjeta enriquecida al mensaje con información adicional sobre el elemento al que se vincula.

Elementos de la interfaz de usuario (UI)

Además, para los puntos de extensibilidad, la plataforma de Microsoft Teams proporciona elementos de interfaz de usuario flexibles para que las aplicaciones aprovechen las ventajas. Estos elementos le permiten crear experiencias enriquecidas nativas del cliente de Teams.

Tarjetas y acciones de tarjetas

Las tarjetas son contenedores de interfaz de usuario definidos por JSON esquematizado, que pueden contener varias propiedades y datos adjuntos. Pueden contener texto con formato, elementos multimedia, controles (como cuadros desplegables y botones de radio) y botones que desencadenan acciones de tarjetas. Las acciones de tarjeta pueden enviar cargas a la API de su aplicación, abrir un vínculo, iniciar flujos de autenticación o enviar mensajes a conversaciones. La plataforma de Microsoft Teams es compatible con varios tipos de tarjetas, incluidas las tarjetas adaptables, las tarjetas de elementos principales, las tarjetas en miniatura y mucho más. Se pueden combinar en colecciones de tarjetas y mostrarse en una lista o un carrusel.

Módulos de tareas

Los módulos de tareas le permiten crear experiencias emergentes modales en su aplicación de Teams. En la ventana emergente puede ejecutar su propio código HTML/JavaScript personalizado, mostrar un <iframe> como un vídeo de YouTube o Microsoft Stream o mostrar una tarjeta adaptable. Son especialmente útiles para iniciar y completar tareas o mostrar información completa, como vídeos o paneles de Power BI. Una experiencia de ventana emergente suele ser más natural para los usuarios que inician y completan tareas en comparación con una experiencia de bot basada en conversaciones o pestañas.

La aplicación puede crear vínculos profundos a la dirección URL para ayudar al usuario a desplazarse a través de la aplicación y el cliente de Teams. Usted puede crear un vínculo profundo para la mayoría de las entidades en Teams y algunos (como una nueva solicitud de reunión) le permiten rellenar previamente la información mediante cadenas de consulta en la dirección URL. Por ejemplo, el bot de conversación podría enviar un mensaje a un canal con un vínculo profundo a un módulo de tareas. Como resultado, se envía una tarjeta como mensaje de uno a uno a un usuario, que a su vez contiene un vínculo profundo para crear una reunión con un usuario específico en una fecha y hora determinadas. Utilice vínculos profundos para conectarse a través de los distintos puntos de extensión disponibles para la aplicación, y mantenga al usuario en el contexto correcto.

Páginas de contenido web

Una página de contenido web es una página web hospedada que se puede insertar en una pestaña o en un módulo de tareas. Para habilitar la página web para que se inserte en un cliente de Microsoft Teams, debe:

  • Hospedarse en un HTTPS.
  • El cliente de Teams debe poder insertarla en un <iframe>.
  • Incluir el SDK del cliente de JavaScript de Microsoft Teams e invocar el método initialize() del SDK en la carga de la página.

Resumen

Una aplicación de Microsoft Teams es una colección de servicios web hospedados externamente en Microsoft Teams que aprovechan los puntos de extensibilidad y los elementos de la interfaz de usuario disponibles a través de la plataforma de Microsoft Teams.