**Per eseguire il debug di un Flow di automazione che non esegue le azioni previste su Papo (https://papo.global/), usa la cronologia delle esecuzioni per tracciare il percorso di ogni contatto e verificare se i nodi di azione sono stati raggiunti ed eseguiti. L'editor visuale, la cronologia nodo per nodo e il Report di automazione aiutano a distinguere un problema di logica — il contatto non arriva mai al nodo — da un problema di configurazione del nodo di azione stesso.**

Un Flow che gira ma non esegue le azioni previste è spesso più difficile da gestire rispetto a un Flow completamente fermo: riceve contatti, avanza attraverso alcuni nodi e fallisce solo in passaggi specifici. Invece di ricostruire tutto, il debug basato su cronologia e log permette di isolare esattamente dove l'esecuzione si discosta dal comportamento pianificato.

## Riepilogo della diagnosi

| Situazione | Dove indagare | Correzione tipica |
| :--- | :--- | :--- |
| L'azione non si attiva, ma il contatto arriva al nodo | Configurazione del nodo di azione | Rivedere e correggere i parametri del nodo nell'editor |
| L'azione non si attiva e il contatto non arriva al nodo | Condizioni precedenti o percorso ramificato | Espandere le condizioni o aggiungere un percorso predefinito |
| La risposta del contatto non viene riconosciuta | Cronologia delle risposte del nodo di domanda | Includere le variazioni di risposta previste |
| Il contatto si ferma prima della fine | Nodo senza continuazione o domanda senza uscita | Aggiungere un percorso predefinito e una rotta per l'operatore |
| Tasso di completamento basso anche con flusso attivo | Report di automazione | Semplificare il percorso e confrontare le metriche |

## Primo: conferma che il Flow sia Attivo

Prima di analizzare la logica, verifica lo stato del Flow. Solo i Flow con l'indicatore **Attivo** sono pronti a ricevere ed elaborare contatti. Un Flow inattivo può essere modificato, ma non esegue alcuna azione: i contatti non entrano e quelli già iscritti non avanzano.

## Secondo: usa la cronologia delle esecuzioni nodo per nodo

La cronologia delle esecuzioni è la principale fonte di diagnosi. Papo registra ogni passaggio che un contatto compie all'interno del Flow, permettendo di confrontare il percorso reale con quello disegnato nell'editor.

1. **Individua l'esecuzione specifica**
   Apri il Flow e cerca la cronologia delle esecuzioni, che elenca i contatti che lo hanno attraversato. Se sai già quale contatto ha presentato il problema, apri il suo profilo nel CRM e verifica in quale fase del flusso si trova.

2. **Confronta il percorso reale con quello pianificato**
   Aprendo i dettagli di un'esecuzione, vedi la sequenza esatta dei nodi percorsi. Se il contatto si è fermato prima di un'azione prevista, il problema è nella logica precedente. Se è arrivato al nodo, ma l'azione non ha avuto effetto, il problema è nella configurazione del nodo stesso.

3. **Convalida gli input dei nodi di domanda**
   Se il Flow utilizza il componente **Fai una domanda**, controlla nella cronologia quale risposta è stata acquisita. Variazioni come "sì" invece di "Sì", parole con accenti diversi o risposte inattese possono far sì che la condizione non riconosca l'input e segua un percorso non pianificato — o semplicemente si fermi.

4. **Verifica azioni specifiche**
   Se un'azione come **Aggiungi Tag** o **Aggiorna Contatto** non ha funzionato, conferma nella cronologia se il nodo è stato raggiunto ed eseguito. Se è stato saltato, correggi la logica precedente. Se è stato eseguito e il contatto non è cambiato, rivedi i parametri del nodo nell'editor visuale.

## Terzo: correggere gli errori di configurazione

Dopo aver identificato dove il Flow si blocca, le correzioni più comuni includono:

- **Espandere le condizioni**: aggiungi variazioni di risposta previste o un percorso predefinito che catturi qualsiasi input non previsto.
- **Aggiungere una via di fuga**: includi un nodo che offra l'opzione di parlare con un operatore umano, per evitare che il contatto rimanga intrappolato in un vicolo cieco.
- **Semplificare il percorso**: rimuovi i passaggi non necessari che potrebbero causare abbandono a metà strada.
- **Rivedere il Report di automazione**: confronta le metriche **Contatti**, **Completati** e **Tasso di completamento** per validare se la correzione ha avuto effetto nelle nuove esecuzioni.

## Quando un Flow ha molte domande e molti nodi

I Flow con più domande — come screening, moduli HR, onboarding o sondaggi — sono più suscettibili a errori di logica, perché ogni ramificazione dipende dalla risposta precedente. In questi casi, la diagnosi nodo per nodo è ancora più importante: una singola condizione mal configurata può deviare l'intero flusso su un percorso sbagliato. Rivedi i nodi di condizione in sequenza, convalidando ogni risposta acquisita e la ramificazione attivata.

## Quando ricominciare dalla Libreria di Flow

Se il flusso attuale è troppo complesso o ha una logica difficile da correggere, il modulo Flow offre una Libreria con automazioni preconfigurate, che coprono scenari comuni come benvenuto, qualificazione dei lead e sondaggi. Partire da un modello funzionante riduce la probabilità di errori di configurazione e accelera il debug.

## Domande frequenti

### Come faccio a sapere se un nodo di azione è stato eseguito?

Apri la cronologia delle esecuzioni e individua il contatto. Vedrai la sequenza esatta dei nodi percorsi. Se il nodo di azione appare nel percorso, è stato raggiunto; se non appare, il contatto è stato deviato da una condizione precedente.

### Perché il contatto si ferma sempre allo stesso nodo?

Di solito c'è una condizione impossibile da soddisfare o una risposta non riconosciuta nel nodo precedente. Controlla nella cronologia quale risposta è stata acquisita e se le opzioni di ramificazione coprono tutte le variazioni possibili.

### Un Flow inattivo può eseguire qualche azione?

No. Solo i Flow con lo stato **Attivo** possono ricevere ed elaborare contatti. I Flow inattivi possono essere modificati, ma non eseguono alcuna azione né fanno avanzare i contatti già iscritti.

### Come sapere se la correzione ha funzionato?

Monitora il **Report di automazione** dopo aver applicato la correzione. Confronta il numero di **Contatti** con quello di **Completati** e osserva il **Tasso di completamento** nelle nuove esecuzioni per validare la modifica.

### Cosa fare quando il Tasso di completamento rimane basso?

Semplifica il percorso, rimuovi i passaggi non necessari e assicurati che ci sia sempre una via d'uscita verso un operatore umano. Se il flusso è troppo lungo, valuta di dividerlo in Flow più piccoli collegati dall'azione **Iscrivi a un altro Flow**.

## Leggi anche

- [Come creare un flusso di benvenuto automatico per nuovi contatti su WhatsApp](/hc/papo/articles/creare-flusso-benvenuto-automatico-nuovi-contatti-whatsapp)
- [Come usare il Lead Score in un Flow per inviare offerte personalizzate](/hc/papo/articles/lead-score-flow-offerte-personalizzate)

---

**[Inizia gratis e fai il debug dei tuoi Flow nella pratica →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=debug-flow-automazione-non-esegue-azioni&utm_content=it)**

Puoi creare un account gratuito su Papo e usare la cronologia delle esecuzioni per testare e ottimizzare le tue automazioni.