Gérer les connecteurs Microsoft 365 et les connecteurs personnalisés

• S’applique à:

  Microsoft Teams

Les connecteurs dans Microsoft Teams fournissent des mises à jour de contenu et de service directement à partir de services tiers dans un canal Teams. En utilisant des connecteurs, les utilisateurs peuvent recevoir des mises à jour de services populaires tels que Azure DevOps Services, Trello, Wunderlist, GitHub, etc. Les connecteurs publient ces mises à jour directement dans le flux de conversation. Cette fonctionnalité permet à tous les membres de l’équipe de rester synchronisés et de recevoir rapidement les informations pertinentes.

Teams et les groupes Microsoft 365 utilisent des connecteurs. Vous pouvez utiliser les mêmes connecteurs dans Teams et Microsoft Exchange.

Tout membre de l’équipe peut ajouter un connecteur à un canal, si les autorisations de l’équipe l’autorisent. Les mises à jour du service, à partir de laquelle le connecteur extrait les informations, en informent tous les membres de l’équipe. Tout membre de l’équipe disposant des autorisations d’ajout ou de suppression peut modifier la configuration des connecteurs effectuée par d’autres membres.

Important

Les développeurs ne peuvent pas inscrire de nouveaux connecteurs sur le portail des développeurs de connecteurs.

Mettre à jour l’URL des connecteurs

Les connecteurs Teams passent à une nouvelle URL pour améliorer la sécurité. Pendant cette transition, vous pouvez recevoir des notifications pour mettre à jour votre connecteur configuré afin d’utiliser la nouvelle URL. Nous vous recommandons vivement de mettre à jour votre connecteur immédiatement pour éviter toute interruption des services de connecteur.

Cette modification est nécessaire uniquement pour les connecteurs webhook tels que le webhook entrant et les connecteurs tiers. La modification n’est pas requise pour les connecteurs d’interrogation tels que RSS. Vous devez mettre à jour l’URL du connecteur pour continuer à publier des notifications dans Teams après le 31 décembre 2024.

Pourboire

Nous vous recommandons de noter l’URL que vous mettez à jour. Après sa mise à jour, vous ne pouvez plus afficher l’URL précédente. Une ancienne URL peut être utile pour rechercher et identifier les systèmes qui l’utilisent encore et que vous devez mettre à jour avec la nouvelle URL.

Pour mettre à jour l’URL, procédez comme suit :

1. Accédez à Gérer le canal dans un canal Teams, sélectionnez Modifier sous l’option Connecteurs, puis sélectionnez la section Configuré . Vérifiez les connexions de connecteur existantes sur cette page.

   

2. Mettez à jour uniquement les connexions qui s’affichent Attention required sous l’option Gérer .

   

3. Effectuez l’une des opérations suivantes :

   • Pour les connecteurs qui contiennent une URL de webhook, sélectionnez Gérer et mettre à jour l’URL.

     

   • Pour les autres types de connecteurs, supprimez le connecteur et recréez la configuration du connecteur.

4. Utilisez l’URL mise à jour ou la nouvelle connexion dans les systèmes qui ont été publiés dans l’ancienne URL. La page Configurer indique que l’URL est mise à jour.

   

Pour en savoir plus ou partager plus d’informations avec les développeurs de votre application, consultez Informations sur la dépréciation des connecteurs.

Activer ou désactiver des connecteurs dans Teams

Le module Exchange Online PowerShell v2 utilise l’authentification moderne et fonctionne avec l’authentification multifacteur (MFA) pour se connecter à tous les environnements PowerShell liés à Exchange dans Microsoft 365. Les administrateurs peuvent utiliser Exchange Online PowerShell pour désactiver les connecteurs d’une organization entière ou d’une boîte aux lettres de groupe spécifique. Si un connecteur est désactivé, il affecte tous les utilisateurs de cette organisation ou boîte aux lettres. Vous ne pouvez pas désactiver un connecteur pour quelques utilisateurs spécifiques.

Le paramètre organization remplace le paramètre de groupe. Par exemple, si un administrateur active les connecteurs pour le groupe et désactive les mêmes connecteurs pour le organization, les connecteurs sont désactivés pour le groupe. Pour activer un connecteur dans Teams, connectez-vous à Exchange Online PowerShell à l’aide de l’authentification moderne avec ou sans MFA.

Pour activer ou désactiver un connecteur, exécutez les commandes suivantes dans Microsoft Exchange Online PowerShell :

1. Ouvrez PowerShell en tant qu’administrateur.

2. Utilisez la commande Import-Module ExchangeOnlineManagement pour importer le module Microsoft Exchange.

3. Pour désactiver les connecteurs dans votre organization, utilisez la commande Set-OrganizationConfig -ConnectorsEnabled:$false.

4. Pour connecter le compte administrateur, utilisez la commande Connect-ExchangeOnline -UserPrincipalName UPN -ExchangeEnvironmentName O365USGovGCCHigh. Remplacez par UPN votre nom d’utilisateur principal.

