Connecteur Microsoft Teams

:: : (info) () Pour télécharger l'application, visitez : Bibliothèque::: :

Connecteur Microsoft Teams

Intégration de Tulip avec Microsoft Teams

Introduction

L'API Microsoft Teams permet aux utilisateurs de créer, lire et éditer des équipes et des canaux Microsoft au sein de Teams avec les droits d'accès définis dans leurs comptes Microsoft. Le but de ce connecteur est d'intégrer Tulip avec Microsoft en utilisant l'API Graphique de Microsoft (v1.0) en utilisant des connecteurs HTTP et de fournir à nos clients un connecteur prêt à l'emploi qui peut être importé dans leur instance.

Objectif

Nous allons mettre en évidence les différentes fonctions du connecteur qui peuvent être construites en faisant des appels HTTP à l'API graphique de Microsoft (v1.0) pour interagir avec les équipes M365 afin de présenter diverses actions de lecture et d'écriture sur les équipes qui pourraient être exploitées pour divers cas d'utilisation.

Doc API

Documentation de l'API Microsoft Graph

Pré-requis

1. Créer un compte sur Microsoft 365 et configurer les informations d'identification OAuth 2.0 dans Microsoft Entra ID.
2. Enregistrer l'API avec les champs d'application requis dans le portail Microsoft. Azure - Entra ID

Vidéo de configuration du connecteur pour Excel :

Vous pouvez suivre les mêmes étapes pour configurer le connecteur pour les équipes.

Détails de la connexion Tulip

Les informations suivantes doivent être configurées sur le site Tulip's

Connecteurs.

1. Exécuté sur : Cloud Connector Host
2. Hôte : graph.microsoft.com
3. Port : 443
4. TLS : Oui

OAuth 2 : L'authentification sera transférée à toutes les fonctions du connecteur.

fonctions du connecteur

**Important à noter :**1. Il s'agit d'une connexion Tulip-Microsoft sur https. 2. L'accès est contrôlé par l'authentification du côté de Microsoft. En fonction du compte Teams utilisé pour l'authentification, l'utilisateur aura le même accès. Dans les fonctions du connecteur, vous pouvez configurer davantage les permissions et les niveaux d'accès.

Fonctions du connecteur

1) Obtenir toutes les équipes

Objectif

Ce connecteur récupère toutes les équipes dont un utilisateur fait partie à l'aide de son compte Microsoft Teams.

Point d'arrivée

Appel HTTP GET au point de terminaison - https://graph.micrsoft.com:443/v1.0/me/joinedTeams

Données requises

Aucune entrée requise

Extracteur de sortie requis

1. teamID : Identifiant unique de l'équipe qui sera utilisée pour effectuer les autres tâches.
2. teamName : Nom d'affichage de l'équipe.
3. teamDescription : Description de l'équipe.

2) Obtenir tous les canaux d'une équipe

Objectif

Ce connecteur permet de récupérer tous les canaux d'une équipe en passant l'identifiant de l'équipe en entrée.

Point d'arrivée

Appel HTTP GET au point de terminaison - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

Données requises

Les paramètres URL à transmettre sont les suivants

1. ID de l'équipe

Sortie requise Extracteur

1. channelId : Identifiant unique du canal qui sera utilisé pour effectuer les autres tâches.
2. channelName : Nom d'affichage du canal.
3. channelDescription : La description du canal.

3) Créer un nouveau canal

Objectif

1. Les utilisateurs peuvent passer un ID d'équipe, un nom de canal et une description de canal en entrée et Tulip créera un nouveau canal avec le nom de canal fourni. La réponse de l'API contiendra les métadonnées et les diverses propriétés du canal. Celles-ci peuvent être utilisées pour récupérer et mettre à jour les données du canal.
2. Les informations extraites de l'API Microsoft Graph V1.0 peuvent ensuite être utilisées dans les applications Tulip, les tables Tulip ou les variables Tulip qui seront acheminées vers d'autres fonctions du connecteur.

Point d'arrivée

HTTP POST appel au point de terminaison - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

Données requises

Les paramètres suivants sont envoyés dans le corps de la requête

1. ID de l'équipe
2. Nom du canal
3. Description de la chaîne

Extracteur de sortie requis

