Considérations relatives à l’intégration de Teams

Vous pouvez rendre les applications Web adaptées aux fonctionnalités sociales et collaboratives de Microsoft Teams, en les intégrant correctement à Teams.

Les différents types d’applications que vous pouvez intégrer à Teams sont les suivants :

  • Applications autonomes : une application autonome est une application complexe ou d’une seule page. L’utilisateur peut utiliser certains aspects de celui-ci dans Teams.
  • Applications de collaboration: une application déjà conçue pour les fonctionnalités sociales et collaboratives inhérentes à Teams.
  • Microsoft SharePoint : une page SharePoint que vous souhaitez afficher dans Teams.

Vous pouvez mapper et suivre les instructions appropriées applicables à votre scénario d’intégration. Ce document fournit une vue d’ensemble des fonctionnalités de Teams, des exigences de SharePoint pour le stockage de fichiers et de données, des exigences d’API, de l’authentification et des liens profonds de votre application avec Teams.

Découvrir les fonctionnalités de la plateforme Teams

Importante

Les connecteurs Office 365 dans Teams, y compris les Webhooks entrants basés sur des connecteurs, ont été retirés en mai 2026. Pour recevoir des demandes de webhook et publier des messages dans Teams, utilisez l’application Workflows. Pour plus d’informations, voir Retrait des connecteurs Office 365 dans Microsoft Teams.

Comment créer un webhook dans Teams ?

  • Pour publier automatiquement dans une conversation ou un canal lors de la réception d’une demande de webhook, utilisez les modèles de flux de travail prédéfinis ou créez un flux de travail à partir de zéro à l’aide du déclencheur Lorsqu’une demande de webhook Teams est reçue . Pour plus d’informations, consultez Envoyer des messages dans Teams à l’aide de webhooks entrants.
  • Pour plus d’informations sur le déclencheur Lorsqu’une demande de webhook Teams est reçue , consultez Microsoft Teams – Webhook.

Si vous avez déjà créé des connecteurs Office 365 :

  • Créer un connecteur Power Automate : Power Automate améliore les applications de flux de travail largement utilisées dans Teams. Il s’agit de l’approche évolutive et sécurisée pour transmettre des données par programme dans et en dehors de Teams. Si vous adoptez cette méthode, vous pouvez créer des modèles de workflow pour publier des alertes de votre produit dans les canaux Teams. Cette approche simplifie l’adoption de la nouvelle méthode par les utilisateurs. Pour plus d’informations, consultez Power Automate pour les développeurs d’entreprise, les éditeurs de logiciels indépendants et les partenaires.
  • Mettez à jour votre application Teams : vous pouvez améliorer votre application Teams actuelle. Par exemple, vous pouvez permettre aux utilisateurs de configurer des messages proactifs en fonction d’événements déclencheurs au sein de votre système. Pour plus d’informations, découvrez comment les bots peuvent publier sur des canaux via des messages proactifs.

Problèmes connus

  • Les webhooks de workflows prennent en charge les canaux privés. Vous pouvez les configurer via le portail Power Automate ou l’application Flux de travail dans Teams.
  • Les webhooks de workflows prennent en charge les charges utiles Adaptive Card et MessageCard. Les charges utiles MessageCard restituent le contenu, mais ne prennent pas en charge les boutons d’action HTTP POST interactifs. Pour les cartes interactives, utilisez les cartes adaptatives et configurez le flux de travail pour gérer les réponses des cartes.

Limites

Les flux de travail sont liés uniquement à des utilisateurs spécifiques (appelés propriétaires du flux de travail) et non à une équipe ou un canal Teams. Les workflows peuvent devenir des flux orphelins en l’absence de propriétaire si aucun copropriétaire n’est attribué. Pour maintenir la continuité du processus métier automatisé par le flux, les administrateurs peuvent ajouter un ou plusieurs copropriétaires et leur accorder un contrôle total sur le flux de travail. Ils peuvent également ajouter une authentification pour les connexions, le cas échéant, et activer le flux s’il a été désactivé. Pour plus d’informations, consultez Gestion des flux orphelins.

Scénarios d’intégration : applications autonomes, applications de collaboration, SharePoint

Votre application Teams doit inclure les fonctionnalités de collaboration requises et attendues. Pour utiliser l’intégration d’applications, il est important de se familiariser avec la terminologie de développement Teams.

Fonctionnalités d’application courantes Fonctionnalités de la plateforme Teams
Page web incorporée, page d’accueil ou affichage web Onglets
Onglets étendus dans Microsoft 365
Partager des raccourcis et des extensions Extensions de messages
Extensions de message pour Outlook
Raccourcis et extensions d’action Extensions de messages
Bots conversationnels Bots
Notifications du canal Bots
Webhooks entrants
Connecteurs pour les Groupes Microsoft 365
Envoyer un message aux services externes Bots
Webhooks sortants
Modales Boîtes de dialogue (appelées modules de tâche dans TeamsJS v1.x)
Cartes riches en contenu Cartes adaptatives

Déterminer un sous-ensemble de fonctionnalités

Scénarios d’intégration : Applications autonomes

Intégrer toutes les fonctionnalités d'une application existante dans Teams conduit souvent à une expérience utilisateur forcée ou non naturelle, en particulier pour les applications de grande taille. Commencez par les fonctionnalités les plus percutantes et celles qui s’intègrent plus naturellement à Teams. Vous pouvez autoriser les utilisateurs à lancer l’application principale et à accéder à son ensemble complet de fonctionnalités.