5. Pour activer les connecteurs pour Teams, utilisez les commandes suivantes. Pour désactiver les connecteurs ou les messages actionnables, définissez la valeur false sur au lieu de true dans les commandes suivantes.

   • Set-OrganizationConfig -ConnectorsEnabled:$true
   • Set-OrganizationConfig -ConnectorsEnabledForTeams:$true
   • Set-OrganizationConfig -ConnectorsActionableMessagesEnabled:$true

Pour plus d’informations sur l’échange de modules PowerShell, consultez Set-OrganizationConfig. Pour activer ou désactiver des connecteurs Outlook, connectez des applications à vos groupes dans Microsoft Outlook. Pour en savoir plus sur le nom d’utilisateur principal (UPN), consultez qu’est-ce que l’UPN dans Microsoft 365.

Remarque

La propagation de ces modifications prend jusqu’à 24 heures.

Publier des connecteurs pour votre organisation

Pour mettre un connecteur personnalisé à la disposition des utilisateurs de votre organisation, chargez une application de connecteur personnalisée dans le catalogue d’applications de votre organisation. Les utilisateurs au sein de l’organisation peuvent installer, configurer et utiliser le connecteur dans une équipe.

Important

Les connecteurs personnalisés ne sont pas disponibles dans les environnements Cloud de la communauté du secteur public (GCC), Government Community Cloud-High (GCCH) et DoD (Department of Defense).

Pour utiliser des connecteurs dans une équipe ou un canal, ouvrez le menu Plus d’options dans le coin supérieur droit d’un canal. Dans le menu, sélectionnez Connecteurs, puis localisez ou recherchez le connecteur requis. Configurez le connecteur sélectionné si nécessaire.

Utiliser des connecteurs dans GCC ou GCCH

Les connecteurs sont désactivés par défaut dans les environnements Government Cloud Community (GCC) et Government Community Cloud-High (GCCH). Pour permettre à vos utilisateurs d’utiliser des connecteurs dans des environnements GCC ou GCCH, procédez comme suit :

1. Vous devez activer les connecteurs dans Teams.

2. Pour définir les paramètres, connectez-vous au Exchange Online PowerShell.

3. Pour utiliser un webhook entrant dans Teams, créez une application personnalisée à l’aide de la commande suivante manifest.json. Pour utiliser des icônes dans l’application personnalisée, suivez les instructions pour créer des icônes d’application.

   {
     "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.5/MicrosoftTeams.schema.json",
     "manifestVersion": "1.5",
     "id": "203a1e2c-26cc-47ca-83ae-be98f960b6b2",
     "version": "1.0.0",
     "packageName": "com.incomingwebhook.microsoft",
     "developer": {
       "name": "Microsoft Corporation",
       "websiteUrl": "https://go.microsoft.com/fwlink/?linkid=837668",
       "privacyUrl": "https://privacy.microsoft.com/privacystatement",
       "termsOfUseUrl": "https://www.microsoft.com/servicesagreement"
     },
     "description": {
       "full": "The Incoming Webhook connector enables external services to notify you about activities that you want to track.",
       "short": "Send data from a service to your Microsoft 365 group in real time. "
     },
     "icons": {
       "outline": "outline.png",
       "color": "color.png"
     },
     "connectors": [
       {
         "connectorId": "203a1e2c-26cc-47ca-83ae-be98f960b6b2",
         "scopes": ["team"]
       }
     ],
     "name": {
       "full": "Incoming Webhook",
       "short": "Incoming Webhook"
     },
     "accentColor": "#FFFFFF",
     "permissions": ["identity", "messageTeamMembers"]
   }
   

4. Chargez l’application personnalisée dans votre centre d’administration Teams.

Considérations relatives à l’utilisation de connecteurs dans Teams

• Les connecteurs sont désactivés par défaut dans les environnements Gcc (Government Cloud Community) et les Cloud-High de la communauté du secteur public (GCCH). Pour activer les connecteurs, définissez les ConnectorsEnabled paramètres ou ConnectorsEnabledForTeams sur $true avec l’applet de SetOrganizationConfig commande . Pour définir les paramètres, connectez-vous au Exchange Online PowerShell.

• Si l’utilisateur qui a ajouté un connecteur à une équipe quitte l’équipe, le connecteur continue de fonctionner.

• Vous ne pouvez pas configurer de nouvelles connexions pour les connecteurs suivants :

  • Aha!
  • Airbrake
  • Aircall
  • Liens d’application
  • AppSignal
  • Beanstalk
  • Bitbucket
  • Camarade
  • Buildkite
  • CHATS
  • Chatra
  • CercleCI
  • CodeShip
  • Constant Contact
  • GetResponse
  • Inspecteur fantôme
  • Sillon
  • Heroku
  • Honeybadger
  • Interphone
  • Logentries
  • Mailchimp
  • Microsoft Forms
  • Opsgenie
  • PagerDuty
  • Papertrail
  • Pivotal Tracker
  • Raygun
  • Runscope
  • SatisMeter
  • Sémaphore
  • Sentinelle
  • Entrée/sortie simple
  • Stack Exchange
  • SUBVERSION
  • TestFairy
  • Travis CI
  • Trello
  • Uptodown
  • Userlike
  • Wrike
  • XP-Dev
  • Zendesk

Articles connexes

• Comprendre les connecteurs et les webhooks
• Créer des connecteurs Microsoft 365