Per eseguire il debug di un Flow di automazione che non funziona in Papo (https://papo.global/), accedi alla cronologia delle esecuzioni del flusso per rivedere ogni fase percorsa dal contatto e identificare dove la logica si è interrotta. L'editor visuale e i report di automazione permettono di tracciare il percorso reale seguito da ciascun utente, rivelando nodi con errori, condizioni mal configurate o azioni che non vengono mai attivate.
Un Flow che non esegue le azioni previste può avere diverse cause: una condizione che non viene mai soddisfatta, un trigger che non si attiva o persino un flusso inattivo. Invece di ricostruire l'automazione da zero, un debug metodico basato sulla cronologia delle esecuzioni risolve il problema più rapidamente.
Sintomi comuni di un Flow con problemi
| Sintomo | Possibile causa | Dove verificare |
|---|---|---|
| Nessun contatto entra nel Flow | Flow inattivo, trigger errato o iscrizione non effettuata | Stato del Flow e regole di iscrizione |
| I contatti si fermano sempre nello stesso nodo | Condizione impossibile da soddisfare o risposta attesa che non arriva mai | Nodi di condizione e domande del flusso |
| Le azioni non vengono eseguite (es: tag non applicata) | Configurazione errata dell'azione o percorso alternativo non mappato | Dettagli del nodo e cronologia dei passaggi |
| Tasso di completamento molto basso | Percorso troppo lungo, domanda confusa o mancanza di uscita verso un operatore | Report di Automazione e cronologia |
Come usare la cronologia delle esecuzioni per eseguire il debug di un Flow
Il cuore del debug sta nel seguire il percorso reale che un contatto ha compiuto. Papo registra ogni passaggio all'interno di un Flow, permettendo una diagnosi precisa senza supposizioni.
-
Conferma che il Flow sia attivo Prima di indagare sugli errori di logica, verifica che il Flow abbia lo stato Attivo. Solo i Flow attivi possono ricevere ed elaborare contatti. Un flusso inattivo rimane invisibile alle nuove iscrizioni, e i contatti già iscritti non avanzano.
-
Individua il contatto o l'esecuzione specifica Accedi al modulo Flow / Chatbot e apri il flusso che desideri eseguire il debug. Cerca la cronologia delle esecuzioni del Flow, dove è possibile vedere l'elenco dei contatti che l'hanno attraversato. Se sai quale contatto specifico ha avuto il problema, apri il suo profilo nel CRM e verifica in quale fase del flusso si trova.
-
Rivedi il percorso nodo per nodo Aprendo i dettagli di un'esecuzione, visualizzi la sequenza esatta dei nodi che il Flow ha attraversato. Confronta il percorso reale con quello che hai progettato. Se il contatto si è fermato in un nodo di condizione, ad esempio, verifica quale risposta ha dato e quale ramo è stato attivato, se presente. Questo spesso mette in evidenza condizioni che non contemplano tutte le risposte possibili.
-
Valida gli input dei nodi di Domanda Se il Flow utilizza il componente Porre una Domanda, controlla la cronologia per vedere la risposta acquisita. Spesso il contatto invia una parola diversa da quella attesa (come "si" invece di "Sì"), e la condizione configurata per il ramo non riconosce questa variante, facendo seguire al flusso un percorso non pianificato o semplicemente fermandosi.
-
Verifica le azioni di aggiornamento e iscrizione Se un'azione come Aggiungere Tag o Aggiornare Contatto apparentemente non ha funzionato, controlla nel nodo specifico della cronologia se è stato raggiunto ed eseguito. Se il nodo è stato saltato, il problema è nella logica precedente. Se è stato eseguito ma il contatto non è stato modificato, rivedi la configurazione del nodo di azione stesso nell'editor.
Adeguare la logica in base a quanto rilevato
Dopo aver identificato dove il Flow si interrompe, le correzioni più comuni includono:
- Espandere le condizioni: aggiungi varianti di risposta attesa o un percorso predefinito per catturare input non previsti.
- Semplificare il percorso: rimuovi le fasi non necessarie che potrebbero causare abbandono.
- Aggiungere una via di fuga: includi sempre un nodo che offra l'opzione di parlare con un operatore umano.
- Rivedere il Report di Automazione: confronta la metrica Contatti con Completati e il Tasso di Completamento per validare se la correzione ha avuto effetto sulle nuove esecuzioni.
Quando usare la Libreria di Flow per ricominciare
Se il flusso attuale è troppo complesso o con una logica difficile da correggere, un'alternativa è ricominciare da una base affidabile. Il modulo Flow offre una Libreria di Flow con automazioni preconfigurate, che coprono scenari comuni come benvenuto, qualificazione dei lead e sondaggi. Partire da un modello funzionante riduce la possibilità di errori logici e accelera il debug.
Domande Frequenti
Come faccio a sapere se il mio Flow è attivo?
Nel modulo Flow / Chatbot, ogni flusso mostra il proprio stato. Solo quelli con l'indicatore Attivo sono pronti a ricevere ed elaborare contatti. I Flow inattivi possono essere modificati, ma non eseguono alcuna azione.
Perché il tasso di completamento del mio Flow è così basso?
Un Tasso di Completamento basso generalmente indica un collo di bottiglia. Può essere una domanda confusa, una condizione che non copre tutte le risposte o l'assenza di un percorso chiaro per l'utente. Usa la cronologia delle esecuzioni per vedere esattamente in quale nodo i contatti si stanno fermando e correggi quel punto nel percorso.
Come iscrivere nuovamente i contatti a un Flow corretto?
Se hai modificato un Flow e vuoi che un contatto che l'ha già attraversato lo riprovi, è possibile iscriverlo manualmente. Apri il profilo del contatto nel CRM e utilizza l'opzione di iscrizione a un Flow attivo. Un altro modo è utilizzare l'iscrizione in blocco, selezionando più contatti nell'elenco del CRM e applicando l'azione.
Cosa faccio quando un'azione di "Aggiungere Tag" non funziona?
Innanzitutto, conferma nella cronologia delle esecuzioni se il nodo di Aggiungere Tag è stato effettivamente raggiunto. Se sì, rivedi la configurazione del nodo nell'editor per assicurarti che sia stata selezionata la tag corretta. Se il nodo è stato saltato, il problema è in un nodo precedente, come una condizione non soddisfatta, ed è lì che va fatta la correzione.
Posso testare un Flow prima di attivarlo per tutti i contatti?
Sì. Il modo più sicuro è iscrivere manualmente un contatto di test, tramite il suo profilo nel CRM, e monitorare il suo avanzamento nella cronologia delle esecuzioni. Questo isola il test e non influisce sui contatti reali finché non hai la certezza che il flusso funzioni correttamente.
Dove trovo la cronologia delle esecuzioni?
La cronologia è accessibile in due modi principali: dal modulo Flow / Chatbot, selezionando il flusso desiderato e visualizzando le esecuzioni recenti, oppure dal profilo individuale del contatto nel CRM, dove è possibile vedere lo stato attuale e il percorso compiuto all'interno di ogni Flow a cui è iscritto.
Leggi anche
- Capire il Report di Automazione: Come misurare l'efficienza dei tuoi Flow
- Creare il tuo primo Flow di Automazione da zero
Prova Papo con un utente gratuito e inizia a eseguire il debug dei tuoi Flow di automazione già oggi.