# Calendario

La sezione Calendario è l'area di Aurora in cui puoi consultare gli appuntamenti già presenti nella piattaforma e gestire la disponibilità operativa degli agenti. In un sistema orientato soprattutto alle chiamate inbound e outbound, questa pagina ha un ruolo pratico molto importante perché ti permette di leggere il tempo in cui l'operatività si distribuisce, verificare gli impegni registrati e mantenere coerenti le finestre di disponibilità.

Non si tratta quindi soltanto di una vista agenda. Il calendario ti aiuta a capire quando sono previsti appuntamenti, quali agenti sono coinvolti, quali attività devono essere aggiornate e in quali fasce orarie un agente può essere considerato disponibile. Per questo motivo è una sezione utile sia in fase di controllo quotidiano sia quando devi intervenire su una configurazione già in uso.

### A cosa serve il calendario

La pagina calendario offre una rappresentazione visiva degli appuntamenti già presenti in Aurora. Questo ti consente di avere una lettura immediata della distribuzione delle attività nel tempo, senza dover consultare record isolati uno per uno.

Dal punto di vista operativo, la pagina è utile soprattutto per due motivi. Da una parte ti permette di controllare e aggiornare gli appuntamenti esistenti. Dall'altra ti consente di impostare gli orari di disponibilità degli agenti, cioè le finestre settimanali entro cui l'operatività può essere organizzata in modo più ordinato.

***

### Le viste disponibili

Il calendario mette a disposizione tre modalità di visualizzazione:

* `Giorno`
* `Settimana`
* `Mese`

La vista giorno è utile quando devi concentrarti sul dettaglio di una singola giornata e leggere con precisione la collocazione oraria degli appuntamenti. La vista settimana è particolarmente adatta al controllo operativo corrente, perché permette di valutare il carico distribuito sui sette giorni. La vista mese, invece, è più utile quando vuoi avere una lettura sintetica dell'insieme e capire rapidamente come si distribuiscono gli appuntamenti in un arco temporale più ampio.

Passare da una vista all'altra è utile perché non esiste una sola prospettiva valida per ogni esigenza. Nelle attività quotidiane conviene spesso alternare una vista più ampia, per orientarsi, e una vista più puntuale, per intervenire sui singoli appuntamenti.

***

### Navigazione nel tempo

Accanto alle viste, la pagina mette a disposizione comandi per:

* spostarti indietro
* tornare a oggi
* spostarti in avanti

Il comportamento cambia in base alla vista attiva. Se stai lavorando sulla vista giorno, la navigazione si muove di un giorno alla volta. Se sei in vista settimana, si sposta di una settimana per volta. In vista mese, invece, la navigazione avanza o arretra di un mese.

Questa logica rende la consultazione più naturale, perché il movimento temporale resta coerente con la scala con cui stai osservando il calendario.

***

### Consultazione degli appuntamenti

Gli appuntamenti vengono mostrati direttamente nella griglia del calendario. A seconda della vista selezionata, puoi leggere le informazioni in modo più o meno sintetico, ma in generale la piattaforma rende subito riconoscibili elementi come:

* orario
* titolo dell'appuntamento
* agente associato, quando presente
* eventuali informazioni sintetiche aggiuntive

Questa impostazione ti aiuta a capire a colpo d'occhio quali attività sono già programmate e quali richiedono attenzione. Quando hai bisogno di intervenire, puoi aprire il dettaglio dell'appuntamento direttamente dalla vista calendario.

### Modifica di un appuntamento

Aprendo un appuntamento, accedi a una finestra di dettaglio da cui puoi aggiornare le informazioni principali. Questa è la modalità da usare quando un'attività è già stata registrata e deve essere corretta, confermata o riallineata al contesto operativo.

<figure><img src="/files/4Bt2AdZI0JISXsaONMJP" alt=""><figcaption></figcaption></figure>

Nel dettaglio dell'appuntamento puoi intervenire su diversi campi, in modo da mantenere allineate le informazioni presenti in agenda con la situazione reale.

#### Titolo

Il titolo è il riferimento principale con cui l'appuntamento viene riconosciuto nella griglia. Conviene mantenerlo chiaro e descrittivo, così da rendere immediata la lettura anche quando il calendario contiene molte attività.

#### Descrizione

La descrizione ti permette di aggiungere un contesto più completo. È utile quando il titolo da solo non basta a spiegare il contenuto dell'appuntamento oppure quando vuoi lasciare una nota operativa che aiuti chi consulterà la voce in un secondo momento.

#### Data e ora di inizio

Questo campo definisce il momento in cui l'appuntamento deve cominciare. Va controllato con attenzione perché incide direttamente sul posizionamento dell'evento nella griglia del calendario.

#### Data e ora di fine

Definisce il termine dell'appuntamento. È importante che sia coerente con l'orario di inizio, perché la piattaforma si aspetta una durata valida e ordinata.

#### Tipo

Il tipo aiuta a classificare la natura dell'appuntamento. Puoi incontrare categorie come chiamata, incontro, follow-up o altro. Questa distinzione è utile per leggere più facilmente il contesto dell'attività e per mantenere più ordinato il calendario.&#x20;

#### Stato

Lo stato ti permette di rappresentare la situazione attuale dell'appuntamento. In base alla configurazione disponibile, puoi trovare stati come programmato, confermato, completato o annullato. Questo campo è particolarmente utile perché non descrive solo quando avviene un'attività, ma anche in quale fase operativa si trova.

#### Colore

Il colore ha una funzione visiva. Non cambia il contenuto dell'appuntamento, ma aiuta a distinguerlo più rapidamente nella griglia, soprattutto quando il calendario inizia a diventare più denso.

#### Agente

