Questo articolo ti mostra come identificare, eseguire il debug e risolvere i problemi nelle automazioni. Dagli errori comuni ai metodi sistematici di debugging.
Problemi comuni e soluzioni
Problema 1: I filtri non vengono applicati correttamente
Problema 1: I filtri non vengono applicati correttamente
Cosa succede:
L'automazione prende una direzione sbagliata o si interrompe inaspettatamente.
Perché succede:
La condizione del filtro è configurata in modo errato (ad es. "contiene" invece di "uguale a")
"Non ha valore" viene frainteso (significa che il campo è vuoto, non "il valore non è X")
Soluzione:
Apri l'automazione
Vai al nodo filtro che causa il problema
Controlla la condizione passo dopo passo:
La condizione è logicamente corretta? (ad es. "contiene almeno uno di" quando sono possibili più opzioni)
Testa con un valore noto
Problema 2: Più automazioni in esecuzione contemporaneamente
Problema 2: Più automazioni in esecuzione contemporaneamente
Cosa succede:
Il contatto riceve più messaggi contemporaneamente o diverse automazioni entrano in conflitto.
Perché succede:
Più automazioni hanno trigger che ascoltano lo stesso segnale (ad es. "Nuova conversazione in arrivo" e "Nuovo messaggio in arrivo").
Soluzione:
Vedi le istruzioni dettagliate nell'articolo "Automazioni per utenti avanzati" nella sezione "Lavorare con più automazioni".
Versione breve:
Usa "Attendi / Pausa" (2 secondi) + "Filtro: Altra automazione attiva" nell'automazione più generale
Problema 3: Elementi eliminati nei nodi
Problema 3: Elementi eliminati nei nodi
Cosa succede:
L'automazione si interrompe improvvisamente in un nodo specifico e mostra un errore.
Perché succede:
Un utente ha eliminato un elemento (ad es. etichetta, lista di contatti, attributo di contatto) che viene utilizzato in un nodo dell'automazione.
Esempio:
Hai eliminato l'etichetta "VIP"
Il nodo "Aggiorna etichetta" tenta di aggiungere l'etichetta "VIP"
Il nodo fallisce perché l'etichetta non esiste più
Soluzione:
Vai alla barra laterale a destra sotto "Automazioni" (nella Inbox o nel Contact Hub per la conversazione o il contatto in cui l'automazione è fallita)
Fai clic sull'esecuzione dell'automazione fallita
Guarda i singoli nodi eseguiti - il nodo fallito mostra esattamente quale elemento manca
Apri l'automazione
Vai al nodo interessato
Seleziona un elemento esistente o ricrea l'elemento eliminato
Prevenzione:
Prima di eliminare etichette, liste di contatti o Inbox, verifica se sono utilizzate nelle automazioni.
Problema 4: Due agenti AI attivi contemporaneamente
Problema 4: Due agenti AI attivi contemporaneamente
Cosa succede:
L'automazione si interrompe automaticamente al nodo dell'agente AI con un messaggio di errore.
Perché succede:
Esiste già un'automazione con agente AI in esecuzione per questa conversazione. Non consentiamo che due agenti AI parlino con lo stesso contatto nella stessa conversazione contemporaneamente.
Soluzione:
Struttura le tue automazioni in modo che solo un'automazione con agente AI possa essere eseguita alla volta:
Usa "Termina altre automazioni" all'inizio della nuova automazione per interrompere quella vecchia
Oppure usa il filtro "Automazione attiva" per verificare se un'automazione con agente AI è già in esecuzione
Problema 5: L'automazione viene eseguita con una versione vecchia
Problema 5: L'automazione viene eseguita con una versione vecchia
Cosa succede:
Hai apportato modifiche all'automazione ma si comporta come prima.
Perché succede:
Hai dimenticato di pubblicare la nuova versione. La versione vecchia è ancora attiva.
Soluzione:
Apri l'automazione
In alto a destra vedrai il pulsante "Aggiorna"
Fai clic su "Aggiorna"
Utilizzo della cronologia delle versioni:
Puoi visualizzare tutte le versioni della tua automazione:
Nel Automation Builder, fai clic sul menu a tre punti in alto a destra (accanto al pulsante "Aggiorna/Pausa")
Fai clic su "Cronologia versioni"
Vedrai tutte le versioni in ordine cronologico con data, ora e chi ha pubblicato la versione
"Attiva" ti mostra quale versione è attualmente live
"Bozza" ti mostra le modifiche non pubblicate
Fai clic sull'icona dell'occhio per visualizzare una versione vecchia
A cosa serve la cronologia delle versioni:
Verificare quale versione è attualmente attiva
Tracciare quando e chi ha apportato modifiche
Visualizzare le versioni vecchie per capire cosa è stato cambiato
Importante:
Solo le versioni pubblicate vengono eseguite live
Le modifiche in modalità di modifica non sono automaticamente attive
Per le automazioni aggiornate: Solo le nuove esecuzioni di automazioni passano attraverso la versione aggiornata
Le esecuzioni già attive terminano nella versione in cui sono iniziate
Esempio:
Automazione versione 1 è attiva
Il contatto A avvia l'automazione → viene eseguita la versione 1
Pubblica la versione 2
Il contatto A è ancora nell'automazione → termina con la versione 1
Il contatto B avvia l'automazione → viene eseguita la versione 2
Problema 6: Variabili o attributi di contatto sono vuoti
Problema 6: Variabili o attributi di contatto sono vuoti
Cosa succede:
L'automazione si interrompe in un nodo "Invia messaggio" o altri nodi che utilizzano variabili.
Perché succede:
La variabile o l'attributo di contatto che vuoi utilizzare è vuoto. Non inviamo messaggi con segnaposto vuoti perché sembrerebbero poco professionali.
Esempio:
Nodo "Invia messaggio": "Ciao #{{contact.first_name}}, benvenuto!"
L'attributo di contatto "Nome" è vuoto
Il messaggio sarebbe: "Ciao , benvenuto!"
Il nodo fallisce
Soluzione 1 - Definisci un valore di fallback:
Puoi impostare un valore di fallback per ogni variabile che verrà utilizzato se la variabile è vuota:
Fai clic sulla variabile nel campo di testo (ad es. il chip "Nome")
Si apre un popup: "Valore di fallback per Nome"
Inserisci un valore di fallback (ad es. "lì" o "Cliente")
Fai clic su "Applica"
Esempio:
Variabile "Nome" con fallback "di Berlino"
Se il nome è compilato: "Ciao Max, benvenuto!"
Se il nome è vuoto: "Ciao di Berlino, benvenuto!"
Soluzione 2 - Aggiungi un filtro:
Aggiungi un filtro prima del nodo "Invia messaggio":
Filtro: "Nome ha un valore"
Solo se il nome è compilato → Invia messaggio personalizzato
Altrimenti → Invia messaggio generico senza nome
Soluzione 3 - Richiedi l'attributo in anticipo:
Assicurati che l'attributo sia compilato prima di utilizzarlo:
Nodo "Fai una domanda": "Qual è il tuo nome?"
Nodo "Modifica contatto": Salva la risposta in "Nome"
Ora puoi essere sicuro che il nome sia compilato
Problema 7: L'automazione si riattiva dopo la cancellazione manuale
Problema 7: L'automazione si riattiva dopo la cancellazione manuale
Cosa succede:
L'utente annulla l'automazione per prendere il controllo manualmente. Il contatto risponde. L'automazione riparte dall'inizio.
Perché succede:
Stai utilizzando il trigger "Nuovo messaggio in arrivo" - questo si attiva con ogni messaggio, anche dopo che un agente ha preso il controllo.
Esempio:
Automazione: Trigger "Nuovo messaggio in arrivo" → Agente AI
L'agente annulla e prende il controllo manualmente
L'agente risponde al contatto
Il contatto risponde
Il trigger si attiva di nuovo → L'agente AI riparte
Soluzione: Usa il trigger "Nuova e riaperta conversazione" invece:
Si attiva solo al primo messaggio di una conversazione
Non si attiva su ogni messaggio successivo
L'agente può prendere il controllo senza che l'automazione riparta
Soluzione alternativa: Se devi usare "Nuovo messaggio in arrivo":
Aggiungi filtro: "Assegnazione non ha valore"
L'automazione viene eseguita solo se la conversazione non è assegnata
Non appena un utente prende il controllo (avviene l'assegnazione) → L'automazione non si attiva più
Problema 8: L'automazione non può essere testata
Problema 8: L'automazione non può essere testata
Cosa succede:
Vuoi testare l'automazione ma si attiva anche per i contatti reali, oppure non riesci a attivarla in modo affidabile.
Perché succede:
Non disponiamo ancora di una modalità di test per le automazioni (solo per l'agente AI).
Soluzione - Filtro sul contenuto del messaggio per il test: Aggiungi un filtro all'inizio dell'automazione che si attiva solo durante il test:
Opzione 1 - Filtro sul contenuto del messaggio:
Nodo "Filtro / Condizione": "Contenuto del messaggio contiene 'TEST123'"
Solo quando scrivi "TEST123" nel messaggio → L'automazione viene eseguita
I contatti reali non scrivono mai questo → L'automazione non si attiva per loro
Opzione 2 - Filtro sulla lista di contatti:
Crea una lista di contatti "Test"
Aggiungi te stesso a questa lista
Nodo "Filtro / Condizione": "Lista di contatti contiene Test"
Solo per i contatti nella lista "Test" → L'automazione viene eseguita
Importante: Rimuovi il filtro di test prima di pubblicare l'automazione per i contatti reali!
Problema 9: L'automazione si attiva solo una volta
Problema 9: L'automazione si attiva solo una volta
Cosa succede:
L'automazione viene eseguita la prima volta ma mai più - nemmeno durante il test.
Perché succede:
Motivo 1 - "Solo una volta per contatto" abilitato:
Molti trigger hanno l'opzione "Esegui solo una volta per contatto"
Se abilitato → L'automazione viene eseguita solo la prima volta per questo contatto
Mai più dopo
Motivo 2 - Trigger "Nuova conversazione in arrivo" senza "Riaperta":
Il trigger è impostato su "Solo nuove conversazioni"
Si attiva solo al primo messaggio di un contatto
Le conversazioni riaperte non attivano il trigger
Soluzione:
Durante il test:
Elimina completamente la conversazione
Ricomincia da capo - L'automazione può attivarsi di nuovo
Per l'operatività live:
Apri l'automazione
Vai al trigger
Disattiva "Esegui solo una volta per contatto" (se abilitato)
Oppure cambia "Solo nuove conversazioni" in "Nuove e riaperte conversazioni"
Problema 10: Tipo di messaggio sbagliato per il canale
Problema 10: Tipo di messaggio sbagliato per il canale
Cosa succede:
L'automazione si interrompe in un nodo "Invia messaggio" con un messaggio di errore.
Perché succede:
Stai cercando di inviare un tipo di messaggio non supportato per quel canale.
Esempi più comuni:
Risposte rapide di WhatsApp su Instagram:
Utilizzi il nodo "Risposte rapide di WhatsApp"
Ma la conversazione avviene tramite Instagram
Le risposte rapide di WhatsApp funzionano solo su WhatsApp
Liste di WhatsApp in email:
Utilizzi il nodo "Lista di WhatsApp"
Ma la conversazione avviene tramite email
Le liste di WhatsApp funzionano solo su WhatsApp
Soluzione 1 - Aggiungi un filtro:
Aggiungi un filtro prima del nodo specifico per il canale:
Nodo "Filtro / Condizione": "Tipo di canale uguale a WhatsApp"
Se WhatsApp:
Percorso 1: Risposte rapide di WhatsApp / Liste di WhatsApp
Altrimenti:
Percorso 2: Nodo "Invia messaggio" regolare senza funzionalità speciali
Soluzione 2 - Usa correttamente le automazioni multicanale:
Quando crei automazioni su più canali:
Crea percorsi separati per ogni canale
Utilizza solo nodi di messaggi specifici per il canale nel percorso corretto
Problema 11: Finestra temporale della conversazione chiusa
Problema 11: Finestra temporale della conversazione chiusa
Cosa succede:
L'automazione si interrompe nei nodi di risposte rapide di WhatsApp, liste di WhatsApp o nel nodo "Invia messaggio" indipendente dal canale con il messaggio di errore "Finestra temporale della conversazione chiusa".
Perché succede:
WhatsApp ha una regola delle 24 ore: puoi inviare messaggi gratuiti (risposte rapide, liste, testo regolare) solo entro 24 ore dall'ultimo messaggio del contatto. Dopo 24 ore, la finestra temporale della conversazione è chiusa.
Quando si verifica questo problema:
Esempio - Automazione ritardata:
Il contatto scrive alle 10:00
L'automazione parte
Nodo "Attendi / Pausa": Attendi 25 ore
Nodo "Risposte rapide di WhatsApp": Tenta di inviare
Errore: La finestra è chiusa (sono trascorse più di 24 ore)
Soluzione - Verifica la finestra temporale della conversazione:
Aggiungi un filtro prima dei nodi specifici di WhatsApp:
Nodo "Filtro / Condizione": Finestra temporale della conversazione
Percorso Aperta: La finestra è aperta (meno di 24 ore)
Risposte rapide di WhatsApp / Liste di WhatsApp / Messaggio regolare
Percorso Chiusa: La finestra è chiusa (più di 24 ore)
Nodo "Invia template di WhatsApp" (unica opzione fuori dalla finestra)
Importante da capire:
Entro le 24 ore (Finestra temporale della conversazione = Aperta):
Messaggi gratuiti consentiti
Risposte rapide di WhatsApp consentite
Liste di WhatsApp consentite
Template di WhatsApp consentiti
Oltre le 24 ore (Finestra temporale della conversazione = Chiusa):
SOLO template di WhatsApp consentiti
Nessun messaggio gratuito
Nessuna risposta rapida di WhatsApp
Nessuna lista di WhatsApp
Problema 12: L'automazione si interrompe - Crediti esauriti
Problema 12: L'automazione si interrompe - Crediti esauriti
Cosa succede:
L'automazione si interrompe improvvisamente nei nodi di azione. Nel registro delle attività vedi molte esecuzioni fallite.
Perché succede:
Non hai più crediti per le automazioni. Senza crediti, le automazioni non possono essere eseguite - solo il trigger viene eseguito, ma nessun nodo di azione.
Cosa sono i crediti:
Ogni nodo di azione costa 1 credito per esecuzione
Trigger e nodi logici sono gratuiti
Senza crediti → L'automazione si interrompe al primo nodo di azione
Soluzione:
Vai su Impostazioni
Fai clic su Piano e Fatturazione
Fai clic su Crediti
Controlla quanti crediti sono ancora disponibili
Passa a un pacchetto crediti superiore o aggiorna il tuo piano per ottenere più crediti mensili
Come eseguire il debug delle automazioni in modo sistematico
Passo 1: Identifica quale automazione sta causando il problema
Passo 1: Identifica quale automazione sta causando il problema
Scenario: È stato inviato un messaggio che non avrebbe dovuto essere inviato
Come trovare l'automazione:
Vai alla conversazione in cui si è verificato il problema
Scorri fino al messaggio interessato nella timeline della chat
Passa il mouse sull'icona del fulmine accanto al messaggio
Appare un tooltip con il nome dell'automazione
Per i messaggi dell'agente AI:
Vedrai un'icona dell'agente AI invece dell'icona del fulmine
Il tooltip mostra: Nome dell'automazione + nome dell'agente AI
Ora sai quale automazione ha causato il problema.
Passo 2: Verifica quali esecuzioni di automazioni sono avvenute
Passo 2: Verifica quali esecuzioni di automazioni sono avvenute
Barra laterale a destra → sezione "Automazioni"
Qui puoi vedere due cose importanti:
Automazioni attualmente attive:
Quali automazioni sono attualmente in esecuzione per questa conversazione
Stato: "In esecuzione"
Esecuzioni di automazioni passate:
Tutte le esecuzioni di automazioni per questo contatto in tutte le conversazioni
Con stato: Completata, Fallita, Annullata
Cosa puoi vedere qui:
Quando è iniziata l'automazione
Quale trigger l'ha attivata
Stato corrente
Quanto tempo è durata
Passo 3: Analizza l'esecuzione specifica dell'automazione
Passo 3: Analizza l'esecuzione specifica dell'automazione
Fai clic su un'esecuzione dell'automazione nella barra laterale
Ora puoi vedere i dettagli:
Panoramica:
Stato complessivo dell'esecuzione (Completata, Fallita, ecc.)
Ora di inizio e fine
Trigger che ha attivato l'automazione
Elenco di tutti i nodi che sono stati eseguiti:
Puoi vedere:
Nome del nodo (ad es. "Invia messaggio", "Filtro / Condizione", "Agente AI")
Stato del task:
Spunta verde → Eseguito con successo
X rossa → Fallito
Icona gialla dell'orologio → In attesa di risposta
Timestamp di quando il task è stato eseguito
Per i task falliti:
Puoi vedere il messaggio di errore che spiega perché è fallito
Esempio: "L'etichetta 'VIP' non esiste più"
Passo 4: Vai al nodo interessato nell'automazione
Passo 4: Vai al nodo interessato nell'automazione
Salta direttamente al nodo:
Fai clic sul task fallito o problematico nell'elenco dei task
Verrai reindirizzato automaticamente all'automazione
Il nodo interessato sarà evidenziato
Ora puoi:
Verificare la configurazione del nodo
Controllare le condizioni del filtro
Verificare le variabili
Correggere il nodo
Passo 5: Verifica il registro delle attività (per problemi generali)
Passo 5: Verifica il registro delle attività (per problemi generali)
Nell'automazione → Scheda "Registro attività"
Qui puoi vedere tutte le esecuzioni di automazioni per tutti i contatti.
Quando usarlo:
L'automazione non viene eseguita per nessuno (non solo per te)
Vuoi vedere quante volte l'automazione è stata attivata di recente
Stai cercando schemi negli errori
Opzioni di filtro:
Filtra per stato:
Completata → L'automazione è stata eseguita con successo
In esecuzione → L'automazione è attualmente in esecuzione
Fallita → Almeno un task è fallito
Annullata → L'automazione è stata annullata manualmente o terminata da un'altra automazione
Completata senza azioni → Molto importante per il debugging!
Cosa significa "Completata senza azioni"?
L'automazione è stata attivata MA non è stato eseguito alcun nodo di azione. Questo accade quando:
Un filtro subito dopo il trigger interrompe l'automazione
Il filtro è configurato in modo errato
La condizione nel trigger stesso non è soddisfatta
Esempio:
Trigger "Nuova conversazione in arrivo"
Subito dopo: Filtro "Etichetta contiene VIP"
Il contatto non ha l'etichetta VIP → Il filtro interrompe l'automazione
Non è stata eseguita alcuna azione → Stato "Completata senza azioni"
Altri filtri:
Cerca per nome del contatto → Trova esecuzioni da un cliente specifico
Filtra per automazione → Solo esecuzioni da una specifica automazione
Periodo di tempo → Solo esecuzioni all'interno di un intervallo di date specifico