Microsoft Teams

Mentionnez @Devin dans Microsoft Teams dès que des bugs, des demandes de fonctionnalités ou des questions arrivent. Devin répond dans le fil de discussion avec des mises à jour et des questions lorsqu’il est mentionné.

1. Accédez à Settings > Connections, puis sélectionnez Microsoft Teams
2. Cliquez sur « Connect »
3. Vous serez invité à installer l’application Devin pour Microsoft Teams dans votre tenant et/ou dans l’équipe cible
4. Assurez-vous de lier votre compte utilisateur. Tous les utilisateurs de votre organisation devront effectuer cette étape pour pouvoir utiliser Devin
5. Mentionnez @Devin dans un canal ou un chat Teams pour démarrer une session

Remarque : Pour que Devin fonctionne pour chaque utilisateur, chacun doit connecter son propre compte dans le tableau de bord Devin (Settings > Connections). Cela permet à Devin d’associer l’identité Microsoft Teams de chaque utilisateur à son compte Devin.

Une fois que vous avez installé l’intégration Microsoft Teams, il vous suffit de mentionner Devin avec @Devin dans n’importe quel canal d’équipe. Devin répondra dans le fil de discussion de votre session. Vous pouvez échanger avec lui comme dans l’interface de chat Devin classique. Notez que Devin peut faire des erreurs. Veuillez vérifier attentivement ses réponses. Si vous n’avez pas encore de compte Devin, vous pouvez en savoir plus sur les tarifs et les formules ici. Notre politique de confidentialité est disponible ici. Le diagramme ci-dessous illustre l’architecture d’authentification de haut niveau de l’intégration Microsoft Teams, et montre comment le processus d’authentification se propage depuis Teams à travers différentes couches pour créer des sessions Devin authentifiées. Ci-dessous se trouve un récapitulatif des autorisations Microsoft Teams et Microsoft Graph requises par notre intégration — ce que chacune permet, pourquoi nous en avons besoin et où elle est utilisée.

En un coup d’œil

• Graph (Application, à l’échelle du tenant) : découverte et orchestration de l’installation.
• Bot Teams RSC (par équipe/conversation) : accès limité aux messages, aux membres et aux paramètres, uniquement là où le bot est installé ou présent.

Ces autorisations nécessitent un consentement d’administrateur dans Microsoft Entra ID. Elles sont app-only (aucune délégation utilisateur).

Remarque : nous n’utilisons pas Graph à l’échelle du tenant pour lire le contenu des messages. L’accès aux messages est accordé uniquement via RSC et uniquement là où le bot est installé/présent.

Celles-ci sont accordées par équipe/chat au moment de l’installation (ne s’appliquent pas à l’ensemble du client).

Garde-fous RSC : l’accès est limité à l’équipe/au chat spécifique où l’application est installée ou participe. La suppression de l’application d’une équipe/d’un chat révoque cet accès.

Le schéma ci-dessous illustre notre authentification « app-only » par certificat avec Microsoft Graph. À l’aide d’un certificat client X.509, le service obtient un jeton d’accès, puis appelle Graph pour répertorier les équipes Teams (GET /v1.0/teams). Cet exemple montre comment Devin effectue de manière sécurisée la découverte du locataire sans contexte utilisateur.

Remarque sur les informations d’identification : nous utilisons un certificat X.509 (assertion de client) plutôt qu’un secret client pour l’authentification entre services. Cela s’applique aux appels Microsoft Graph, aux communications du bot avec l’adaptateur Bot Framework et à tout appel d’API en mode application seule effectué par l’intégration.

Le diagramme ci-dessous montre le flux de bout en bout complet lorsqu’un utilisateur envoie un message à Devin dans Microsoft Teams, y compris la validation des jetons et le traitement par le bot.

Remarque concernant les informations d’authentification : nous utilisons un certificat X.509 (assertion client) plutôt qu’un secret client pour l’authentification de service à service. Cela s’applique aux appels à Microsoft Graph, aux communications du bot avec l’adaptateur Bot Framework, ainsi qu’à tout appel d’API en mode application uniquement (app-only) depuis l’intégration.

1. Consentement administrateur (à l’échelle du tenant)
   • Un administrateur Entra ID accorde les autorisations d’application Graph listées ci-dessus.
2. Découverte de l’application
   • L’intégration interroge le catalogue d’applications Teams pour localiser notre application et récupérer teamsAppId.
3. Installation ciblée
   • Depuis notre tableau de bord, nous installons le bot dans une équipe donnée.
   • Pendant l’installation, les étendues RSC sont accordées uniquement à cette équipe (ou au chat spécifique lorsqu’il est invoqué dans un chat).
4. Fonctionnement
   • La découverte (organisation/équipes/canaux/catalogue d’applications) utilise les autorisations d’application Graph.
   • La lecture et l’envoi de messages ainsi que la lecture des membres/paramètres reposent sur RSC dans les surfaces où il est installé.

• Lecteurs de base uniquement : User.ReadBasic.All (aucune lecture de messages à l’échelle du client/tenant).
• Le contenu des messages est consultable exclusivement via RSC et uniquement là où le bot est installé/présent.
• Aucune autorisation relative aux boîtes aux lettres, aux fichiers ou aux calendriers n’est demandée.

• Révoquer le consentement d’administrateur : un administrateur du tenant peut supprimer les autorisations d’application d’entreprise de l’application dans Entra ID.
• Désinstaller depuis Teams : supprimez l’application d’une équipe/d’un chat pour révoquer RSC pour cette ressource.
• Gestion des données : lors de la désinstallation, notre intégration cesse de traiter les événements pour cette équipe/ce chat et supprime les abonnements/liens associés.