- Stampa
::: (info) () Per scaricare l'applicazione, visitare: Biblioteca:::
Integrazione con Microsoft Outlook utilizzando l'API Graph di Microsoft
Introduzione
L'API di Microsoft Outlook consente agli utenti di inviare e recuperare le e-mail di Microsoft Outlook con il giusto accesso ai loro account Microsoft. L'obiettivo di questo connettore è integrare Tulip con Microsoft utilizzando Graph API di Microsoft (v1.0) tramite connettori HTTP e fornire ai nostri clienti un connettore pronto all'uso che possa essere importato nella loro istanza.
Scopo
Questa documentazione evidenzia le diverse funzioni del connettore che possono essere costruite effettuando chiamate HTTP alla Graph API (v1.0) di Microsoft per interagire con Microsoft Outlook e mostrare varie azioni di lettura e scrittura su Outlook che potrebbero essere sfruttate per vari casi d'uso.
Documentazione API
Documentazione dell'API Graph di Microsoft
Prerequisiti
- Creare un account su Microsoft 365 e configurare le credenziali OAuth 2.0 in Microsoft Entra ID.
- 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 Outlook.
Dettagli della connessione Tulip
Le seguenti informazioni devono essere configurate su Tulip.
Connettori.
- In esecuzione su: Host del connettore cloud
- Host: graph.microsoft.com
- Porta: 443
- TLS: Sì
OAuth 2 (amministratore/operatore): L'autenticazione sarà trasferita a tutte le
le funzioni del connettore
Funzioni del connettore
1) Ottenere tutte le e-mail dalla casella di posta
Scopo
Questo connettore recupera tutte le e-mail dalla casella di posta elettronica.
Punto finale
Chiamata HTTP GET all'endpoint: https://graph.microsoft.com:443/v1.0/me/messages
Input richiesti
Nessun input richiesto
Estrattore di output
- mailID: identificatore univoco dell'e-mail che verrà utilizzato per eseguire le altre operazioni.
- mailCreatedDateTime: data e ora di creazione dell'e-mail.
- mailSubject: Oggetto di un'e-mail.
- mailBodyPreview: Contenuto di un'e-mail.
- mailSenderAddress: Indirizzo e-mail del mittente.
- mailToRecipientAddress: Indirizzo e-mail del destinatario.
2) Inviare un'e-mail di avviso per un utente specifico
Scopo
Questo connettore invia un'e-mail a un utente/gruppo di utenti specifico.
Punto finale
Chiamata HTTP GET all'endpoint: https://graph.microsoft.com:443/v1.0/me/sendMail
Input richiesti
I parametri del corpo della richiesta da passare sono i seguenti
- mailSubject- Oggetto dell'e-mail.
- mailContent- Contenuto dell'e-mail.
- emailAddress- Indirizzo e-mail del destinatario.
3) Inviare un'e-mail di avviso a più utenti
Scopo
Questo connettore invia un'e-mail a più utenti.
Punto finale
Chiamata HTTP GET all'endpoint: https://graph.microsoft.com:443/v1.0/me/sendMail
Input richiesti
I parametri URL da passare sono i seguenti
- mailSubject- Oggetto dell'e-mail.
- mailContent- Contenuto dell'e-mail.
- emailAddress1- Indirizzo e-mail del destinatario.
- emailAddress2- Indirizzo e-mail del destinatario.
- emailAddress3- Indirizzo e-mail del destinatario.
Ulteriori informazioni
Ulteriori informazioni sui connettori Microsoft