Problemi comuni e soluzioni
Flusso di lavoro non attivato
Sintomi: Il flusso di lavoro non viene eseguito quando previsto.
Possibili cause:
- Flusso di lavoro non attivato: Assicurati che il flusso di lavoro sia impostato su “Attivo” e non su “Bozza”
- Condizioni del trigger non soddisfatte: Verifica che il trigger corrisponda all’evento previsto
- Campo non monitorato: Per i trigger “Record is Updated”, assicurati che il campo specifico sia monitorato
- Autorizzazioni: Verifica di avere l’autorizzazione per eseguire i flussi di lavoro
Soluzioni:
- Verifica lo stato del flusso di lavoro nell’elenco dei flussi di lavoro
- Esegui un test con l’azione specifica che dovrebbe attivarlo
- Rivedi la configurazione del trigger
- Contatta l’amministratore per le autorizzazioni
Il flusso di lavoro si attiva troppo presto (campi vuoti)
Sintomi: Quando crei manualmente un record nell’interfaccia utente, il flusso di lavoro si attiva prima che tu abbia il tempo di compilare tutti i campi. Il flusso di lavoro viene eseguito con valori di campo per la maggior parte vuoti.
Perché accade: Twenty salva tutto in tempo reale — non esiste una modalità separata “modifica” vs “lettura”. Quando crei un record, questo viene salvato immediatamente, attivando l’evento “Record is created” prima che tu possa compilare i campi aggiuntivi.
Quando “Record is created” funziona bene:
- Record creati tramite chiamate API (i campi vengono popolati in un’unica richiesta)
- Record creati tramite importazione
- Creazione automatizzata di record da altri flussi di lavoro
Soluzione: Per i record creati manualmente nell’interfaccia utente, usa “Record is created or updated” come trigger. In questo modo:
- Il flusso di lavoro si attiva dopo che l’utente ha terminato di compilare e salvare i campi
- Ottieni i dati completi invece di valori vuoti
Se desideri che il flusso di lavoro venga eseguito solo una volta per record, aggiungi un’azione Filter per verificare un campo come createdAt equals updatedAt (primo salvataggio) oppure usa un campo casella di controllo personalizzato per tracciare se il flusso di lavoro è già stato eseguito.
Azioni non riuscite
Sintomi: Il flusso di lavoro viene eseguito ma alcune azioni non riescono.
Possibili cause:
- Dati mancanti: I campi obbligatori sono vuoti
- Riferimenti non validi: Le variabili dei passaggi precedenti non esistono
- Errori API: I servizi esterni restituiscono errori
- Problemi di autorizzazioni: L’azione richiede autorizzazioni che non possiedi
Soluzioni:
- Controlla i dettagli dell’esecuzione del flusso di lavoro per eventuali messaggi di errore
- Verifica che tutti i campi obbligatori abbiano un valore
- Testa le connessioni API in modo indipendente
- Rivedi le autorizzazioni del ruolo
Errori delle richieste HTTP
Sintomi: Le azioni HTTP Request non riescono o restituiscono risultati inattesi.
Codici di errore comuni:
- 400: Richiesta non valida - controlla il formato del corpo della richiesta
- 401: Non autorizzato - verifica la chiave API
- 403: Vietato - controlla le autorizzazioni dell’API
- 404: Non trovato - verifica l’URL dell’endpoint
- 429: Troppe richieste - implementa la limitazione della frequenza
- 500: Errore del server - problema del servizio esterno
Soluzioni:
- Verifica l’URL dell’endpoint API
- Controlla le intestazioni di autenticazione
- Esegui prima il test della chiamata API al di fuori di Twenty
- Aggiungi la gestione degli errori nelle azioni di Codice
Errori delle azioni di Codice
Sintomi: Il codice JavaScript non viene eseguito.
Problemi comuni:
- Errori di sintassi: Refusi o JavaScript non valido
- Variabili non definite: Riferimento a variabili che non esistono
- Errori di tipo: Operazioni su tipi di dati errati
- Timeout: Il codice impiega troppo tempo per essere eseguito
Soluzioni:
- Usa la convalida dell’editor di codice integrato
- Verifica prima la logica del codice in una console JavaScript
- Aggiungi istruzioni console.log per il debug
- Semplifica le operazioni complesse
Le email non vengono inviate
Sintomi: L’azione Invia email non recapita le email.
Possibili cause:
- Nessun account email connesso: Controlla Impostazioni → Account
- Indirizzo email non valido: L’email del destinatario non è valida
- Limiti di invio: Raggiunti i limiti di frequenza del provider email
- Filtri antispam: Le email vengono bloccate
Soluzioni:
- Verifica la connessione dell’account email
- Convalida gli indirizzi email dei destinatari
- Controlla i limiti del provider email
- Rivedi il contenuto dell’email per possibili trigger di spam
Debug dei flussi di lavoro
Utilizzo delle esecuzioni del flusso di lavoro
- Vai all’editor dei flussi di lavoro
- Apri il pannello Esecuzioni
- Trova l’esecuzione non riuscita
- Fai clic per vedere i dettagli passo dopo passo
- Rivedi i messaggi di errore e i dati di output
Test dei singoli passaggi
- Per le azioni di Codice, usa il pulsante Test
- Per le richieste HTTP, testa separatamente l’endpoint
- Crea record di test per attivare i flussi di lavoro
- Usa trigger manuali per test controllati
Schemi comuni di debug
Aggiungi logging:
Usa le azioni di Codice per registrare valori intermedi per il debug.
Isola i passaggi:
Testa ogni passaggio in modo indipendente per identificare gli errori.
Controlla il flusso dei dati:
Verifica che ogni passaggio riceva i dati di input previsti.
Buone pratiche per evitare problemi
Prima dell’attivazione
- Esegui test approfonditi in modalità bozza
- Convalida tutte le connessioni API
- Rivedi attentamente le condizioni del trigger
- Documenta il comportamento previsto
Durante lo sviluppo
- Usa nomi di passaggio descrittivi
- Aggiungi commenti nelle azioni di Codice
- Testa con dati realistici
- Pianifica i casi limite
Dopo l’attivazione
- Monitora attentamente le esecuzioni iniziali
- Configura avvisi per gli errori
- Rivedi regolarmente la cronologia delle esecuzioni
- Mantieni i flussi di lavoro semplici quando possibile