Voici les conditions préalables à l’intégration de votre application à Teams.

  1. mappez les cas d’usage de votre application aux fonctionnalités de la plateforme Teams.
  2. Déterminer les points d’entrée de votre application. Est-ce à des fins personnelles, de collaboration ou pour les deux ?

Comprendre les exigences et les options de SharePoint

Scénarios d’intégration : SharePoint

Pour intégrer une page SharePoint existante sous la forme d’un onglet Teams, vous devez prendre en compte les éléments suivants :

  • Il doit s’agir d’une page moderne SharePoint Online.
  • Seuls les onglets personnels sont pris en charge. Vous ne pouvez pas intégrer votre page en tant qu’onglet de canal.

Vous pouvez également créer un onglet Teams à l’aide de l’infrastructure SharePoint.

Visez l’architecture mutualisée

Scénarios d’intégration : applications autonomes, applications de collaboration, SharePoint

Si votre application est utilisée par plusieurs organisations, envisagez l’hébergement multilocataire. Cela rend votre produit évolutif et simplifie la distribution.

Passer en revue vos API

Scénarios d’intégration : applications autonomes, applications de collaboration

Les API et les structures de données de votre application doivent prendre en charge l’application lors de l’intégration à Teams. Pour étendre la prise en charge, vous devez augmenter les API et les structures de données avec des informations contextuelles sur Teams pour de mappage d’identité, prise en charge des liens profondset incorporer Microsoft Graph.

Découvrez comment obtenir le contexte de votre d’onglet Teams ou bot.

Comprendre les options d’authentification

Scénarios d’intégration : applications autonomes, applications de collaboration, SharePoint

Microsoft Entra ID est le fournisseur d’identité de Teams. Si votre application utilise un autre fournisseur d’identité, vous devez effectuer un exercice de mappage d’identité ou le combiner avec Microsoft Entra ID.

Teams dispose de mécanismes d’authentification unique (SSO) avec Microsoft Entra ID pour les applications tierces. Il fournit également des conseils pour les flux d’authentification vers d’autres fournisseurs d’identité à l’aide de normes telles que OAuth et OpenID Connect, connu sous le nom d’OIDC.

Importante

Les applications tierces sont disponibles dans Government Community Cloud (GCC), mais ne sont pas disponibles pour GCC High, Department of Defense (DoD) et Teams gérés par 21Vianet. Les applications tierces sont désactivées par défaut pour GCC. Pour activer des applications tierces pour GCC, consultez gérer les stratégies d’autorisation d’application et gérer les applications.

Pour les pages SharePoint, vous pouvez uniquement utiliser l’authentification unique et ne pouvez pas ajouter un autre Microsoft Entra ID si vous souhaitez que l’authentification unique fonctionne pour une autre application, car l’ID est l’application SharePoint.

En savoir plus sur l’authentification dans Teams.

Suivez les instructions de conception teams

Scénarios d’intégration : applications autonomes, applications de collaboration

Veillez à suivre les instructions de conception Teams pour rendre votre application native dans Teams. Vous ne pouvez pas migrer le contenu d’une application existante vers un onglet Teams. Pour plus d’informations sur la conception d’applications, consultez Système Fluent Design.

Optimiser la liaison approfondie

Scénarios d’intégration : applications autonomes, applications de collaboration, SharePoint

Vous pouvez créer des liens vers des informations et des fonctionnalités dans Teams. Utilisez liens profonds pour lier votre application à Teams, car ils relient plusieurs éléments d’une application pour une expérience Teams plus native.

Soyez intelligent lors de la messagerie des utilisateurs

Scénarios d’intégration : applications autonomes, applications de collaboration, SharePoint

Utilisez un bot dans votre application Teams pour une conversation multithread, car il offre plus de flexibilité qu’un webhook.

Les bots vous permettent également d’envoyer messages proactifs à des utilisateurs ou canaux individuels. Les messages proactifs sont des messages non traités déclenchés par un événement externe et non envoyés à un bot. Par exemple, votre bot envoie un message de bienvenue lorsqu’il est installé ou qu’un nouvel utilisateur rejoint un canal.

L’envoi de messages proactifs nécessite des identificateurs spécifiques à Teams. Vous pouvez capturer les informations en extrayant la liste ou les données de profil utilisateur, en vous abonnant aux événements de conversationou en utilisant Microsoft Graph.

Ne spammez pas les utilisateurs avec des messages excessifs. Si la fonctionnalité Teams la prend en charge, les utilisateurs peuvent configurer les paramètres de notification pour votre application. Voici un exemple de message de notification : ne m’envoyez pas de messages non traités.

Utiliser SharePoint pour le stockage de fichiers et de données

scénarios d’intégration : applications autonomes, applications de collaboration, pages SharePoint

Lorsqu’une équipe est créée, une de collection de sites SharePoint est également configurée pour prendre en charge le stockage de fichiers et de données pour cette équipe. Votre application doit tirer parti de cette fonctionnalité si elle interagit avec des fichiers. Utilisez la collection de sites pour stocker des données brutes dans les listes SharePoint et Microsoft Excel.

Voir aussi