Integración de aplicaciones web con Microsoft Teams

¿Tiene una aplicación web que cree que quepa de forma natural con las características sociales y de colaboración de Microsoft Teams? Estas instrucciones pueden ayudarle a comprender cómo integrar los siguientes tipos de aplicaciones:

  • Aplicaciones independientes: puede ser una aplicación de una sola página o una aplicación grande y compleja en la que desea que los usuarios usen algunos aspectos de en Teams.
  • Aplicaciones de colaboración: una aplicación ya creada para las características sociales y de colaboración inherentes a teams.
  • SharePoint: una página de SharePoint que desea exponer en Microsoft Teams.

Para cada directriz, puede ver si es aplicable a su escenario de integración.

Familiarizarse con las capacidades de la plataforma de Microsoft Teams

*Escenarios de integración: aplicaciones independientes, aplicaciones de colaboración, SharePoint *

La aplicación de Microsoft Teams puede incluir características que los usuarios desean y podrían esperar al colaborar, pero puede que no esté familiarizado con la terminología de desarrollo de Teams.

Características comunes de la aplicación Capacidades de la plataforma de Microsoft Teams
Página Web, Página principal o vista previa insertada Pestañas
Compartir accesos directos y extensiones Extensiones de mensajería
Extensiones y métodos abreviados de acciones Extensiones de mensajería
Chatbots Bots
Notificaciones de canal Bots
Webhooks entrantes
Conectores de Office 365
Servicios externos de mensajes Bots
Webhooks salientes
Modales Módulos de tareas
Tarjetas de contenido enriquecido Tarjetas adaptables

Determinación de un subconjunto de funciones

*Escenarios de integración: aplicaciones independientes *

La integración de todas las características de una aplicación existente en Teams a menudo conduce a una experiencia de usuario forzada o poco natural, especialmente en aplicaciones de mayor tamaño. Considere la posibilidad de empezar con las características más impactantes y las que se integrarán de forma más natural con Microsoft Teams. Recuerde que siempre puede permitir a los usuarios que inicien la aplicación principal y obtengan acceso a su conjunto completo de características.

Antes de empezar con un trabajo técnico, realice alguna planeación de la aplicación de Microsoft Teams:

  1. Asigne los casos de uso de la aplicación a las capacidades de la plataforma de Teams.
  2. Determine los puntos de entrada de la aplicación. ¿Se trata de uso personal, colaboración o ambos?

Descripción de los requisitos y las opciones de SharePoint

*Escenarios de integración: SharePoint *

Puede integrar una página de SharePoint existente como una pestaña de Microsoft Teams. Recuerde lo siguiente:

  • Debe ser una página moderna de SharePoint Online
  • Solo se admiten las pestañas personales (no puede integrar la página como una ficha de canal)

Como alternativa, puede crear una pestaña de Microsoft Teams con SharePoint Framework.

Objetivo hacia la multiempresa

*Escenarios de integración: aplicaciones independientes, aplicaciones de colaboración, SharePoint *

Si la aplicación se usa en varias organizaciones, tenga en cuenta el hospedaje de varios inquilinos que hará que el producto sea escalable y simplifique la distribución.

Revisar las API

*Escenarios de integración: aplicaciones independientes, aplicaciones de colaboración *

No asuma que las API y las estructuras de datos existentes de la aplicación son compatibles completamente con la aplicación cuando se integra con Microsoft Teams. Es posible que necesite aumentarlos con información contextual sobre Microsoft Teams para la asignación de identidades, compatibilidad con vínculos profundos y laincorporación de Microsoft Graph.

Obtenga más información sobre cómo obtener contexto para la pestaña o el Botde Teams.

Descripción de las opciones de autenticación

*Escenarios de integración: aplicaciones independientes, aplicaciones de colaboración, SharePoint *

Azure Active Directory (AD) es el proveedor de identidades para Microsoft Teams. Si la aplicación usa un proveedor de identidades diferente, debe realizar un ejercicio de asignación de identidades o federarse con Azure AD.

Microsoft Teams tiene mecanismos de inicio de sesión único (SSO) con Azure AD para aplicaciones de terceros y guía para los flujos de autenticación a otros proveedores de identidades que usan estándares como OAuth y Open ID Connect (OIDC).

En el caso de las páginas de SharePoint, solo puede usar SSO y no puede agregar otro identificador de Azure AD si desea que SSO funcione para otra aplicación (ya que el identificador es la aplicación de SharePoint).

Obtenga más información sobre la autenticación en Microsoft Teams.

Seguir las instrucciones de diseño de Teams

*Escenarios de integración: aplicaciones independientes, aplicaciones de colaboración *

En general, la aplicación debe sentirse natural en Teams. Puede creer que la migración del contenido de la aplicación existente a una pestaña de Microsoft Teams es suficiente, pero se recomienda encarecidamente que la aplicación siga las directrices de diseño de Teams. Vea también: sistema de diseño de Fluent.

Maximizar la vinculación profunda

*Escenarios de integración: aplicaciones independientes, aplicaciones de colaboración, SharePoint *

Casi todo en Microsoft Teams se puede vincular directamente a un vínculo profundo. La aplicación debe maximizar el uso de estos, lo que incluye la vinculación a y desde determinados mensajes y contenido de la pestaña. En realidad, los vínculos profundos pueden vincular varias partes de una aplicación para una experiencia más nativa de Microsoft Teams.

Ser inteligente cuando los usuarios de mensajería

*Escenarios de integración: aplicaciones independientes, aplicaciones de colaboración, SharePoint *

Considere los tipos de mensajes que la aplicación de Teams puede enviar ahora y a largo plazo. Si cree que su aplicación tendrá una conversación multiproceso, es posible que un Bot ofrezca más flexibilidad que un webhook.

Los bots también permiten enviar mensajes proactivos a usuarios individuales o canales. Se trata de mensajes sin pedir desencadenados por un evento externo y no de un mensaje enviado a un bot. (Por ejemplo, el bot puede enviar un mensaje de bienvenida cuando está instalado o un nuevo usuario se une a un canal).

El envío de mensajes proactivos requiere identificadores específicos de Microsoft Teams: puede capturar esta información buscando la lista o los datos de perfiles de usuario, suscribirse a eventos de conversacióno usar Microsoft Graph.

Tenga cuidado de no enviar correo no deseado a los usuarios con demasiados mensajes. Si la funcionalidad de Teams lo admite, considere la posibilidad de permitir que los usuarios configuren la configuración de notificaciones para la aplicación (por ejemplo, "no enviar mensajes sin pedir").

Uso de SharePoint para el almacenamiento de archivos y datos

Escenarios de integración: Aplicaciones independientes, aplicaciones de colaboración, páginas de SharePoint

Cuando se crea un equipo, también se aprovisiona una colección de sitios de SharePoint para admitir el almacenamiento de datos y archivos de ese equipo. La aplicación puede y debe aprovechar esta característica si interactúa con los archivos. También puede usar la colección de sitios para almacenar datos sin procesar en listas de SharePoint y Excel.