Consideraciones para la integración de Teams
Puede hacer que las aplicaciones web sean adecuadas con las características sociales y colaborativas de Microsoft 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.
- Microsoft SharePoint: una página de SharePoint que desea mostrar 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 SharePoint para el almacenamiento de archivos y datos, los requisitos de API, la autenticación y la vinculación profunda 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.
- Asignar los casos de uso de la aplicación a las funcionalidades de la plataforma Teams.
- 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 ID.
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
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 Fluent Design System.
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.