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

> ## Agent Instructions
> Documentazione di Gestione Sala. Il testo completo, incluso il riferimento API, è in https://docs.gestionesala.com/llms-full.txt. Per endpoint, campi e codici di errore la fonte di verità è openapi.yaml: non usare endpoint o campi non documentati.

# Automazioni

> Regole automatiche attivate da un evento in sala: eventi, passi e azioni.

Un'automazione parte da un **evento** e, attraverso attese e condizioni, arriva a una o più **azioni**.

Ogni locale nuovo parte con **7 automazioni già pronte, in bozza**. L'interruttore sulla riga le accende o le spegne senza aprire l'editor. Trigger e azioni si scelgono dal catalogo.

## Eventi (trigger)

| Gruppo       | Eventi                                                                               |
| ------------ | ------------------------------------------------------------------------------------ |
| Prenotazione | Creata, Confermata, Modificata, Cancellata, Ospite in ritardo, Mancata presentazione |
| Servizio     | Ospite arrivato, Ospite seduto, Tavolo liberato, Pasto concluso                      |
| Coda clienti | Cliente in coda, Si libera un tavolo adatto                                          |

## Passi e azioni

| Passo                                  | Cosa fa                                                             |
| -------------------------------------- | ------------------------------------------------------------------- |
| **Attendi**                            | Aspetta prima del passo successivo                                  |
| **Condizione**                         | Divide il flusso in sì / no                                         |
| **Avvisa SQUADD**                      | Manda il fatto a SQUADD, che decide cosa scrivere all'ospite e come |
| **Scrivi sulla scheda ospite**         | Aggiorna un campo della scheda                                      |
| **Aggiungi tag di servizio**           | Etichetta l'ospite                                                  |
| **Cambia lo stato della prenotazione** | Porta la prenotazione in un altro stato                             |
| **Libera il tavolo**                   | Rende il tavolo di nuovo disponibile                                |
| **Richiama un cliente in coda**        | Contatta il primo idoneo della coda clienti                         |
| **Avvisa il maitre**                   | Lascia un avviso di sala in Sala e in Home                          |

<Note>
  Non esiste un'azione "manda un SMS": i messaggi all'ospite partono sempre da SQUADD. L'app decide **quando e perché**, SQUADD decide **cosa dire e come**.
</Note>

## Consegna verso SQUADD

Ogni fatto mandato a SQUADD porta una **chiave di idempotenza** che resta la stessa per tutti i tentativi: chi riceve lo riconosce anche se arriva più volte. Una consegna che esaurisce i tentativi resta nella **coda di scarto**, perché qualcuno veda cosa non è arrivato.

## Con l'Assistente IA

Dentro Automazioni l'[Assistente IA](/guida/assistente-ia) lavora con i soli attrezzi delle automazioni: crea, modifica, elimina e descrive un'automazione.