Come eseguire il debug di un Flow di automazione che non esegue le azioni previste

Vitor

Vitor

Ultimo aggiornamento Oct 12, 2026

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


Inizia gratis e fai il debug dei tuoi Flow nella pratica →

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