- Stampa
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
- teamID: identificativo univoco del team che verrà utilizzato per svolgere gli altri compiti.
- teamName: Il nome visualizzato del team.
- 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
- ID squadra
Estrattore di output richiesto
- channelId: Identificatore univoco del canale che verrà utilizzato per svolgere gli altri compiti.
- channelName: Il nome visualizzato del Canale.
- channelDescription: La descrizione del Canale.
3) Creare un nuovo canale
Scopo
- 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.
- 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
- ID squadra
- Nome del canale
- Descrizione del canale
Estrattore di output richiesto
- channelId: Identificatore univoco del Canale che verrà utilizzato per eseguire gli altri compiti.
- channelName:il nome visualizzato del canale.
- channelDescription:La descrizione del canale.
4) Aggiornare le proprietà del canale
Scopo
- 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.
- 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
- ID squadra
- ID canale
- Nome del canale
- 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
- ID squadra
- ID canale
- Oggetto
- 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.
- ID squadra
- ID canale
Estrattore di output richiesto
- messageId: Identificatore univoco del messaggio che verrà utilizzato per eseguire gli altri compiti.
- messageContent: Il contenuto del messaggio.
- 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
- ID squadra
- ID canale
- ID messaggio
- 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
- ID squadra
- 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.
- ID squadra
Estrattore di output richiesto
- Id membro: Identificatore univoco del membro.
- Nome del membro: Il nome visualizzato del membro.
- EmailID del membro: l'ID email del membro.
- Ruolo del membro: Il ruolo di un membro nel Team Channel.
Ulteriori informazioni
Ulteriori informazioni sui connettori Microsoft