Consiglio iniziale: controlla il registro attività
Controllare il registro attività della tua automazione ti aiuta a capire fino a che punto l’automazione arriva prima di incontrare un problema. Puoi trovarlo aprendo l’automazione attiva, cliccando sui tre puntini in alto a destra e selezionando Registro attività.
Qui vedrai le esecuzioni precedenti dell’automazione, incluse quelle che non sono andate a buon fine. Cliccando su una di esse, si aprirà una barra laterale con informazioni più dettagliate su dove l’automazione si è interrotta e su eventuali problemi rilevati.
Questo è molto utile per individuare la causa del problema. Anche se il registro non fornisce sempre una soluzione diretta, ti indica dove si trova il problema e ti permette di fare un troubleshooting più mirato.
Per velocizzare il processo, puoi anche cliccare su Stato nella parte superiore del registro attività. In questo modo puoi filtrare le esecuzioni e trovare più rapidamente quelle che ti interessano. Questo ti permette di individuare non solo le automazioni fallite, ma anche quelle che si sono concluse senza eseguire alcuna azione.
Questo è utile per identificare automazioni che sono state attivate correttamente ma che si sono concluse senza eseguire alcun nodo di azione. In questi casi, l’automazione non è tecnicamente fallita, ma non ha comunque prodotto il risultato desiderato. Di conseguenza, questo tipo di problema può essere facile da non notare.
Importante: questo tipo di problema si verifica spesso quando i filtri non sono configurati correttamente per verificare le condizioni previste. Per questo motivo, è sempre una buona idea controllare i filtri. Puoi trovare maggiori informazioni sull’uso corretto dei filtri qui.
Automazione modificata o duplicata – trigger errato
Problema:
Quando modifichi o duplichi un’automazione, Superchat non aggiorna automaticamente il trigger in base al nuovo caso d’uso. Potresti quindi ritrovarti con il trigger precedente ancora attivo.
Soluzione:
Apri l’automazione e controlla il trigger all’inizio del flusso
(ad esempio Nuova o riaperta conversazione, Messaggio ricevuto, Trigger manuale).
Assicurati che il trigger corrisponda davvero a ciò a cui vuoi che questa automazione reagisca. Consulta la nostra pagina su Trigger e Filtri per saperne di più.
Se hai apportato modifiche, pubblica nuovamente l’automazione.
Utilizzo di “Nuovo messaggio in arrivo” senza filtro
Problema:
Usare il trigger Nuovo messaggio in arrivo senza un filtro sui messaggi fa sì che l’automazione si attivi per ogni singolo messaggio nel canale o nello spazio di lavoro.
Questo può rendere rapidamente l’automazione caotica e difficile da controllare, perché un nuovo messaggio può attivare la stessa automazione mentre l’esecuzione precedente è ancora in corso. Il risultato può essere esecuzioni duplicate, comportamenti imprevisti o loop.
Soluzione:
Aggiungi un filtro subito dopo il trigger.
Puoi trovare i filtri cercando Filtro nella barra di ricerca quando aggiungi un nuovo nodo. I filtri più utilizzati sono:Filtro contenuto messaggio (per parole chiave specifiche)
Filtro etichette
In caso di dubbio, passa invece a Nuova o riaperta conversazione: di solito è l’opzione più sicura e prevedibile.
Tipo di filtro errato o valore sbagliato
Problema:
I filtri sono potenti, ma anche molto rigidi. Se scegli il tipo di filtro sbagliato, l’automazione non verrà mai eseguita. Un errore molto comune è usare “È uguale a” quando in realtà sarebbe corretto “Contiene”. Un altro problema frequente è l’utilizzo di un valore errato (ad esempio nome dell’etichetta o del canale sbagliato), che impedisce comunque l’avvio dell’automazione.
Soluzione:
Controlla:
Stai usando il tipo di filtro corretto?
(La nostra tabella dei filtri spiega ogni tipo e quando usarlo.)Il valore è corretto? (ortografia, nome dell’etichetta, selezione del canale)
Se continui ad avere problemi, prova prima con un filtro molto semplice e rendilo più specifico passo dopo passo.
Attributo del contatto salvato nel formato sbagliato
Problema:
Se salvi, ad esempio, un indirizzo email in un attributo del contatto ma scegli il tipo sbagliato (come Testo invece di Email), possono verificarsi problemi di validazione o difficoltà nell’utilizzo dei dati in seguito.
Soluzione:
Vai su Impostazioni → Contatti → Attributi del contatto.
Controlla il tipo dell’attributo (ad esempio Email, Testo, Numero) e assicurati che l’attributo usato nell’automazione abbia il tipo di dato corretto (ad esempio Data quando salvi una data di nascita).
Se il tipo è sbagliato, crea un nuovo attributo del contatto con il tipo corretto, sostituiscilo nell’automazione e testa di nuovo.
Nota: se un attributo è già impostato su un contatto, il tipo di dato non può essere modificato. In questi casi, è generalmente più semplice creare un nuovo attributo del contatto. Puoi trovare maggiori informazioni sugli attributi del contatto qui.
Attributi non aggiornati tramite webhook
Problema:
In Superchat, gli attributi del contatto che hanno già un valore non possono essere sovrascritti tramite webhook. Se un attributo (ad esempio numero di telefono o fonte del lead) è già compilato, Superchat ignorerà qualsiasi nuovo valore inviato tramite webhook.
Questo significa che il webhook viene ricevuto correttamente, ma il valore esistente rimane invariato. Poiché non viene mostrato alcun errore, può sembrare che il webhook non funzioni, anche se in realtà funziona correttamente.
Soluzione:
Puoi:
Aggiungere un passaggio nel tuo sistema esterno che svuoti prima l’attributo, oppure
Aggiungere in Superchat un nodo Aggiorna contatto per azzerare l’attributo prima del webhook.
Pubblica l’automazione e invia nuovamente il valore tramite webhook.
Impossibile pubblicare l’automazione
Problema:
A volte Superchat non consente di pubblicare un’automazione perché manca qualcosa o c’è una configurazione errata (ad esempio nodi vuoti, filtri non validi, dettagli delle azioni mancanti). Di solito i messaggi di errore indicano la causa del problema.
Soluzione:
Controlla ogni nodo dall’alto verso il basso per:
icone di avviso rosse o messaggi di errore
azioni incomplete (ad esempio “Invia messaggio” senza contenuto)
filtri senza condizioni
Correggi o rimuovi i passaggi incompleti e prova a pubblicare di nuovo.
AI Agent non viene attivato
Problema:
Il tuo AI Agent non risponde, anche se ti aspetti che lo faccia.
Soluzione:
Controlla il registro attività
Vai nel registro attività e trova l’automazione della conversazione che non ha funzionato. Verifica se il nodo dell’AI Agent è stato eseguito oppure se un’altra automazione è ancora in esecuzione.
Se il nodo non è stato eseguito e non viene mostrato alcun errore specifico, controlla l’automazione precedente e assicurati che tutte le condizioni siano configurate correttamente.
Controlla trigger e filtri
L’automazione viene effettivamente attivata per quel canale / etichetta / messaggio?
È stato selezionato l’AI Agent corretto per quel canale?
È stato selezionato un altro AI Agent con parametri o prompt diversi?
L’automazione non viene eseguita perché non è pubblicata
Problema:
Può sembrare banale, ma succede spesso: hai creato o modificato un’automazione e hai dimenticato di pubblicarla. In questo caso, l’automazione non verrà mai eseguita.
Soluzione:
Apri l’automazione e controlla lo stato in alto.
Se vedi Pubblica, l’automazione è ancora una bozza.
Se vedi Aggiorna, l'automazione è già attiva ma le modifiche non sono ancora live.Clicca su Pubblica o Aggiorna e testa nuovamente l’automazione con una nuova conversazione o un nuovo messaggio.
Nota: le automazioni utilizzano sempre la versione pubblicata al momento dell’attivazione. Pubblicare una nuova versione non influisce sulle conversazioni avviate prima dell’aggiornamento.
Problemi con il filtro del contenuto del messaggio
Problema:
Stai utilizzando un filtro sul contenuto del messaggio (ad esempio “Il messaggio contiene…”) ma non sembra funzionare, quindi l’automazione non parte. Per una panoramica sui filtri e sul loro utilizzo, consulta qui.
Soluzione:
Verifica che il filtro sia applicato al tipo di messaggio corretto (in entrata o in uscita).
Controlla la presenza di spazi extra o emoji.
Prova inizialmente una condizione più ampia:
usa “contiene” con una singola parola chiave invece di una frase lunga.
Testa con un messaggio molto semplice che corrisponda chiaramente al filtro
(ad esempio inviando esattamente quella parola chiave).
Se funziona, rendi il filtro più specifico passo dopo passo.
Automazioni eseguite fuori dalla finestra di 23 ore
Problema:
Meta limita le risposte WhatsApp a 24 ore dall’ultimo messaggio del cliente.
Una volta chiusa questa finestra, i messaggi liberi e le risposte dell’AI Agent vengono bloccati. Qualsiasi automazione che tenta di inviare un messaggio normale fallirà, a meno che non utilizzi un template WhatsApp approvato.
Soluzione:
Configura le automazioni in modo che controllino l’età della conversazione e passino automaticamente a un template WhatsApp quando la finestra di 23 ore è scaduta.
Usare trigger più rapidi e ritardi più brevi aiuta anche a garantire che le risposte vengano inviate mentre la finestra è ancora aperta.