Consideraciones para la integración de Teams

  • Artículo

Puede hacer que las aplicaciones web se adecúen a las características sociales y colaborativas de Teams integrándolas correctamente con Teams.

Los diferentes tipos de aplicaciones que puede integrar con Teams son los siguientes:

  • Aplicaciones independientes: una aplicación independiente es una aplicación de una sola página o grande y compleja. El usuario puede usar algunos aspectos de él en Teams.
  • Aplicaciones de colaboración: una aplicación ya creada para las características sociales y colaborativas inherentes a Teams.
  • SharePoint: una página de SharePoint que quiere que aparezca en Teams.

Puede asignar y seguir las directrices adecuadas que se aplican a su caso de integración. En este documento se proporciona información general sobre las funcionalidades de Teams, los requisitos de punto de recurso compartido para el almacenamiento de archivos y datos, los requisitos de API, la autenticación y la vinculación en profundidad de la aplicación con Teams.

Familiarizarse con las funcionalidades de la plataforma Teams

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

La aplicación de Teams debe incluir características de colaboración necesarias y que son de esperar. Para trabajar con la integración de aplicaciones, es importante familiarizarse con la terminología de desarrollo de Teams.

Características comunes de la aplicación Funcionalidades de la plataforma de Teams
Página web integrada, página principal o vista web Pestañas
Pestañas extendidas en Microsoft 365
Uso compartido de accesos directos y extensiones Extensiones de mensajes
Extensiones de mensaje para Outlook
Accesos directos y extensiones de acción Extensiones de mensajes
Chatbots Bots
Notificaciones de canal Bots
Webhooks entrantes
Conectores para Grupos de Microsoft 365
Servicios externos de mensajes Bots
Webhooks salientes
Modales Cuadros de diálogo (denominados módulos de tareas en TeamsJS v1.x)
Tarjetas enriquecidas con contenido Tarjetas adaptables

Determinar un subconjunto de funcionalidad

Escenarios de integración: aplicaciones independientes

La integración de todas las características de una aplicación existente en Teams suele dar lugar a una experiencia de usuario forzada o poco natural, especialmente en aplicaciones grandes. Comience por las características que vayan a tener un mayor impacto y las que se integran de forma más natural con Teams. Puede permitir que los usuarios inicien la aplicación principal y accedan al conjunto completo de características.

Los siguientes son los requisitos previos para integrar la aplicación con Teams.

  1. Asignar los casos de uso de la aplicación a las funcionalidades de la plataforma Teams.
  2. Determinar los puntos de entrada de la aplicación. ¿Es para uso personal, para colaboración o para ambos?

Descripción de los requisitos y las opciones de SharePoint

Escenarios de integración: SharePoint

Para integrar una página de SharePoint existente como pestaña de Teams, debe tener en cuenta lo siguiente:

  • Debe ser una página moderna de SharePoint en línea.
  • Solo se admiten pestañas personales. No puede integrar la página como una pestaña de canal.

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

Poner como objetivo un multiinquilino

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

Si varias organizaciones usan la aplicación, considere la posibilidad de hospedar varios inquilinos. Esto hace que el producto sea escalable y simplifica la distribución.

Revisión de las API

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

Las API y las estructuras de datos de la aplicación deben admitir la aplicación al integrarse con Teams. Para ampliar la compatibilidad, debe aumentar las API y las estructuras de datos con información contextual sobre Teams para la asignación de identidades, la compatibilidad con vínculos profundos y la incorporación de Microsoft Graph.

Consulte cómo obtener contexto para una pestaña o bot de Teams.

Descripción de las opciones de autenticación

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

Microsoft Entra id. es el proveedor de identidades de Teams. Si la aplicación usa un proveedor de identidades diferente, debe realizar un ejercicio de asignación de identidades o combinar con Microsoft Entra identificador.

Teams tiene mecanismos de inicio de sesión único (SSO) con Microsoft Entra id. para aplicaciones de terceros. También proporciona las instrucciones para los flujos de autenticación a otros proveedores de identidades mediante estándares como OAuth y OpenID Connect, conocidos como OIDC.

Importante

En este momento, las aplicaciones de terceros están disponibles en Government Community Cloud (GCC), pero no están disponibles para GCC-High y el Departamento de Defensa (DOD). Las aplicaciones de terceros están desactivadas de forma predeterminada para GCC. Para activar aplicaciones de terceros en GCC, consulte administrar directivas de permisos de aplicaciones y administrar aplicaciones.

En las páginas de SharePoint, solo puede usar sso y no puede agregar otro identificador de Microsoft Entra si desea que el inicio de sesión único 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 Teams.

Seguir las directrices de diseño de Teams

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

Asegúrese de seguir las directrices de diseño de Teams para que la aplicación sea nativa para Teams. No se puede migrar un contenido de aplicación existente a una pestaña de Teams. Para obtener más información sobre el diseño de aplicaciones, consulte Sistema Fluent Design.

Maximizar la vinculación en profundidad

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

Puede crear vínculos a información y características en Teams. Use vínculos profundos para vincular la aplicación con Teams, ya que así se unen varias partes de una aplicación para lograr una experiencia de Teams más nativa.

Sea inteligente al enviar mensajes a los usuarios

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

Use un bot en la aplicación de Teams para múltiples conversaciones encadenadas, ya que ofrece más flexibilidad que un webhook.

Los bots también permiten enviar mensajes proactivos a usuarios o canales. Los mensajes proactivos son mensajes no solicitados que se desencadenan por un evento externo y no por un mensaje enviado a un bot. Por ejemplo, el bot envía 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 Teams. Puede capturar información mediante la captura de datos de perfil de usuario o de lista de participantes, la suscripción a eventos de conversación o el uso de Microsoft Graph.

No envíe spam a los usuarios con mensajes excesivos. Si la funcionalidad de Teams lo admite, los usuarios pueden configurar las opciones de notificación de la aplicación. A continuación se muestra un ejemplo de un mensaje de notificación: No enviarme mensajes no solicitados.

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 SharePoint para admitir el almacenamiento de archivos y datos para ese equipo. La aplicación debe aprovechar esta característica si interactúa con archivos. Use la colección de sitios para almacenar datos sin procesar en listas de SharePoint y Microsoft Excel.

Consulte también