# Integrazioni

La sezione Integrazioni è l'area di Aurora in cui puoi collegare servizi esterni alla piattaforma per rendere più fluido il lavoro operativo. Questa sezione è dedicata in particolare all'integrazione con Google Calendar.

Dal punto di vista pratico, questa pagina serve a collegare il calendario esterno al tuo ambiente Aurora, scegliere quale calendario usare come riferimento e gestire la sincronizzazione. È quindi una sezione importante soprattutto per chi lavora con appuntamenti, disponibilità e pianificazione delle attività.

***

### A cosa serve la sezione Integrazioni

Questa sezione non è pensata come una vetrina di servizi disponibili, ma come un punto operativo di configurazione. Il suo scopo è permetterti di mettere in comunicazione Aurora con strumenti esterni che possono influenzare il lavoro quotidiano.

Il focus è su Google Calendar. Questo significa che, se vuoi far dialogare appuntamenti e calendario esterno, questa è la pagina da usare per attivare e controllare il collegamento.

***

### Integrazione disponibile oggi

Attualmente la sezione mostra l'integrazione con:

* Google Calendar

Per l'utente, questo significa che la documentazione di questa pagina deve essere letta in modo molto concreto: non come una panoramica astratta delle integrazioni future, ma come una guida pratica su come usare oggi il collegamento con Google Calendar.

### Stato dell'integrazione

Per ogni integrazione disponibile, Aurora mostra chiaramente se il servizio è:

* collegato
* non collegato

Questa indicazione è importante perché ti permette di capire immediatamente se l'ambiente è già configurato o se richiede un'azione iniziale.

Nel caso di Google Calendar, lo stato è il primo elemento da controllare prima di intervenire su calendario predefinito o sincronizzazione.

<figure><img src="/files/rUeqGrKa7PV3kUtRpKKB" alt=""><figcaption></figcaption></figure>

### Collegare Google Calendar

Se Google Calendar non è ancora collegato, la piattaforma mostra un'azione dedicata per avviare il collegamento.

Dal punto di vista pratico, questo passaggio serve ad autorizzare Aurora a lavorare con il tuo ambiente Google Calendar. Una volta avviata l'operazione, verrai accompagnato nel flusso necessario per completare il collegamento.

Questo è il punto di partenza per tutte le altre funzioni della sezione. Finché l'integrazione non è attiva, infatti, non è possibile scegliere il calendario predefinito né usare la sincronizzazione.

***

### Calendario Google predefinito

Quando l'integrazione è attiva, Aurora mostra il calendario Google collegato e ti permette di scegliere quale calendario usare come riferimento predefinito.

Questa impostazione è molto importante perché stabilisce quale calendario deve essere considerato principale nel rapporto con Aurora. Se il tuo account Google contiene più calendari, questa scelta evita ambiguità e ti aiuta a mantenere il flusso operativo più ordinato.

La piattaforma mostra l'elenco dei calendari disponibili e consente di selezionarne uno come predefinito. Se non è ancora presente una scelta esplicita, Aurora può usare il calendario principale come riferimento iniziale.

***

### Quando conviene scegliere con attenzione il calendario predefinito

Questa scelta va fatta con particolare attenzione quando:

* usi più calendari nello stesso account Google
* vuoi separare attività personali e attività operative
* hai un calendario specifico dedicato agli appuntamenti gestiti tramite Aurora

In questi casi, scegliere il calendario corretto riduce il rischio di confusione e rende più pulita la gestione successiva degli appuntamenti.

***

### Sincronizzazione manuale

La sezione Integrazioni mette a disposizione anche un'azione per avviare una sincronizzazione manuale con Google Calendar.

Questa funzione è utile quando vuoi forzare un aggiornamento e verificare che Aurora e Google Calendar siano allineati. Dal punto di vista dell'utente, è uno strumento di controllo: non serve a configurare il collegamento iniziale, ma a mantenerlo coerente nel tempo.

Dopo la sincronizzazione, la piattaforma restituisce un riscontro sintetico sull'esito dell'operazione, ad esempio in termini di elementi creati, aggiornati o annullati.

***

### Scollegare Google Calendar

Se non vuoi più mantenere il collegamento con Google Calendar, puoi usare l'azione di disconnessione.

Prima di procedere, Aurora richiede una conferma. Questo passaggio è importante perché interrompere l'integrazione è una scelta che può avere conseguenze sulla continuità del flusso operativo legato agli appuntamenti.

Dal punto di vista pratico, conviene scollegare l'integrazione solo quando sei sicuro che non serva più oppure quando devi riconfigurare il collegamento in modo diverso.

***

### Relazione con la sezione Calendario

È importante distinguere bene il ruolo di questa pagina da quello della sezione Calendario.

La sezione Integrazioni serve a configurare il collegamento con Google Calendar. La sezione Calendario, invece, serve a consultare e gestire il risultato operativo di quel collegamento, insieme agli appuntamenti e alle disponibilità presenti in Aurora.

In altre parole:

* Integrazioni: configuri il collegamento
* Calendario: usi operativamente ciò che è collegato

Questa distinzione è utile perché aiuta l'utente a sapere subito dove intervenire in base al tipo di esigenza.

***

### Limiti legati al piano

La piattaforma può mostrare un messaggio che segnala la necessità di un piano idoneo per utilizzare la sezione Integrazioni.

Questo significa che, se il tuo account non ha ancora i requisiti necessari, alcune azioni come collegamento, modifica o sincronizzazione possono risultare non disponibili finché non viene attivato o aggiornato il piano corretto.

***

### Un metodo consigliato

Se stai iniziando a usare questa sezione, il metodo più efficace è questo:

1. verifica prima se Google Calendar è già collegato
2. se non lo è, completa il collegamento
3. controlla quale calendario è impostato come predefinito
4. se usi più calendari, seleziona quello davvero dedicato all'operatività di Aurora
5. usa la sincronizzazione manuale quando vuoi verificare l'allineamento

Questo approccio rende l'integrazione più ordinata e riduce il rischio di lavorare sul calendario sbagliato.

### Errori comuni da evitare

I casi più frequenti in questa sezione sono:

* collegare Google Calendar senza verificare poi il calendario predefinito
* usare un calendario personale invece di uno operativo
* aspettarsi che la sezione Integrazioni sostituisca la gestione pratica del calendario
* scollegare il servizio senza considerare l'impatto sugli appuntamenti
* ignorare eventuali limiti di piano che bloccano il collegamento

### Serve supporto?

Se riscontri problemi nel collegamento con Google Calendar, dubbi sulla scelta del calendario predefinito o anomalie nella sincronizzazione, puoi scrivere a `assistenza@aurorasuite.ai`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aurorasuite.ai/funzionalita-operative/integrations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
