Connettore Microsoft Teams

::: (info) () Per scaricare l'applicazione, visitare: Biblioteca:::

Connettore Microsoft 365

Per l'integrazione con le app 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

::: (info) () Nota: le informazioni di autenticazione Oauth2 devono essere generate in Entra ID prima di utilizzare questo connettore. Seguire questa guida per generare le credenziali necessarie.
Connettere l'API MS Graph a Tulip con Oauth2:::

Documentazione API

Documentazione dell'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/{messaggioID}/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

• Connettore Calendario Microsoft
• Connettore Microsoft Outlook
• Connettore Microsoft Excel