1. channelId : Identifiant unique du canal qui sera utilisé pour exécuter les autres tâches.
2. channelName : Nom d'affichage du canal.
3. channelDescription : Description du canal.

4) Mise à jour des propriétés du canal

Objectif

1. Les utilisateurs peuvent passer un ID d'équipe, un ID de canal, un nouveau nom de canal et une nouvelle description de canal en entrée et Tulip mettra à jour un nouveau canal avec le nouveau nom de canal et la description fournis. La réponse de l'API sera constituée des métadonnées et des diverses propriétés du canal. Celles-ci peuvent être utilisées pour récupérer et mettre à jour les données du canal.
2. Les informations extraites de l'API Microsoft Graph V1.0 peuvent ensuite être utilisées soit dans les applications Tulip, soit dans les tables Tulip, soit dans les variables Tulip qui seront acheminées vers d'autres fonctions du connecteur.

Point final

Appel HTTP PATCH au point de terminaison https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}

Données requises

Les paramètres suivants sont envoyés en tant que partie de l'URL et/ou du corps de la requête

1. ID de l'équipe
2. ID du canal
3. Nom du canal
4. Description du canal

Extracteur de sortie requis

Nous n'avons pas besoin d'extracteur de sortie.

5) Envoyer un message à un canal

Objectif

Les utilisateurs peuvent passer un ID d'équipe, un ID de canal, un sujet et un contenu de message en entrée et Tulip enverra un message avec le contenu du message fourni.

Point d'arrivée

HTTP POST appel au point de terminaison - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages

Données requises

Les paramètres suivants sont envoyés en tant que partie de l'URL et/ou du corps de la requête

1. ID de l'équipe
2. ID du canal
3. Objet du message
4. Contenu du message

Extracteur de sortie requis

Nous n'avons pas besoin d'extracteur de sortie.

6) Obtenir tous les messages d'un canal spécifique

Objectif

Ce connecteur permet de récupérer tous les messages d'un canal spécifique.

Point de terminaison

Appel HTTP GET au point de terminaison - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}/messages

Données requises

Les paramètres URL à transmettre sont les suivants.

1. ID de l'équipe
2. ID du canal

Sortie requise Extracteur

1. messageId : Identifiant unique du message qui sera utilisé pour effectuer les autres tâches.
2. messageContent : Contenu du message.
3. messageFrom : Nom d'affichage de l'expéditeur.

7) Répondre à un message

Objectif

Les utilisateurs peuvent transmettre un ID d'équipe, un ID de canal, un sujet et un contenu de message comme entrée pour répondre à un message et Tulip enverra une réponse avec le contenu du message fourni.

Point d'arrivée

HTTP POST appel au point de terminaison - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages/{messageID}/replies

Données requises

Les paramètres suivants sont envoyés dans le cadre de l'URL et/ou du corps de la requête

1. ID de l'équipe
2. ID du canal
3. ID du message
4. Contenu du message

Extracteur de sortie requis

Nous n'avons pas besoin d'extracteur de sortie.

8) Supprimer un canal

Objectif

Les utilisateurs peuvent passer un ID d'équipe et un ID de canal en entrée et Tulip supprimera le canal spécifique avec les entrées fournies.

Point final

HTTP DELETE appel au point de terminaison -https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}

Données requises

Les paramètres URL à transmettre sont les suivants

1. ID de l'équipe
2. ID du canal

Extracteur de sortie requis

Nous n'avons pas besoin d'extracteur de sortie.

9) Obtenir la liste des membres d'une équipe

Objectif

Ce connecteur permet de récupérer tous les membres d'une équipe spécifique.

Point de terminaison

Appel HTTP GET au point de terminaison https://graph.microsoft.com:443/v1.0/teams/{teamID}/members

Données requises

Les paramètres URL à transmettre sont les suivants.

1. ID de l'équipe

Sortie requise Extracteur

1. Member Id : Identifiant unique du membre.
2. Nom du membre : Le nom d'affichage du membre.
3. EmailID du membre : L'identifiant de l'email du membre.
4. Member Role (Rôle du membre) : Le rôle du membre dans le canal de l'équipe.

Pour en savoir plus

Plus d'informations sur les connecteurs Microsoft

• Connecteur Microsoft Calendar
• Connecteur Microsoft Outlook
• Connecteur Microsoft Excel