Connettore Microsoft Teams
  • 13 Jan 2025
  • 4 Minuti da leggere
  • Contributori

Connettore Microsoft Teams


Sommario dell'articolo

To download the app, visit: Library

Connettore Microsoft 365

Per l'integrazione con le applicazioni Microsoft come Teams, Outlook e Office Suite.

Scopo

Utilizzare questo documento per integrare le applicazioni Tulip con i prodotti Microsoft 365 come Teams, Office Suite e Outlook.

Prerequisiti

Note: Oauth2 authentication information must be generated in Entra ID before using this Connector. Follow this guide to generate the required credentials. Connect the MS Graph API to Tulip with Oauth2

Documentazione API

Documentazione API Microsoft Graph

Scopi necessari per questo connettore

Funzioni del connettore

1) Ottenere tutti i team

Scopo

Questo connettore recupera tutti i team di cui un utente fa parte utilizzando il suo account Microsoft teams.

Punto finale

Chiamata HTTP GET all'endpoint - https://graph.micrsoft.com:443/v1.0/me/joinedTeams

Input richiesto

Nessun input richiesto

Estrattore di output richiesto

  1. teamID: identificativo univoco del team che verrà utilizzato per svolgere gli altri compiti.
  2. teamName: Il nome visualizzato del team.
  3. teamDescription: La descrizione del team.

2) Ottenere tutti i canali di un team

Scopo

Questo connettore recupera tutti i canali di un team passando il teamID come input.

Punto finale

Chiamata HTTP GET all'endpoint - https://graph.microsoft.com:443/v1.0/teams/{teamID}/canali

Input richiesti

I parametri URL da passare sono i seguenti

  1. ID squadra

Estrattore di output richiesto

  1. channelId: Identificatore univoco del canale che verrà utilizzato per svolgere gli altri compiti.
  2. channelName: Il nome visualizzato del Canale.
  3. channelDescription: La descrizione del Canale.

3) Creare un nuovo canale

Scopo

  1. Gli utenti possono inserire l'ID del team, il nome del canale e la descrizione del canale e Tulip creerà un nuovo canale con il nome fornito. La risposta dell'API sarà costituita dai metadati e dalle varie proprietà del canale. Queste possono essere ulteriormente utilizzate per recuperare e aggiornare i dati dal canale.
  2. Le informazioni estratte dall'API Microsoft Graph V1.0 possono essere utilizzate all'interno delle applicazioni Tulip, delle tabelle Tulip o delle variabili Tulip che vengono convogliate in altre funzioni del connettore.

Punto finale

Chiamata HTTP POST all'endpoint - https://graph.microsoft.com:443/v1.0/teams/{teamID}/canali

Input richiesti

I parametri che vengono inviati come corpo della richiesta sono i seguenti

  1. ID squadra
  2. Nome del canale
  3. Descrizione del canale

Estrattore di output richiesto

  1. channelId: Identificatore univoco del Canale che verrà utilizzato per eseguire gli altri compiti.
  2. channelName:il nome visualizzato del canale.
  3. channelDescription:La descrizione del canale.

4) Aggiornare le proprietà del canale

Scopo

  1. Gli utenti possono passare un ID squadra, un ID canale, un nuovo nome canale e una nuova descrizione canale come input e Tulip aggiornerà un nuovo canale con il nuovo nome e la nuova descrizione forniti. La risposta dell'API sarà costituita dai metadati e dalle varie proprietà del canale. Queste possono essere ulteriormente utilizzate per recuperare e aggiornare i dati del canale.
  2. Le informazioni estratte dall'API di Microsoft Graph V1.0 possono essere utilizzate all'interno delle applicazioni Tulip, delle tabelle Tulip o delle variabili Tulip che vengono convogliate in altre funzioni del connettore.

Punto finale

Chiamata HTTP PATCH all'endpoint https://graph.microsoft.com:443/v1.0/teams/{teamID}/canali/{channelID}

Input richiesti

I parametri che vengono inviati come parte dell'URL e/o del corpo della richiesta sono i seguenti

  1. ID squadra
  2. ID canale
  3. Nome del canale
  4. Descrizione del canale

Estrattore di output richiesto

Non è richiesto alcun estrattore di output.

5) Inviare un messaggio a un canale

Scopo

Gli utenti possono passare un ID squadra, un ID canale, un oggetto e un contenuto del messaggio come input e Tulip invierà un messaggio con il contenuto del messaggio fornito.

Punto finale

Chiamata HTTP POST all'endpoint - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/canali/{channelID}/messaggi

Input richiesti

I parametri che vengono inviati come parte dell'URL e/o del corpo della richiesta sono i seguenti

  1. ID squadra
  2. ID canale
  3. Oggetto
  4. Contenuto del messaggio

Estrattore di output richiesto

Non è richiesto alcun estrattore di output.

6) Ottenere tutti i messaggi di un canale specifico

Scopo

Questo connettore recupera tutti i messaggi di un canale specifico.

Punto finale

Chiamata HTTP GET all'endpoint - https://graph.microsoft.com:443/v1.0/teams/{teamID}/canali/{channelID}/messaggi

Input richiesti

I parametri URL da passare sono i seguenti.

  1. ID squadra
  2. ID canale

Estrattore di output richiesto

  1. messageId: Identificatore univoco del messaggio che verrà utilizzato per eseguire gli altri compiti.
  2. messageContent: Il contenuto del messaggio.
  3. messageFrom: Il nome visualizzato del mittente.

7) Risposta a un messaggio

Scopo

Gli utenti possono passare un ID squadra, un ID canale, un oggetto e un contenuto del messaggio come input per rispondere a un messaggio e Tulip invierà una risposta con il contenuto del messaggio fornito.

Punto finale

Chiamata HTTP POST all'endpoint - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/canali/{channelID}/messaggi/{messageID}/risposte

Input richiesti

I parametri che vengono inviati come parte dell'URL e/o del corpo della richiesta sono i seguenti

  1. ID squadra
  2. ID canale
  3. ID messaggio
  4. Contenuto del messaggio

Estrattore di output richiesto

Non è richiesto alcun estrattore di output.

8) Cancellare un canale

Scopo

Gli utenti possono inserire l'ID di un team e l'ID di un canale e Tulip cancellerà il canale specifico con gli input forniti.

Punto finale

Chiamata HTTP DELETE all'endpoint -https://graph.microsoft.com:443/v1.0/teams/{teamID}/canali/{channelID}

Input richiesti

I parametri URL da passare sono i seguenti

  1. ID squadra
  2. ID canale

Estrattore di output richiesto

Non è richiesto alcun estrattore di output.

9) Ottenere l'elenco dei membri di un team

Scopo

Questo connettore recupera tutti i membri di un team specifico.

Punto finale

Chiamata HTTP GET all'endpoint https://graph.microsoft.com:443/v1.0/teams/{teamID}/membri

Input richiesti

I parametri URL da passare sono i seguenti.

  1. ID squadra

Estrattore di output richiesto

  1. Id membro: Identificatore univoco del membro.
  2. Nome del membro: Il nome visualizzato del membro.
  3. EmailID del membro: l'ID email del membro.
  4. Ruolo del membro: Il ruolo di un membro nel Team Channel.

Ulteriori informazioni

Ulteriori informazioni sui connettori Microsoft


Questo articolo è stato utile?