Connettore Microsoft Teams

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

Connettore Microsoft Teams

Integrazione di Tulip con Microsoft Teams

Introduzione

L'API di Microsoft Teams consente agli utenti di creare, leggere e modificare i team e i canali Microsoft all'interno di Teams con il giusto accesso impostato sui loro account Microsoft. L'obiettivo di questo connettore è integrare Tulip con Microsoft utilizzando l'API Graph di Microsoft (v1.0) tramite i connettori HTTP e fornire ai nostri clienti un connettore pronto all'uso che può essere importato nella loro istanza.

Scopo

Verranno evidenziate le diverse funzioni del connettore che possono essere costruite effettuando chiamate HTTP all'API Graph di Microsoft (v1.0) per interagire con i team di M365 e mostrare varie azioni di lettura e scrittura sui team che potrebbero essere sfruttate per vari casi d'uso.

Documentazione API

Documentazione dell'API Graph di Microsoft

Prerequisiti

1. Creare un account su Microsoft 365 e configurare le credenziali OAuth 2.0 in Microsoft Entra ID.
2. Registrare l'API con gli ambiti richiesti nel portale Microsoft. Azure - Entra ID

Video di impostazione del connettore per Excel:

È possibile seguire gli stessi passaggi per configurare anche il connettore per i team.

Dettagli della connessione Tulip

Le seguenti informazioni devono essere configurate su Tulip.

Connettori.

1. In esecuzione su: Host del connettore cloud
2. Host: graph.microsoft.com
3. Porta: 443
4. TLS: Sì

OAuth 2: l'autenticazione sarà trasferita a tutte le

le funzioni del connettore

**Importante da notare:**1. Si tratta di una connessione da Tulip a Microsoft su https. 2. L'accesso è controllato dall'autenticazione sul lato Microsoft. L'accesso è controllato dall'autenticazione sul lato Microsoft. A seconda dell'account Teams utilizzato per l'autenticazione, l'utente avrà lo stesso accesso. Nelle funzioni del connettore, è possibile configurare ulteriormente le autorizzazioni e i livelli di accesso.

Funzioni del connettore

1) Ottieni 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