> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Collegare Outlook alla tua app

> Invia e leggi email e gestisci gli eventi del calendario dalla tua app, usando un account condiviso o l'account personale di ogni persona.

Collega la tua app a Outlook per inviare e leggere email, gestire gli eventi del calendario ed eseguire workflow quando un'email o un evento cambia. Usa un unico account condiviso per tutta la tua app, oppure permetti a ogni persona di collegare il proprio account Microsoft.

> [!NOTE]
>
> Ti serve un [piano Builder](https://base44.com/pricing) o superiore per usare i connettori nella tua app.

***

## Cosa puoi fare

Porta la posta e il calendario di Outlook nei workflow della tua app.

> [card] Invia email
>
> Invia email dal tuo account Outlook quando succede qualcosa nella tua app, come una nuova prenotazione.

> [card] Leggi e organizza le email
>
> Leggi i messaggi recenti, riassumili e spostali o aggiornali dalla tua app.

> [card] Gestisci il calendario
>
> Mostra i tuoi eventi di Outlook nella tua app e crea o aggiorna eventi quando qualcosa viene pianificato.

> [card] [Esegui workflow](https://docs.base44.com/it/Building-your-app/Creating-workflows.md#connector)
>
> Avvia un workflow quando un'email arriva nella tua casella o viene creato un evento del calendario, oppure quando uno dei due viene aggiornato o eliminato.

**Prompt di esempio**

Descrivi nella chat AI la casella di posta o il calendario, cosa avvia l'azione ed eventuali campi dinamici. Ad esempio:

```text wrap theme={null}
Invia email dalla mia app usando Outlook.
```

```text wrap theme={null}
Mostra nella dashboard gli eventi del mio calendario Outlook.
```

```text wrap theme={null}
Crea eventi del calendario in Outlook quando qualcosa viene pianificato nella mia app.
```

```text wrap theme={null}
Leggi le email recenti da Outlook e riassumile.
```

> [!TIP]
>
> Vuoi che il tuo Superagent partecipi alle tue riunioni Outlook e prenda appunti? Consulta [Collegare il tuo calendario](https://docs.base44.com/it/superagents/meeting-notes.md#connecting-your-calendar).

***

## Connettere Outlook

Scegli come si collegano le persone: un unico account condiviso per tutta la tua app, oppure l'account personale di ogni persona.

> [tab] Connettore condiviso
>
> Colleghi un account e tutti quelli che usano la tua app condividono l'account e i suoi dati.
>
> **Per aggiungere un connettore Outlook condiviso:**
>
> 1. Clicca su **Connectors** nella barra laterale del workspace.
>
> 2. Clicca su **Add connector**.
>
> 3. Cerca **Outlook** e cliccaci sopra.
>
> 4. Seleziona **Shared connector**, poi clicca su **Next**.
>
> 5. Inserisci un **Connection name**.
>
> 6. In **Who can access**, scegli dove si può usare la connessione: **Apps and Super agent** (l'impostazione predefinita), **Apps only** o **Super agent only**.
>
> 7. Scegli **Read-only** (l'impostazione predefinita), **Read & write** o **Custom** sotto **Permissions**. Per inviare email, scegli **Read & write**. Scopri di più su [scope e permessi](#scopes-and-permissions).
>
>    ![La configurazione del connettore Outlook condiviso con Connection name, Who can access e i permessi Read-only selezionati](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-shared-setup.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=5638130e25a42638151162b63b297ef3)
>
>    Configurare un connettore Outlook condiviso
>
> 8. Clicca su **Add connector**.
>
> 9. Accedi con l'account Microsoft che vuoi condividere.

> [tab] Connettore per utenti dell'app
>
> Ogni persona collega il proprio account Microsoft, così la tua app può lavorare con la sua posta e il suo calendario.
>
> > [!TIP]
> >
> > **Prima di iniziare:** solo i proprietari e gli admin del workspace possono configurarlo. Ti servono una registrazione dell'app Microsoft e i relativi Client ID e Client Secret. A meno che tu non inserisca un [Microsoft Tenant ID](#using-a-microsoft-tenant), imposta i **Supported account types** su account in qualsiasi directory dell'organizzazione e account Microsoft personali. Consulta [Usare il tuo client OAuth](https://docs.base44.com/it/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **Per aggiungere un connettore Outlook per utenti dell'app:**
>
> 1. Clicca su **Connectors** nella barra laterale del workspace.
>
> 2. Clicca su **Add connector**.
>
> 3. Cerca **Outlook** e cliccaci sopra.
>
> 4. Seleziona **App user connector**, poi clicca su **Next**.
>
> 5. Copia il **Callback URL**.
>
> 6. Nella registrazione dell'app Microsoft, aggiungi il Callback URL ai redirect URI consentiti.
>
> 7. Tornato al modulo **Add Outlook Connection**, inserisci un **Connector name**, il **Client ID** e il **Client Secret**.
>
>    ![Il modulo Add Outlook Connection con Callback URL, Connector name, Client ID e Client Secret](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-app-user-credentials.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=5fb6f375d00995fabb114eb4e9dd463c)
>
>    Inserire le credenziali della tua app Microsoft
>
> 8. (Facoltativo) Controlla gli scope preselezionati sotto **Scopes** e rimuovi quelli che non servono alla tua app.
>
>    ![Il campo Scopes di Outlook con scope bloccati e predefiniti, e Additional scopes sotto](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-app-user-scopes.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=2d9c8f72c63f63496b4f8f45aae8daf4)
>
>    Scegliere gli scope per un connettore per utenti dell'app
>
> 9. Clicca su **Add Connector**.
>
> Poi chiedi alla chat AI della tua app di aggiungere un modo per permettere alle persone di collegare il proprio account Outlook.

***

## Scope e permessi

Gli scope controllano cosa può fare la tua app in Outlook. Li scegli quando configuri un connettore.

> [card]
>
> **1. Base44 aggiunge**
>
> Sono sempre inclusi, quindi appaiono come scope bloccati sotto **Custom** per un connettore condiviso o sotto **Scopes** per un connettore per utenti dell'app.
>
> * `User.Read`: accede e legge il profilo dell'account che si collega
> * `offline_access`: mantiene attiva la connessione senza dover accedere di nuovo
>
> **2. Tu configuri**
>
> Seleziona gli scope di cui la tua app ha bisogno sotto **Custom** per un connettore condiviso o sotto **Scopes** per un connettore per utenti dell'app.
>
> Per un connettore condiviso, **Read-only** dà alla tua app `Mail.Read` e `Calendars.Read`. **Read & write** le dà `Mail.ReadWrite`, `Calendars.ReadWrite` e `Mail.Send`.
>
> * `Mail.Read`: legge le email
> * `Mail.ReadWrite`: legge, crea, aggiorna ed elimina le email, senza inviarle
> * `Mail.Send`: invia email a nome dell'account
> * `Calendars.Read`: legge gli eventi del calendario
> * `Calendars.ReadWrite`: legge, crea, aggiorna ed elimina gli eventi del calendario
>
> **Accesso:** la tua app lavora con la casella di posta e il calendario dell'account Microsoft che autorizza la connessione.

### Usare un tenant Microsoft

Per un connettore per utenti dell'app, puoi inserire un **Microsoft Tenant ID** nel modulo di configurazione, in Connection Configuration. Lascialo vuoto per usare `common`. Se ne inserisci uno, l'impostazione dei tipi di account supportati nella registrazione dell'app Microsoft non si applica.

***

## Usare le funzioni backend

Una volta collegato Outlook, le tue funzioni backend possono recuperare un token di accesso e chiamare direttamente l'API Microsoft Graph. Base44 gestisce l'accesso e mantiene aggiornato il token per te.

* Per una connessione condivisa, usa `getConnection()` per recuperare il token.
* Per una connessione per utenti dell'app, usa `getCurrentAppUserConnection()`, così ogni richiesta usa il token della persona che ha effettuato l'accesso.

Chiama l'API Microsoft Graph su `graph.microsoft.com` e passa il token nell'header `Authorization`:

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("outlook");

const response = await fetch(
  "https://graph.microsoft.com/v1.0/me/messages?$top=10",
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
const { value: messages } = await response.json();
```

> [card] [Connettori condivisi](https://docs.base44.com/it/developers/backend/resources/connectors/shared-connectors.md)
>
> Configura, distribuisci e chiama una connessione condivisa da una funzione backend.

> [card] [Connettori per utenti dell'app](https://docs.base44.com/it/developers/backend/resources/connectors/app-user-connectors.md)
>
> Recupera un token per singolo utente e chiama l'API come la persona che ha effettuato l'accesso.

***

## Risoluzione dei problemi

Se Outlook smette di funzionare nella tua app, controlla la connessione e i suoi scope.

> [accordion] La connessione deve essere ricollegata
>
> Se l'accesso a Outlook viene perso o scade, la connessione mostra **This connection needs to be reconnected**. Per un connettore condiviso, [ricollegalo](https://docs.base44.com/it/Integrations/Connectors.md#managing-your-connectors) e accedi con lo stesso account Microsoft. Tutte le app che lo usano tornano a funzionare. Per un connettore per utenti dell'app, ogni persona ricollega il proprio account dall'interno della tua app.

> [accordion] La tua app non riesce a inviare email
>
> La tua app ha bisogno dello scope `Mail.Send` per inviare email. Lo scope `Mail.ReadWrite` permette alla tua app di leggere e modificare i messaggi, ma non di inviarli.
>
> * Per un connettore condiviso, i permessi vengono impostati quando aggiungi la connessione. Clicca su **Add another connector** nella pagina del connettore Outlook e scegli **Read & write** per la nuova connessione.
> * Per un connettore per utenti dell'app, aprilo nella pagina del connettore Outlook, aggiungi `Mail.Send` ai suoi scope e clicca su **Save Changes**. Chi si è già collegato mantiene l'accesso precedente finché non si collega di nuovo.

> [!NOTE]
>
> Questa pagina è stata tradotta con l'AI. Per le informazioni più accurate e aggiornate, consulta la [versione inglese](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.