> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trellistech.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Automazioni
> Automatizzi le parti ripetitive della gestione immobiliare - messaggi, creazione attività, escalation e altro
## Smetta di fare le stesse cose più e più volte
Ogni property manager ha attività che ripete decine di volte a settimana: inviare istruzioni per il check-in, creare attività di pulizia dopo il checkout, notificare il team di un problema. Le automazioni gestiscono tutto questo per Lei - in modo affidabile, ogni singola volta.
***
## Cosa può automatizzare?
Invii istruzioni per il check-in, promemoria per il checkout, richieste di recensione e follow-up - automaticamente programmati per ogni prenotazione.
Crei [attività](/it/platform/tasks) specifiche per dipartimento quando si verificano eventi specifici - come il checkout di un ospite o una nuova prenotazione.
Notifichi immediatamente i manager quando qualcosa necessita dell'attenzione umana - un reclamo, una richiesta di rimborso o una conversazione che l'AI non è in grado di gestire.
Invii riepiloghi programmati di prenotazioni, escalation e attività che richiedono l'attenzione del team.
Avvisi il Suo team quando vengono assegnate attività, le conversazioni vengono escalate o arrivano problemi urgenti.
Aggiorni automaticamente record, modifichi stati o aggiunga tag alle conversazioni in base a condizioni da Lei definite.
***
## Come funzionano le automazioni
Ogni automazione è composta da tre parti: un **trigger** (cosa la avvia), **condizioni** opzionali (quando deve attivarsi) e **azioni** (cosa fa).
### Trigger - cosa avvia l'automazione
L'automazione si attiva quando succede qualcosa in Trellis:
* Viene creata una nuova prenotazione
* Un ospite effettua il check-in o il check-out
* Una conversazione viene escalata
* Un'attività viene completata
* Arriva un nuovo messaggio
Questo è il tipo più comune. Ad esempio: "Quando un ospite effettua il checkout, crea un'attività di pulizia."
L'automazione si attiva secondo una programmazione ricorrente:
* Ogni mattina alle 8:00
* Ogni lunedì alle 9:00
* Il primo di ogni mese
Ideale per cose come riepiloghi giornalieri delle attività, turni del team, promemoria dei codici di accesso o follow-up periodici.
Le automazioni programmate richiedono un **fuso orario** nella configurazione del trigger. Se la tua automazione utilizza valori di data o ora (come la data odierna, l'ora corrente o date relative come domani), Trellis mostrerà un errore al salvataggio se non è impostato un fuso orario. Questo garantisce che date e orari vengano sempre calcolati correttamente per la tua posizione.
L'automazione viene avviata manualmente dall'interfaccia di Trellis. Utile per flussi di lavoro che servono occasionalmente ma non automaticamente - come l'invio in blocco di un messaggio stagionale a tutti gli ospiti in arrivo.
### Condizioni - quando deve attivarsi
Aggiunga condizioni per rendere le Sue automazioni più intelligenti. Ad esempio:
* Creare un'attività di pulizia solo se il checkout riguarda una proprietà specifica
* Inviare un messaggio di check-in solo se la prenotazione è confermata (non cancellata)
* Escalare solo se l'ospite ha menzionato una parola chiave specifica
Le condizioni Le permettono di creare un'unica automazione che gestisce diversi scenari in modo intelligente.
### Azioni - cosa fa
Le azioni sono i passaggi che la Sua automazione esegue. Può concatenare più azioni insieme:
| Azione | Cosa fa |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Invia un messaggio** | Invia un messaggio basato su template a un ospite, proprietario o fornitore attraverso qualsiasi canale |
| **Crea un'attività** | Crea un'attività specifica per dipartimento con tutti i dettagli precompilati |
| **Aggiorna un record** | Modifica lo stato, l'assegnatario o qualsiasi campo di una proprietà, prenotazione, attività o conversazione |
| **Notifica il team** | Invia una notifica a specifici membri del team o ruoli |
| **Attendi** | Mette in pausa l'automazione per un tempo stabilito, fino a una data specifica o fino a quando succede qualcosa |
| **Richiedi approvazione** | Mette in pausa e chiede a un manager di revisionare prima di continuare - perfetto per azioni ad alto impatto |
| **Esegui l'agente AI** | Fa sì che l'[agente AI](/it/platform/ai-agent) analizzi una situazione, rediga una risposta o prenda una decisione |
Quando aggiunge un passaggio **agente AI** con output strutturato, Trellis valida la Sua configurazione prima di salvare. Verifica che i valori di timeout siano sufficientemente lunghi, che il contesto referenziato sia disponibile e che le variabili di ciclo vengano utilizzate solo all'interno dei cicli. Corregga eventuali avvisi per evitare errori imprevisti in fase di esecuzione.
***
## Approvazione con intervento umano
Alcune automazioni non dovrebbero funzionare completamente in automatico. Il passaggio di **approvazione** mette in pausa il flusso di lavoro e chiede a un membro del team di revisionare prima di continuare.
Il flusso di lavoro si mette in pausa e crea una richiesta di approvazione visibile nella Sua [posta in arrivo](/it/platform/inbox).
Il revisore assegnato riceve una notifica con tutto il contesto necessario per prendere una decisione.
Il revisore approva l'azione (e l'automazione continua) oppure la rifiuta (e l'automazione si ferma o segue un percorso alternativo).
**Quando utilizzare le approvazioni:**
* Prima di inviare messaggi su argomenti sensibili (rimborsi, modifiche alle policy)
* Prima di creare attività di manutenzione costose
* Prima di inviare messaggi che includono dati finanziari sensibili
* Ogni volta che si desidera un punto di controllo umano in un flusso altrimenti automatico
***
## Iniziare con i template
Non è necessario creare le automazioni da zero. Trellis include template predefiniti per i flussi di lavoro più comuni nella gestione immobiliare:
**Trigger:** 24 ore prima del check-in
**Azione:** Invia all'ospite le istruzioni per il check-in, inclusi indirizzo della proprietà, codice della porta, password Wi-Fi, informazioni sul parcheggio e regole della casa. I dettagli della proprietà vengono inseriti automaticamente.
**Trigger:** L'ospite effettua il checkout
**Azione:** Crea un'attività di pulizia per la proprietà, la assegna al membro del team di pulizia predefinito, allega la checklist standard di turnover e imposta la data di scadenza allo stesso giorno.
**Trigger:** La conversazione viene escalata (dall'AI o manualmente)
**Azione:** Invia una notifica immediata al manager di turno con il riepilogo della conversazione, i dettagli dell'ospite e un link alla conversazione.
**Trigger:** Ogni mattina
**Azione:** Invii al team un riepilogo di prenotazioni, escalation aperte e attività che richiedono attenzione quel giorno.
**Trigger:** 1 giorno dopo il checkout
**Azione:** Invia all'ospite un messaggio amichevole ringraziandolo per il soggiorno e chiedendogli di lasciare una recensione. Invia solo se non sono stati escalati problemi durante il soggiorno.
**Trigger:** L'AI rileva un problema di manutenzione in un messaggio dell'ospite
**Azione:** Crea un'attività di manutenzione, la assegna al tecnico di manutenzione reperibile e notifica il property manager.
***
## Creare la propria automazione
Il builder delle automazioni utilizza un canvas visuale dove può vedere l'intero flusso di lavoro a colpo d'occhio. Una barra laterale comprimibile sulla sinistra Le consente di alternare tra l'elenco dei flussi e il canvas, dandoLe più spazio quando ne ha bisogno.
Navighi su **Automazioni** nella barra laterale sinistra e clicchi su **Nuova automazione**.
Selezioni cosa avvia l'automazione - un evento (come un checkout), una programmazione (come ogni lunedì) o l'attivazione manuale. Clicchi sul nodo trigger nel canvas per configurarlo nel pannello dei dettagli.
Specifichi quando l'automazione deve attivarsi. Ad esempio, solo per proprietà specifiche, fonti di prenotazione o tipi di ospiti.
Definisca cosa deve fare l'automazione. Aggiunga tutti i passaggi necessari - inviare un messaggio, creare un'attività, attendere, notificare e altro. Clicchi su qualsiasi passaggio nel canvas per aprire il pannello dei dettagli e configurarlo. I passaggi vengono eseguiti in ordine.
Quando è pronto, clicchi su **Esegui ora** per eseguire l'automazione immediatamente, oppure la attivi per l'esecuzione automatica. Utilizzi le schede **Builder**, **Esecuzioni** e **Versioni** in alto per alternare tra progettazione, monitoraggio e revisione delle versioni precedenti dell'automazione.
Trellis valida il flusso di lavoro quando lo salva. Se un passaggio di condizione o trasformazione fa riferimento a un input non dichiarato, o se un'automazione programmata utilizza valori di data e ora senza un fuso orario configurato, vedrà immediatamente un errore - così potrà correggere il problema prima che il flusso di lavoro venga eseguito.
Testi sempre una nuova automazione con una singola proprietà o prenotazione prima di distribuirla a tutto il Suo portafoglio. Questo La aiuta a individuare eventuali problemi prima che influenzino gli ospiti.
***
## Monitoraggio delle esecuzioni
Dopo l'esecuzione di un'automazione, può rivedere esattamente cosa è successo dalla scheda **Esecuzioni**. Ogni esecuzione mostra il suo stato, i passaggi completati e gli eventuali errori verificatisi.
### Viste elenco e calendario
La scheda esecuzioni offre due modi per visualizzare la cronologia delle automazioni:
* **Vista elenco** - la tabella predefinita che mostra ogni esecuzione come una riga con stato, avanzamento dei passaggi, tipo di trigger e timestamp. L'elenco mostra per impostazione predefinita le esecuzioni degli ultimi 7 giorni in modo da visualizzare prima l'attività recente. Regoli l'intervallo di date in qualsiasi momento utilizzando il calendario inline. Ideale per scansionare l'attività recente e filtrare per stato.
* **Vista calendario** - un calendario mensile che posiziona le esecuzioni per data. Passi a questa vista utilizzando il selettore nella parte superiore dell'elenco esecuzioni. Utilizzi le frecce sinistra e destra per navigare tra i mesi e clicchi su qualsiasi giorno per vedere le esecuzioni di quella data.
La vista calendario è particolarmente utile per le automazioni programmate. A colpo d'occhio può confermare che i flussi giornalieri o settimanali vengono eseguiti nei giorni previsti - e individuare eventuali lacune dove un'esecuzione è stata saltata.
### Filtraggio delle esecuzioni
Utilizzi le opzioni di filtro nella parte superiore dell'elenco esecuzioni per trovare rapidamente esecuzioni specifiche. I filtri si applicano sia alla vista elenco che a quella calendario:
* **Stato** - filtri per esecuzioni in coda, in corso, completate, fallite o cancellate utilizzando le schede di stato
* **Intervallo di date** - selezioni una data di inizio e fine utilizzando il calendario inline. Per impostazione predefinita vengono mostrate le esecuzioni degli ultimi 7 giorni.
* **Tipo di trigger** - mostri solo le esecuzioni avviate da un trigger specifico (evento, programmazione o manuale)
* **Esecuzione di prova** - mostri o nasconda le esecuzioni di test (contrassegnate con un'icona a beuta) per concentrarsi sulle esecuzioni reali o rivedere i risultati dei test separatamente
### Dettagli dell'esecuzione
Clicchi su qualsiasi esecuzione per vedere un dettaglio passo-passo sul canvas. Ogni passaggio mostra se è riuscito, fallito o è stato saltato, insieme al suo output. Una colonna **Avanzamento passaggi** nell'elenco esecuzioni fornisce un rapido riepilogo visivo di quanto è avanzata ogni esecuzione prima del completamento o dell'errore.
Un pannello laterale si apre accanto al canvas per permetterLe di esaminare ogni passaggio senza perdere di vista l'intero flusso di lavoro.
#### Riepiloghi dei passaggi
Clicchi su un passaggio nel canvas per aprire il suo riepilogo nel pannello laterale. Ogni tipo di passaggio mostra informazioni specifiche:
* **Passaggi trigger** - mostrano il tipo di trigger (manuale, basato su evento, avviato dall'AI o programmato) e l'evento che ha avviato l'esecuzione
* **Passaggi condizione** - indicano se la condizione è stata valutata come vera o falsa con un badge chiaro
* **Passaggi azione** - elencano le entità interessate dal passaggio, come prenotazioni, attività, proprietà o contatti
* **Passaggi ciclo** - mostrano le entità in fase di iterazione e quanti elementi sono stati elaborati
#### Entità correlate
Quando un passaggio coinvolge prenotazioni, attività, proprietà o contatti, il pannello laterale mostra righe cliccabili con i dettagli principali a colpo d'occhio - ad esempio, una riga prenotazione mostra il nome dell'ospite e le date di check-in/check-out. Clicchi su qualsiasi riga per passare direttamente a quel record in Trellis.
#### Scheda Dettagli
Passi alla scheda **Dettagli** nel pannello laterale per vedere informazioni di esecuzione più approfondite per qualsiasi passaggio. Per i passaggi che utilizzano l'agente AI, questa scheda include tempi di risposta e una timeline in linguaggio chiaro di ciò che l'agente ha fatto. Un registro di esecuzione a livello di run in basso mostra ogni passaggio in ordine cronologico, rendendo facile rivedere l'intera sequenza degli eventi.
### Pannello laterale dei dettagli dell'esecuzione
Quando visualizza un'esecuzione, un pannello laterale si apre accanto al canvas. Le fornisce un quadro completo di ciò che è accaduto senza lasciare la pagina.
**Scheda Riepilogo**
La scheda Riepilogo mostra a colpo d'occhio cosa ha toccato l'automazione:
* **Righe entità** - prenotazioni, attività, proprietà e contatti coinvolti nell'esecuzione sono elencati come righe cliccabili. Ogni riga mostra dettagli chiave (come nome dell'ospite, date di check-in e check-out per una prenotazione, o titolo e stato dell'attività) per identificare rapidamente i record interessati e cliccare per vedere di più.
* **Riepilogo trigger** - veda cosa ha avviato l'esecuzione: un trigger manuale, un'esecuzione programmata, un trigger basato su evento o un'azione avviata dall'AI.
* **Risultati passo-passo** - ogni passaggio mostra il suo badge tipo, nome, durata e risultato. I passaggi condizione indicano se sono stati valutati come veri o falsi. I passaggi ciclo elencano le entità su cui hanno iterato.
**Scheda Dettagli**
La scheda Dettagli fornisce informazioni di revisione più approfondite per ogni passaggio:
* **Registro di esecuzione** - un elenco cronologico di ogni passaggio nell'esecuzione, con timestamp e durate, per vedere l'ordine esatto di esecuzione.
* **Tempi del passaggio** - per i passaggi basati sull'AI, il pannello laterale mostra tempi di risposta e dettagli di stato. Questo La aiuta a capire dove viene speso il tempo e se un passaggio richiede modifiche.
I dettagli del passaggio vengono caricati su richiesta - vengono recuperati solo quando espande un passaggio nella scheda Dettagli, mantenendo il pannello laterale veloce anche per esecuzioni con molti passaggi.
### Risoluzione degli errori nei passaggi
Quando un passaggio fallisce, Trellis mostra i dettagli dell'errore direttamente sul canvas. Due azioni sono disponibili per ogni passaggio fallito per aiutarLa a risolvere il problema rapidamente:
* **Chiedi all'AI di correggere** - Trellis analizza l'errore, spiega cosa è andato storto in linguaggio semplice e suggerisce una correzione. In molti casi può applicare la correzione automaticamente, così può rieseguire l'automazione senza approfondire i dettagli.
* **Segnala problema** - Se l'errore sembra un bug o qualcosa che non può risolvere da solo, clicchi per aprire un dialogo di feedback precompilato come segnalazione di bug con i dettagli dell'errore già allegati. Lo invii direttamente al team di supporto Trellis - senza bisogno di copiare messaggi di errore o descrivere manualmente cosa è andato storto.
Provi prima **Chiedi all'AI di correggere** - risolve istantaneamente la maggior parte dei problemi di configurazione, come un riferimento a un campo mancante o una condizione errata. Utilizzi **Segnala problema** quando l'errore è al di fuori del Suo controllo o continua a ripresentarsi dopo una correzione.
### Notifiche di errore delle esecuzioni
Quando l'esecuzione di un'automazione fallisce, Trellis notifica automaticamente tutti i membri del workspace affinché il Suo team possa reagire rapidamente. Le notifiche di errore appaiono nella **campanella delle notifiche** nella barra di navigazione superiore.
Clicchi su una notifica di errore per passare direttamente alla vista dettagli dell'esecuzione fallita, dove può vedere esattamente quale passaggio è fallito e utilizzare gli strumenti di risoluzione descritti sopra.
Le notifiche di errore vengono inviate a tutti i membri del workspace. Non è necessario configurare nulla - sono abilitate automaticamente per ogni automazione.
***
## Cancellazione di un'automazione in esecuzione
Se un'automazione è attualmente in esecuzione e deve interromperla - ad esempio, se è stata attivata per errore o le condizioni sono cambiate - può cancellarla direttamente dalla vista dettagli dell'esecuzione. Clicchi il pulsante **Cancella** nell'intestazione dell'esecuzione. Appare un dialogo di conferma per assicurarsi che intendeva interrompere l'esecuzione. Una volta cancellata, l'esecuzione viene contrassegnata con stato cancellato e nessun passaggio ulteriore viene eseguito.
***
## Gestione in blocco delle automazioni
Selezioni più automazioni dall'elenco per abilitarle, disabilitarle o eliminarle in un unico passaggio. Utile quando ha bisogno di mettere in pausa tutte le automazioni per una stagione, pulire vecchi flussi di lavoro o attivare rapidamente un set di automazioni per un nuovo gruppo di proprietà.
***
## Consigli per automazioni efficaci
I template sono collaudati e coprono i flussi di lavoro più comuni. Li personalizzi per adattarli alla Sua operatività piuttosto che costruire da zero.
I messaggi su rimborsi, modifiche alle policy o dati finanziari dovrebbero sempre avere un passaggio di revisione umana.
Più specifiche sono le Sue condizioni, più intelligenti diventano le Sue automazioni. Un'automazione di pulizia al checkout che si attiva solo per soggiorni confermati evita attività non necessarie per le cancellazioni.
Controlli la cronologia delle esecuzioni per assicurarsi che le automazioni funzionino come previsto. Cerchi esecuzioni saltate o errori che necessitano di attenzione.
Esegua l'automazione in modalità test prima di attivarla. Le esecuzioni di prova sono chiaramente contrassegnate con un'icona a beuta per distinguerle dalle esecuzioni reali.
Utilizzi i filtri di stato, data e tipo di trigger nella scheda Esecuzioni per restringere rapidamente le esecuzioni fallite o impreviste.