Connecteur Microsoft Teams
  • 13 May 2024
  • 5 Minutes à lire
  • Contributeurs

Connecteur Microsoft Teams


Résumé de l’article

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

Connecteur Microsoft 365

Pour l'intégration avec les applications Microsoft telles que Teams, Outlook et Office Suite.

Objectif

Utilisez ce document pour intégrer vos Tulip Apps avec les produits Microsoft 365 comme Teams, Office Suite, et Outlook.

Pré-requis

Note : Les informations d'authentification Oauth2 doivent être générées dans Entra ID avant d'utiliser ce connecteur. Suivez ce guide pour générer les informations requises.
Connecter l'API MS Graph à Tulip avec Oauth2:: :

API Doc

Documentation de l'API Microsoft Graph

Scopes nécessaires pour ce connecteur

Fonctions du connecteur

1) Obtenir toutes les équipes

Objectif

Ce connecteur récupère toutes les équipes dont un utilisateur fait partie en utilisant son compte Microsoft teams.

Point de terminaison

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


Cet article vous a-t-il été utile ?