import { Steps } from '@astrojs/starlight/components';
import Figure from '@/components/Figure.astro';

**Per chi è:** qualsiasi attività che fissa appuntamenti con i clienti — visite, chiamate, dimostrazioni —
e vuole che il proprio agente IA li offra e li confermi senza che nessuno del team debba guardare un
calendario.

## Cosa vede il cliente finale

Quando il cliente chiede un appuntamento durante una conversazione su WhatsApp, Telegram o la chat web,
l'agente consulta lo stesso motore di slot che usa il tuo team quando crea un appuntamento a mano e offre
solo orari **reali**, mai inventati. L'IA non rivela mai il contenuto della tua agenda — non dice quali
appuntamenti ci sono né con chi — negozia solo slot liberi. Se il cliente conferma uno slot, l'IA
**prenota l'appuntamento direttamente**, senza che nessuno del tuo team debba intervenire.

## Passaggi nel prodotto

<Steps>

1. **Configura l'orario lavorativo e i parametri della tua agenda** (durata dello slot, margine tra
   appuntamenti, preavviso minimo e giorni massimi verso il futuro) da Impostazioni — li definisce il tuo
   amministratore e influenzano tutti gli slot offerti, sia a mano sia dall'IA.
2. **Ogni persona collega il proprio calendario, se vuole.** Da **Impostazioni → Il mio calendario**,
   chiunque può scegliere tra tre provider: il calendario della piattaforma stessa (nessun servizio
   esterno), **Google Calendar** (usa la tua occupazione reale e rispecchia i tuoi appuntamenti) o un
   server MCP (disabilitato oggi, l'infrastruttura necessaria non è ancora disponibile).

   <Figure
     src="/captures/agenda-lista.png"
     alt="Schermata Agenda con i filtri per dipendente e stato, il selettore Lista/Settimana, il navigatore delle date, il pulsante + Nuovo appuntamento, e la tabella appuntamenti con le colonne Appuntamento, Dipendente, Data e ora, Stato, Origine e Azioni"
     caption="La colonna Origine distingue gli appuntamenti creati a mano (Manuale) da quelli prenotati dall'IA da sola durante una conversazione."
   />

3. **Collega Google Calendar, se lo usi.** Scegli il provider Google Calendar e concedi il consenso —
   chiede solo la tua disponibilità libero/occupato e il permesso di gestire gli eventi che crea la
   piattaforma stessa, nient'altro dal tuo calendario. Ogni appuntamento che ti viene assegnato viene
   creato anche lì, e aggiornato o annullato allo stesso modo se cambia sulla piattaforma.
4. **Un cliente chiede un appuntamento in una conversazione.** L'agente controlla l'orario lavorativo, i
   parametri, la tua disponibilità personale e la tua occupazione reale su Google Calendar (se collegato),
   e offre solo slot davvero liberi.
5. **Il cliente conferma uno slot e l'IA prenota direttamente.** L'appuntamento compare nella schermata
   Agenda con origine **IA** e stato **Programmato**, assegnato al dipendente corrispondente — senza che
   nessuno del tuo team debba fare nulla.
6. **Per creare un appuntamento a mano**, premi **"Nuovo appuntamento"**, scegli dipendente e data,
   seleziona uno degli slot disponibili calcolati dallo stesso motore, aggiungi titolo e tipo, e conferma.
7. **Cambia lo stato di un appuntamento** (Completato, Annullato o Non presentato) dalle sue icone di
   azione nella tabella, quando serve.

</Steps>

## Cosa configurare

- **Orario lavorativo e parametri dell'agenda**: li definisce il tuo amministratore, uguali per
  appuntamenti manuali e IA.
- **Calendario personale**: ogni dipendente sceglie il proprio provider (piattaforma o Google Calendar)
  dalle proprie Impostazioni.
- **Disponibilità personale**: facoltativa, giorno per giorno, sempre entro l'orario lavorativo
  dell'agenzia.

## Limiti e onestà

- Oggi esiste solo un'integrazione reale con **Google Calendar** — non c'è sincronizzazione con Microsoft
  Outlook/365 né con nessun altro calendario esterno.
- Il provider "Server MCP" per il calendario compare nel selettore ma è **disabilitato**:
  l'infrastruttura necessaria non è ancora disponibile.
- Con Google Calendar collegato, l'appuntamento si riflette nel calendario del dipendente a cui è
  **assegnato**, non in quello di chi lo ha creato — se assegni un appuntamento a qualcuno senza Google
  collegato, l'appuntamento esiste normalmente sulla piattaforma ma non compare in nessun Google Calendar.
- Non sono ammessi appuntamenti sovrapposti: il selettore di slot offre solo orari davvero liberi.

## Vedi anche

- **[Agenda e appuntamenti](/it/guides/agenda/)** — il dettaglio completo di viste, stati e calcolo degli
  slot.
- **[Conversazioni](/it/guides/conversaciones/)** — dove trovare la conversazione da cui è stato prenotato
  un appuntamento.
- **[Ticket e follow-up interno](/it/use-cases/tickets-seguimiento/)** — quando un appuntamento richiede
  anche un caso interno di follow-up.