Se necessario, puoi associare o cambiare l'agente collegato all'appuntamento. Questa informazione è importante perché collega l'attività al soggetto operativo che dovrà gestirla o che ne è responsabile.

***

### Informazioni aggiuntive dell'appuntamento

Nel dettaglio possono comparire anche alcune informazioni in sola lettura, come il cliente collegato o il provider da cui l'evento proviene. Quando presenti, questi dati sono utili per dare contesto senza trasformare la finestra in una schermata tecnica.

Se la piattaforma segnala un avviso di sincronizzazione, conviene leggerlo con attenzione. Significa che l'appuntamento può avere una relazione con un calendario esterno o con un processo di aggiornamento che richiede verifica.

***

### Eliminazione di un appuntamento

Se un appuntamento non è più necessario, puoi eliminarlo dalla finestra di dettaglio. Prima della rimozione, la piattaforma richiede una conferma. Questo passaggio è importante perché evita cancellazioni accidentali su attività già inserite nel flusso operativo.

Dal punto di vista pratico, conviene usare l'eliminazione solo quando sei certo che l'appuntamento non debba più rimanere tracciato nel calendario. Se il dubbio riguarda solo la sua validità attuale, in molti casi è più corretto aggiornare lo stato invece di cancellarlo.

***

### Orari

Uno degli strumenti più importanti di questa pagina è la gestione delle disponibilità. Attraverso il comando dedicato agli orari, puoi aprire una finestra in cui definire quando un agente è disponibile durante la settimana.

Questa funzione è particolarmente utile perché separa due concetti che spesso vengono confusi: un conto è l'appuntamento già presente in agenda, un conto è la disponibilità generale dell'agente. La disponibilità non rappresenta un impegno già fissato, ma il perimetro temporale entro cui l'operatività può essere organizzata con più coerenza.

### Come funziona la disponibilità

All'interno della finestra dedicata, puoi selezionare l'agente su cui vuoi intervenire e configurare la settimana giorno per giorno. Per ogni giorno puoi:

* aggiungere una o più fasce orarie
* espandere o comprimere il dettaglio della giornata
* rimuovere una fascia oraria
* lasciare il giorno senza disponibilità

<figure><img src="/files/8UI1dBmygeViOgLjozbz" alt=""><figcaption></figcaption></figure>

Questo approccio è utile perché consente di rappresentare sia agende semplici sia situazioni più articolate. Un agente può essere disponibile con una sola finestra continua, ma anche con più slot separati nella stessa giornata.

### Copia rapida delle fasce orarie

Per velocizzare la configurazione, la piattaforma permette anche di copiare le fasce impostate in un giorno verso altri giorni della settimana.

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

Puoi:

* copiare il giorno selezionato a tutti i giorni feriali
* copiare il giorno selezionato a tutti i giorni
* cancellare tutte le fasce orarie configurate

Queste azioni sono molto utili quando la disponibilità segue uno schema regolare. Invece di ripetere manualmente la stessa configurazione più volte, puoi partire da un giorno già corretto e replicarlo dove serve.

***

### Controlli e validazioni della disponibilità

La piattaforma controlla che le fasce orarie inserite siano coerenti. In pratica, una fascia deve avere un orario di inizio valido, un orario di fine valido e una sequenza temporale corretta. Inoltre, le fasce dello stesso giorno non devono sovrapporsi.

Questo controllo è importante perché evita configurazioni ambigue, poco leggibili o difficili da gestire operativamente. Se un intervallo non è corretto, conviene sistemarlo subito prima del salvataggio, così da mantenere una struttura settimanale pulita e affidabile.

***

### Salvataggio della disponibilità

Una volta completata la configurazione, puoi salvare gli orari dell'agente. Il salvataggio aggiorna la disponibilità settimanale associata a quell'agente nella piattaforma.

Dal punto di vista organizzativo, è consigliabile rivedere la disponibilità ogni volta che cambiano turni, regole operative o modalità di gestione degli appuntamenti. Mantenere questa informazione aggiornata rende più ordinato l'uso dell'intero sistema.

***

### Relazione con le integrazioni di calendario

Nel calendario puoi incontrare informazioni collegate a provider esterni o avvisi di sincronizzazione. Quando il tuo lavoro richiede il collegamento con un calendario esterno, la sezione da consultare è [integrazioni](/funzionalita-operative/integrations.md), dove puoi gestire il collegamento con Google Calendar, scegliere il calendario predefinito e avviare la sincronizzazione.

Questo significa che la pagina Calendario è il luogo in cui consulti e gestisci il risultato operativo, mentre la sezione Integrazioni è il punto in cui configuri il collegamento con i servizi esterni.

***

### Un metodo consigliato di utilizzo

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

1. usa la vista mese o settimana per orientarti
2. passa alla vista giorno quando hai bisogno di maggiore precisione
3. apri il dettaglio degli appuntamenti solo quando devi davvero correggere o aggiornare informazioni
4. mantieni ordinati tipo, stato e titolo per rendere il calendario più leggibile
5. configura con attenzione la disponibilità degli agenti, soprattutto se l'operatività segue orari ricorrenti

Questo approccio rende il calendario più leggibile e riduce il rischio di lavorare in modo disordinato su appuntamenti e disponibilità.

***

### Errori comuni da evitare

I casi più frequenti in questa sezione sono:

* usare titoli poco chiari che rendono difficile leggere il calendario
* modificare date e orari senza controllarne la coerenza
* confondere gli appuntamenti già fissati con la disponibilità generale dell'agente
* lasciare fasce orarie sovrapposte nella disponibilità
* non aggiornare la disponibilità quando cambiano turni o regole operative

### Serve supporto?

Se riscontri problemi di accesso alla sezione, anomalie nella visualizzazione degli appuntamenti o dubbi operativi sulla configurazione della disponibilità, 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/calendar.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.
