Créer des connecteurs Teams
Le connecteur Microsoft Teams est un exemple d’application de gestion des tâches MVC (Model-View-Controller) et généré à l’aide du modèle d’application web ASP.NET. La majeure partie du code est liée à la configuration MVC de base ou au système de gestion des tâches. Vous pouvez ajouter votre connecteur existant pour les groupes Microsoft 365 ou en créer un nouveau dans Teams.
Types de codes de connecteur
- ConnectorController.cs : configurer et enregistrer des actions.
- TaskController.cs : créer et mettre à jour des actions.
Principales fonctionnalités du connecteur Microsoft Teams
- Simule un système de gestion des tâches réel.
- Permet aux utilisateurs de créer et d’afficher des tâches.
- Génère du contenu de manière aléatoire.
- Simule une notification à envoyer au canal Microsoft Teams.
Ce guide pas à pas vous aide à créer et tester un connecteur dans Microsoft Teams. Vous verrez la sortie suivante :
Configuration requise
Veillez à installer les outils suivants et à configurer votre environnement de développement :
| Installer | Pour l’utilisation... | |
|---|---|---|
| Microsoft Teams | Microsoft Teams pour collaborer avec toutes les personnes avec lesquelles vous travaillez via des applications de conversation, de réunions et d’appels au même endroit. | |
| Visual Studio 2022 | Vous pouvez installer la version entreprise dans Visual Studio 2022 et installer les charges de travail de développement ASP.NET et web. Utilisez la dernière version. | |
| SDK .NET Core | Liaisons personnalisées pour le débogage local et les déploiements d’applications Azure Functions. Utilisez la dernière version ou installez la version portable. | |
| Tunnel de développement | Les fonctionnalités de l’application Teams (bots conversationnels, extensions de message et webhooks entrants) ont besoin de connexions entrantes. Un tunnel connecte votre système de développement à Teams. Le tunnel de développement est un outil puissant pour ouvrir en toute sécurité votre localhost sur Internet et contrôler qui a accès. Le tunnel de développement est disponible dans Visual Studio 2022 version 17.7.0 ou ultérieure. ou Vous pouvez également utiliser ngrok comme tunnel pour connecter votre système de développement à Teams. Elle n’est pas obligatoire pour les applications qui incluent uniquement des onglets. Ce package est installé dans le répertoire du projet (à l’aide de npm devDependencies). |
Remarque
Après avoir téléchargé ngrok, inscrivez-vous et installez authtoken.
Configurer l’environnement local
Ouvrez Microsoft-Teams-Samples.
Sélectionnez Code.
Dans le menu déroulant, sélectionnez Ouvrir avec GitHub Desktop.
Sélectionnez Cloner.
Activer l’aperçu pour les développeurs
Activez le chargement d’applications dans la console d’administration de votre locataire.
Connectez-vous à Centre d’administration Microsoft 365 avec vos informations d’identification d’administrateur.
Dans le volet gauche, sélectionnez Afficher tout.
Sélectionnez Teams.
Dans le volet gauche, sélectionnez Applications Teams.
Sélectionnez Stratégies d’installation.
Sélectionnez Global (valeur par défaut à l’échelle de l’organisation).
Activez le bouton bascule Charger des applications personnalisées .
Sélectionnez Enregistrer.
Votre locataire de test peut désormais autoriser le chargement d’applications personnalisées.
Conseil
Le chargement d’applications personnalisées prend un certain temps pour devenir actif.
Accédez à Microsoft Teams.
Dans le coin supérieur droit de votre Teams, sélectionnez ....
Sélectionnez À propos de>l’aperçu pour les développeurs.
Sélectionnez Basculer vers la préversion du développeur.
Configurer votre connecteur
Ouvrez TeamsToDoAppconnector.sln dans Visual Studio à partir du dépôt cloné.
Créer un tunnel
Ouvrez Visual Studio.
Sélectionnez Créer un projet.
Dans la zone de recherche, entrez ASP.NET. Dans les résultats de la recherche, sélectionnez ASP.NET Core Web App.
Sélectionnez Suivant.
Entrez Nom du projet , puis sélectionnez Suivant.
Sélectionnez Créer.
Une fenêtre de vue d’ensemble s’affiche.
Dans la liste déroulante de débogage, sélectionnez Dev Tunnels (aucun tunnel actif)>Créer un tunnel....
Une fenêtre contextuelle apparaît.
Mettez à jour les détails suivants dans la fenêtre contextuelle :
- Compte : entrez un compte Microsoft ou GitHub.
- Nom : entrez un nom pour votre tunnel.
- Type de tunnel : dans la liste déroulante, sélectionnez Temporaire.
- Accès : dans la liste déroulante, sélectionnez Public.
Sélectionnez OK.
Une fenêtre contextuelle s’affiche pour indiquer que le tunnel de développement a été créé avec succès.
Sélectionnez OK.
Vous trouverez le tunnel que vous avez créé dans la liste déroulante de débogage comme suit :
Sélectionnez F5 pour exécuter l’application en mode débogage.
Si une boîte de dialogue Avertissement de sécurité s’affiche, sélectionnez Oui.
Une fenêtre contextuelle apparaît.
Cliquez sur Continuer.
La page d’accueil du tunnel de développement s’ouvre dans une nouvelle fenêtre de navigateur et le tunnel de développement est maintenant actif.
Accédez à Visual Studio, puis sélectionnez Afficher la > sortie.
Dans le menu déroulant Console de sortie, sélectionnez Tunnels de développement.
La console de sortie affiche l’URL du tunnel de développement.
Accédez au Portail des développeurs de connecteurs.
Sélectionnez Nouveau connecteur.
Entrez les informations suivantes pour inscrire un nouveau connecteur :
- Nom du connecteur.
- Logo
- Brève description de votre application (10 mots ou moins).
- Description détaillée de ce que fait votre connecteur (3 à 5 phrases).
- Site web de l’entreprise.
-
Page de configuration de votre connecteur en tant que
https://[BASE_URI]/connector/setup. - Définissez Domaines valides sur
https>//[Base URI]. - Sélectionnez Oui pour activer l’action sur les cartes de connecteur.
- Définissez l’URL des actions sur
https://[BASE_URI]/Task/Update. - Sélectionnez J’accepte les conditions générales du Contrat développeur de l’application.
- Sélectionnez Enregistrer.
Vous avez correctement inscrit un nouveau connecteur. La fenêtre s’affiche avec l’ID de connecteur inscrit.
Conseil
Enregistrez l’ID du connecteur pour référence ultérieure.
Ouvrez le fichier TeamsToDoAppConnector.csproj à partir du dépôt cloné.
Dans votre dépôt cloné, accédez à Microsoft-Teams-Samples>samples>connector-to-notification>csharp.
Ouvrez le fichier appsettings.json dans Visual Studio et effectuez les mises à jour suivantes.
- Remplacez par
BASE_URLngork URLoudev tunnel URL. - Remplacez par
CONNECTOR_IDl’ID de connecteur créé.
- Remplacez par
Dans votre dépôt cloné, accédez à Microsoft-Teams-Samples>samples>connector-to-notification>csharp>TeamsAppPackages.
Ouvrez le fichier manifest.json dans Visual Studio et apportez les modifications suivantes :
Remplacez par
CONNECTOR_IDl’ID de connecteur créé.Remplacez par
VALID-DOMAINvotre domaine de tunnel ngrok OR dev, à l’exclusion de https://.
Appuyez sur F5 pour exécuter le projet. Une page web s’ouvre.
Connecteur de test dans Microsoft Teams
Créez un fichier .zip avec les fichiers suivants présents dans le dossier Manifeste :
manifest.json
outline-icon.png
color-icon.png
Accédez à Microsoft Teams.
Dans le volet gauche, sélectionnez l’icône Applications .
Sélectionnez Gérer vos applications.
Sélectionnez Charger une application.
Recherchez l’option Charger une application personnalisée.
Sélectionnez le fichier .zip que vous avez créé dans le dossier Manifeste , puis sélectionnez Ouvrir.
Sélectionnez Ajouter à une équipe.
Sélectionnez le nom de l’équipe ou du canal dans la liste.
Sélectionnez Configurer un connecteur.
Dans le volet gauche, recherchez le connecteur ToDo Teams dans la barre de recherche, puis sélectionnez Configurer.
Sélectionnez Créé ou Mis à jour dans la page d’inscription, puis sélectionnez Enregistrer.
Après la configuration, vous pouvez voir une notification dans le canal avec un lien vers le portail du Gestionnaire des tâches.
Accédez au portail du Gestionnaire des tâches.
Sélectionnez Créer.
Entrez les détails de la nouvelle tâche :
- Titre
- Description
- Affecter à
Sélectionnez Enregistrer.
La carte de message apparaît dans le canal Teams inscrit.
Conseil
Vous pouvez essayer les boutons actionnables disponibles sur la carte de message.
Relever le défi
Tu as trouvé quelque chose comme ça ?
Félicitations !
Vous avez terminé le tutoriel pour bien démarrer avec les connecteurs Microsoft Teams !
Vous avez un défi avec cette section ? Si c'est le cas, faites-nous part de vos commentaires pour que nous puissions l'améliorer.