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

# Gestire i workflow

> Attiva o disattiva i workflow e gli hook della tua app Base44, modificali, rinominali, eseguili e archiviali, rivedi ogni esecuzione e tieni sotto controllo il loro uso di crediti integrazione.

Dopo aver [creato un workflow](https://docs.base44.com/it/Building-your-app/Creating-workflows.md), lo gestisci dalla pagina **Workflows** nella dashboard della tua app. Attivalo o disattivalo, cambia cosa fa, eseguilo su richiesta, rivedi ogni esecuzione e tieni d'occhio i crediti che usa.

Gli [hook](https://docs.base44.com/it/Building-your-app/creating-hooks.md), i workflow che verificano le tue regole prima di un'azione nella tua app, funzionano allo stesso modo. Dove qualcosa è diverso per un hook, la sezione lo indica.

***

## Modificare un workflow

Dopo aver iniziato a usare i workflow, puoi controllare quando si eseguono, cambiare cosa fanno, rinominarli, attivarli su richiesta o fare pulizia di quelli che non ti servono più. Ogni workflow mostra uno stato **Active** o **Inactive**, e puoi disattivarne uno per metterlo in pausa e riattivarlo quando ti serve.

### Attivare o disattivare un workflow

Disattiva un workflow quando vuoi fermarne l'esecuzione e riattivalo quando ti serve. Disattivarlo impedisce l'avvio di nuove esecuzioni, ma la cronologia resta disponibile.

Disattivare un [hook](https://docs.base44.com/it/Building-your-app/creating-hooks.md) disattiva la sua regola, quindi l'azione che protegge procede senza alcun controllo finché non lo riattivi. Quando disattivi un hook, la tua app ti chiede di confermare: clicca **Deactivate** nella finestra.

**Per attivare o disattivare un workflow:**

1. Clicca **Dashboard** nell'editor dell'app.
2. Clicca **Workflows**.
3. Clicca l'icona **More actions**  sul workflow.
4. Clicca **Deactivate** o **Activate**.

Puoi anche aprire un workflow e usare il toggle **Active** nel pannello dei dettagli.

![Menu del workflow con l'opzione Deactivate evidenziata](https://mintcdn.com/base44/PZ7PRS_0Vw5N4HxF/images/deactivateworkflow.png?fit=max\&auto=format\&n=PZ7PRS_0Vw5N4HxF\&q=85\&s=942750c997392bee69281fafda0d77ab)

Disattivare un workflow dal menu More actions.

### Modificare i passi di un workflow

Per cambiare cosa fa un workflow, modificalo dal suo diagramma o semplicemente descrivi la modifica nella chat AI. Ogni opzione di modifica apre la chat AI con un prompt precompilato e l'AI applica la modifica per te, quindi non c'è niente da modificare a mano.

> [accordion] Modificare un passo
>
> Clicca l'icona **Edit** di un passo per cambiare cosa fa o sostituirlo con un passo diverso.
>
> ![Un workflow con un trigger schedulato e un'azione send daily reminders, con il menu di modifica aperto su Change what this step does e Replace this step](https://mintcdn.com/base44/I1QI0alPKQovwbjh/images/editing-a-step.png?fit=max\&auto=format\&n=I1QI0alPKQovwbjh\&q=85\&s=1ffb17c143ef9e8f24f56015cb89cf03)
>
> Modificare un passo.

> [accordion] Modificare il trigger
>
> * Clicca l'icona **Edit** del trigger per cambiare quali eventi attivano il workflow.
> * Clicca l'icona **Replace trigger** per passare a un trigger diverso, come un trigger schedulato, connector, in-app agent o entity.
>
> ![Il selettore dei trigger aperto accanto a un workflow, con le opzioni schedulate One time, Recurring e On an interval, poi connettori, agenti ed entity](https://mintcdn.com/base44/w9eKWfEl5T_oHhSR/images/edit-workflow-trigger.png?fit=max\&auto=format\&n=w9eKWfEl5T_oHhSR\&q=85\&s=a307584af41041059fd1771dbee4406d)
>
> Sostituire il trigger di un workflow.

> [accordion] Aggiungere un passo
>
> Clicca il pulsante di aggiunta sotto un passo, poi scegli **Action** o **Condition**.
>
> ![Il controllo più sotto un'azione del workflow, con un tooltip Add a step after this e un menu con Action o Condition](https://mintcdn.com/base44/I1QI0alPKQovwbjh/images/adding-a-step-workflow.png?fit=max\&auto=format\&n=I1QI0alPKQovwbjh\&q=85\&s=af4a3ab487ca56da3a2828ba72f87096)
>
> Aggiungere un passo a un workflow.

> [!NOTE]
>
> Modificare i passi di un workflow crea una nuova versione. Le esecuzioni già in corso finiscono con la versione con cui sono partite, e le nuove esecuzioni usano l'ultima versione.

### Rinominare un workflow

Dai a un workflow un nome più chiaro in qualsiasi momento. Rinominarlo non crea una nuova versione.

**Per rinominare un workflow:**

1. Clicca **Dashboard** nell'editor dell'app.
2. Clicca **Workflows**.
3. Clicca l'icona **More actions**  sul workflow.
4. Clicca **Rename** e inserisci il nuovo nome.

![L'elenco Workflows con 3 workflow attivi e un menu aperto sul primo, con Rename sopra Deactivate e Archive](https://mintcdn.com/base44/1snwrMHc8GN-cqaS/images/renameworkflow.png?fit=max\&auto=format\&n=1snwrMHc8GN-cqaS\&q=85\&s=ab9e40010d4ef4eb6a680e829bf6a764)

Rinominare un workflow dal menu More actions.

### Eseguire un workflow immediatamente

Esegui subito un workflow quando vuoi avviarlo su richiesta. Ti aiuta a testare le modifiche, confermare che la configurazione funziona o gestire qualcosa di urgente tra un'esecuzione schedulata e l'altra.

Per un hook, **Run now** lo testa invece con i dati di un'esecuzione precedente. [Scopri come funziona il test di un hook](https://docs.base44.com/it/Building-your-app/creating-hooks.md#testing-a-hook).

> [!WARNING]
>
> **Cosa fa Run now:**
>
> * Esegue azioni reali con la tua configurazione attuale, come inviare email reali o aggiornare record reali.
> * È un'esecuzione manuale una tantum che non influisce sulla schedulazione o sul trigger, e appare nella cronologia delle esecuzioni etichettata come test.
> * Quando esistono esecuzioni precedenti, puoi anche riprodurre il workflow usando i dati di un'esecuzione precedente.

**Per eseguire un workflow:**

1. Clicca **Dashboard** nell'editor dell'app.
2. Clicca **Workflows**.
3. Clicca il workflow per aprirlo.
4. Clicca **Run now** nel pannello dei dettagli.
5. Nella finestra di conferma, clicca di nuovo **Run now**.

![Pannello laterale del workflow con Run now evidenziato sopra la cronologia delle esecuzioni](https://mintcdn.com/base44/1snwrMHc8GN-cqaS/images/runnowworkflow.png?fit=max\&auto=format\&n=1snwrMHc8GN-cqaS\&q=85\&s=24b22abea53f715b43638bc84f42f3b7)

Eseguire un workflow su richiesta con Run now.

### Annullare un'esecuzione

Se un workflow è in esecuzione e devi fermarlo, puoi annullare l'esecuzione mentre è ancora in corso. L'esecuzione annullata compare come **Cancelled** nella cronologia.

**Per annullare un'esecuzione:**

1. Clicca **Dashboard** nell'editor dell'app.
2. Clicca **Workflows**.
3. Clicca il workflow per aprirlo.
4. Clicca l'esecuzione in corso, poi clicca **Cancel run**.

### Archiviare un workflow

Se non ti serve più un workflow, puoi archiviarlo per tenere pulita la lista attiva.

Archiviare un [hook](https://docs.base44.com/it/Building-your-app/creating-hooks.md) disattiva anche la sua regola, quindi la tua app ti chiede di confermare prima di archiviarlo.

**Per archiviare un workflow:**

1. Clicca **Dashboard** nell'editor dell'app.
2. Clicca **Workflows**.
3. Clicca l'icona **More actions**  sul workflow.
4. Clicca **Archive**.

![L'elenco Workflows con un menu aperto sul primo workflow e Archive evidenziato, sotto Rename e Deactivate](https://mintcdn.com/base44/NYgUQIX5TN3t0K3a/images/archiveworkflow.png?fit=max\&auto=format\&n=NYgUQIX5TN3t0K3a\&q=85\&s=01d21d2aae7bb866e3e5c70f70588a13)

Archiviare un workflow dal menu More actions.

> [!TIP]
>
> Per vedere o ripristinare i workflow archiviati, clicca l'icona **More actions**  accanto a **Create workflow**, poi clicca **View archive**.

***

## Monitorare le esecuzioni

Ogni workflow registra ogni esecuzione, così puoi osservarla in tempo reale e rivederla in seguito. Rivedi le esecuzioni di un singolo workflow dal suo pannello dei dettagli, o vedi le esecuzioni di tutti i workflow nella scheda **Activity**.

> [!TIP]
>
> Mentre un workflow si esegue, ogni passo nel diagramma mostra un segno di spunta verde quando si completa con successo, così puoi confermare a colpo d'occhio che funziona e vedere esattamente dove si ferma se un passo fallisce.

### Visualizzare le esecuzioni di un workflow

Quando apri un workflow, il pannello dei dettagli mostra **Success rate**, **Avg. runtime** e una **Run history** con ogni esecuzione. Quando qualcosa va storto, l'esecuzione mostra il passo esatto che è fallito e l'errore, così sai dove guardare senza indovinare.

Il pannello dei dettagli di un [hook](https://docs.base44.com/it/Building-your-app/creating-hooks.md) mostra solo la sua **Run history**. Quando apri una delle sue esecuzioni, mostra se l'hook ha consentito o bloccato l'azione. Un'esecuzione di hook non andata a buon fine conta come bloccata.

**Per visualizzare le esecuzioni di un workflow:**

1. Clicca **Dashboard** nell'editor dell'app.
2. Clicca **Workflows**.
3. Clicca il workflow che vuoi ispezionare.
4. Nel pannello dei dettagli, rivedi la **Run history**, dove ogni esecuzione mostra ora e stato, come **Completed**.
5. Clicca un'esecuzione per aprire il suo **Run log**, con ora di inizio, ora di fine e durata.

![Un'esecuzione completata del workflow mostrata in verde sul canvas, accanto a un pannello di log con descrizione, orari di inizio e fine e un tempo di esecuzione di 1,5 secondi](https://mintcdn.com/base44/2miaRY-R6HMQU8Ti/images/viewrunsworkflow.png?fit=max\&auto=format\&n=2miaRY-R6HMQU8Ti\&q=85\&s=cab18e8ee3074c3cccef1a83e80c84f7)

Il pannello dei dettagli di un workflow con la cronologia delle esecuzioni.

### Usare la scheda Activity

La scheda **Activity** sotto **Workflows** nella dashboard dell'app riunisce le esecuzioni di tutti i tuoi workflow in un unico posto. Le esecuzioni degli [hook](https://docs.base44.com/it/Building-your-app/creating-hooks.md) sono etichettate come hook.

> [!TIP]
>
> Le esecuzioni avviate con **Run now** sono etichettate **TEST**, così puoi distinguerle dalle esecuzioni partite automaticamente.

**Per vedere l'attività di tutti i workflow:**

1. Clicca **Dashboard** nell'editor dell'app.
2. Clicca **Workflows**.
3. Clicca la scheda **Activity**.
4. Rivedi la lista delle esecuzioni, dove ognuna mostra il workflow, lo stato, l'ora di avvio e la durata. Filtra per stato (**Running**, **Completed**, **Failed** o **Cancelled**) o per intervallo di tempo.
5. Clicca **View** su un'esecuzione per aprirla nel diagramma del workflow insieme al suo log.

![La scheda Activity con ricerca e filtri di stato sopra una tabella di 3 esecuzioni completate, ciascuna con stato, ora di inizio e tempo di esecuzione](https://mintcdn.com/base44/2miaRY-R6HMQU8Ti/images/workflowactivity.png?fit=max\&auto=format\&n=2miaRY-R6HMQU8Ti\&q=85\&s=f6e8b12bfc1065e10436ade1e0dd7c7f)

La scheda Activity, che mostra le esecuzioni di tutti i tuoi workflow.

***

## Workflow e crediti integrazione

I workflow vengono fatturati in base ai passi che si eseguono. Ogni passo eseguito usa crediti integrazione, circa [1 credito ogni 10 passaggi](https://docs.base44.com/it/Account-and-billing/Credits.md#workflow), e gli addebiti si sommano su tutti i passi di una singola esecuzione. Un passo che chiama una funzione backend usa anche crediti per l'esecuzione di quella funzione, circa [1 credito ogni 100 esecuzioni](https://docs.base44.com/it/Account-and-billing/Credits.md#funzioni-backend). Anche le integrazioni integrate che un passo usa, come inviare un'email o chiamare un modello AI, possono usare crediti, come nel resto della tua app.

Un workflow con più passi costa quindi di più per esecuzione rispetto a uno con un solo passo, quindi tieni d'occhio quanto spesso si eseguono i tuoi workflow e cosa fa ogni passo. Se finisci i crediti integrazione mentre un'esecuzione è in corso, quell'esecuzione viene annullata. [Scopri di più sui crediti.](https://docs.base44.com/it/Account-and-billing/Credits.md)

> [card] Consigli per gestire l'uso dei crediti
>
> I workflow che si eseguono spesso o che concatenano più azioni possono esaurire rapidamente il tuo saldo crediti. Ecco alcuni modi per tenere l'uso sotto controllo:
>
> * **Aggiungi condizioni di trigger specifiche:** restringi i criteri che avviano un workflow così non si esegue inutilmente.
> * **Usa condizioni per saltare passi non necessari:** ramifica il workflow così i passi costosi si eseguono solo quando servono davvero.
> * **Consolida i workflow ridondanti:** se più workflow svolgono compiti sovrapposti, uniscili in meno workflow più intelligenti.
> * **Risolvi subito i workflow che falliscono:** i workflow in errore possono comunque consumare crediti a ogni tentativo. Controlla regolarmente la cronologia delle esecuzioni e sistema o disattiva i workflow problematici appena li individui.
> * **Rivedi la frequenza dei workflow schedulati:** valuta se i workflow ricorrenti, come report o promemoria giornalieri, devono davvero eseguirsi così spesso.
> * **Usa con parsimonia le chiamate AI:** se un passo chiama un modello AI, anche quello usa crediti, quindi chiamalo solo quando ti serve davvero il risultato.
> * **Prova prima su un piccolo set di dati:** esegui un workflow manualmente e controlla la sua cronologia per stimare il costo in crediti per esecuzione prima di abilitarlo su larga scala.

***

## FAQ

Clicca su una domanda qui sotto per saperne di più.

> [accordion] Posso aggiungere condizioni per controllare quando si esegue un passo?
>
> Sì. Chiedi alla chat AI di aggiungere condizioni a qualsiasi workflow o passo. Ad esempio:
>
> ```text theme={null}
> Dopo l'attesa, invia il promemoria solo se il task è ancora incompleto.
> ```
>
> Il workflow prende quindi percorsi diversi in base alle condizioni che descrivi, così passi diversi si eseguono a seconda dei dati. Una condizione può avere più percorsi, più un catch-all per qualsiasi cosa non corrisponda, e il diagramma mostra ogni percorso separatamente.

> [accordion] Cosa succede quando un workflow fallisce?
>
> Apri il workflow e controlla la sua **Run history** per trovare il passo fallito. Chiedi all'AI nella tua dashboard di spiegare l'errore e suggerire una correzione, poi usa **Run now** per confermare che il workflow riesce.
>
> Se un workflow continua a fallire, Base44 lo disattiva automaticamente e ti invia un'email, così puoi sistemarlo prima di riattivarlo. Un workflow schedulato viene disattivato dopo 5 fallimenti consecutivi, perché si esegue sempre nello stesso modo, quindi fallimenti ripetuti di solito indicano che qualcosa non va. I workflow con qualsiasi altro trigger vengono disattivati dopo 50 fallimenti consecutivi, perché i loro dati in ingresso variano e un fallimento occasionale è più prevedibile. Sistemare il workflow e riattivarlo azzera il conteggio.

> [accordion] Perché Run now mi chiede di scegliere un'esecuzione precedente?
>
> Dipende da come parte il workflow. Un workflow schedulato può essere eseguito su richiesta in qualsiasi momento, perché non richiede input. Un workflow che parte da un trigger entity, connector o in-app agent ha bisogno dei dati del trigger per eseguirsi, come il task specifico creato, quindi **Run now** riproduce i dati di un'esecuzione precedente. Ciò significa che il workflow deve eseguirsi almeno una volta prima di poterlo eseguire su richiesta.
>
> Se vedi **No previous runs**, attiva il workflow una volta per davvero, ad esempio creando un task per il workflow di follow-up dei task, e poi usa **Run now** per riprodurre quell'esecuzione.

> [accordion] Posso gestire i workflow dalla chat AI?
>
> Sì. Chiedi all'AI di attivare, disattivare, archiviare o ripristinare un workflow, e applica la modifica per te senza aprire i menu della dashboard.
>
> ![Chat AI che conferma che un workflow è in pausa](https://mintcdn.com/base44/I1QI0alPKQovwbjh/images/ai-chat-manage-workflow.png?fit=max\&auto=format\&n=I1QI0alPKQovwbjh\&q=85\&s=6f28125c2cedba6774dc865a99762aec)
>
> Gestire un workflow dalla chat AI.

> [accordion] Quanti workflow mostra la pagina Workflows?
>
> La pagina Workflows elenca tutti i tuoi workflow, scorrendo fino a 1.000.

> [accordion] Dove sono finite le automazioni della mia app?
>
> A novembre 2026, Base44 ha spostato le automazioni di ogni app nei workflow. Se la tua app aveva automazioni, le trovi nella pagina **Workflows** della dashboard della tua app. Ognuna ora è un workflow con lo stesso trigger e la stessa pianificazione. Anche i vecchi link alla pagina delle automazioni aprono **Workflows**.
>
> Le automazioni che avevi archiviato restano archiviate. Per vederle, clicca l'icona **More actions**  in cima alla pagina, poi clicca **View archive**.
>
> Se un workflow non è riuscito ad attivarsi dopo lo spostamento, un banner in cima alla pagina **Workflows** te lo segnala e il workflow mostra un'icona di avviso. Sistema il suo trigger, per esempio ricollegando un'integrazione, poi [attiva il workflow](#turning-a-workflow-on-or-off). Puoi anche chiedere alla chat AI di sistemarlo per te.
>
> Le esecuzioni precedenti allo spostamento non compaiono nella cronologia delle esecuzioni del workflow.

> [!NOTE]
>
> Questa pagina è stata tradotta con l'AI. Per le informazioni più accurate e aggiornate, consulta la [versione inglese](https://docs.base44.com/index.md).


## Related topics

- [Configurare i workflow](https://docs.base44.com/it/superagents/setting-up-workflows.md)
- [Usare i Superagent](https://docs.base44.com/it/Getting-Started/superagent.md)
- [Aggiungere regole con gli hook](https://docs.base44.com/it/Building-your-app/creating-hooks.md)
- [Catalogo connettori](https://docs.base44.com/it/Integrations/connectors-catalog.md)
- [Gestire le app del tuo workspace](https://docs.base44.com/it/documentation/using-your-workspaces/managing-your-workspace-apps.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.