Azioni del workflow

​

Informazioni sulle azioni

Le azioni definiscono cosa accade dopo l’attivazione di un trigger. Puoi concatenare più azioni per creare automazioni complesse.

​

Azioni sui record

​

Crea un Record

Aggiunge un nuovo record a un oggetto selezionato. Configurazione:

• Seleziona l’oggetto di destinazione
• Compila i campi richiesti e opzionali
• Usa i dati dai passaggi precedenti oppure inserisci i valori manualmente per popolare i campi

Output: I dati del nuovo record creato sono disponibili per l’uso in passaggi successivi.

​

Aggiorna Record

Modifica un record esistente in un oggetto selezionato. Configurazione:

• Seleziona l’oggetto di destinazione
• Scegli il record specifico da aggiornare.
  • Puoi scegliere un record fisso, utilizzando il menu a discesa che mostra tutti i record disponibili.
  • Oppure puoi selezionare dinamicamente il record, indicando un record trovato in un passaggio precedente, usando (x+). In questa fase non è possibile cercare il record in base a criteri diversi. Se non hai ancora identificato il record, aggiungi un passaggio Search Record prima di questo passaggio Update Record.
• Seleziona i campi da modificare e inserisci nuovi valori

Output: I dati del record aggiornato sono disponibili per l’uso in passaggi successivi.

​

Elimina Record

Rimuove un record da un oggetto selezionato. Configurazione:

• Seleziona l’oggetto di destinazione
• Scegli il record specifico da eliminare

Output: I dati del record eliminato rimangono disponibili per l’uso in passaggi successivi.

​

Cerca Record

Trova i record all’interno di un oggetto selezionato utilizzando condizioni di filtro. Configurazione:

• Seleziona l’oggetto da cercare
• Imposta criteri di filtro per restringere i risultati
• Configura l’ordinamento e i limiti

Output: Restituisce i record corrispondenti utilizzabili in passaggi successivi. Migliore Pratica: Usa rami dopo Search Records per gestire scenari “trovato” vs “non trovato”.

​

Inserisci o aggiorna Record

Crea un nuovo record o aggiorna uno esistente in base ai criteri di corrispondenza. È utile quando non sei sicuro che un record esista già. Configurazione:

• Seleziona l’oggetto di destinazione
• Tieni presente quali campi possono essere utilizzati per la corrispondenza: email per Persone, dominio per Aziende, ID per qualsiasi oggetto o qualsiasi campo contrassegnato come Univoco. Dovrai compilare almeno uno di questi qui sotto.
• Compila i valori dei campi. Non dimenticare di valorizzare almeno uno degli identificatori univoci.

• Usa dati dai passaggi precedenti per popolare i campi

Come funziona:

1. Cerca un record che corrisponde ai tuoi criteri
2. Se trovato → aggiorna il record esistente
3. Se non trovato → crea un nuovo record

Output: I dati del record creato o aggiornato sono disponibili per l’uso nei passaggi successivi.

​

Azioni del flusso

​

Iteratore

Esegue un ciclo su un array di record restituito da un passaggio precedente, consentendo di eseguire azioni su ciascun record individualmente. Configurazione:

• Seleziona l’array di record da un passaggio precedente (ad es., risultati da Search Records, da un trigger Manual con disponibilità Bulk, da un nodo di codice). Quando un passaggio di tipo Code o Logic Function restituisce un array di primo livello, seleziona l’opzione Whole list per eseguire il loop su tutto l’output.
• Definisci le azioni da eseguire su ciascun record nel ciclo.

• Accedi ai campi di Current Item: per utilizzare i campi del record attualmente in elaborazione, fai clic sul passaggio Iterator, quindi seleziona Current item. Verrà visualizzato l’elenco dei campi disponibili di quel record e potrai selezionarli per l’uso nelle azioni successive. Puoi anche selezionare Use the whole item per passare l’intero elemento corrente a un passaggio a valle.

​

Filtro

Filtra i record in base a condizioni specificate, consentendo il passaggio solo ai record che soddisfano i criteri. Configurazione:

• Seleziona il record da filtrare
• Definisci le condizioni e i criteri di filtro
• Configura quali record devono passare ai passaggi successivi

​

Ritardo

Mette in pausa l’esecuzione del flusso di lavoro per una durata specificata o fino a una data/ora specifica. Tipi di ritardo: Configurazione della durata:

• Imposta giorni, ore, minuti e/o secondi
• Combina più unità (ad es., 2 giorni e 4 ore)

Configurazione della data programmata:

• Seleziona una data e un’ora
• Può fare riferimento a un campo data di un passaggio precedente (ad es., follow-up 3 giorni dopo una riunione)

Casi di utilizzo:

• Attendi 24 ore prima di inviare un’email di follow-up
• Metti in pausa fino alla data di chiusura di un’opportunità
• Pianifica azioni per l’orario lavorativo

Limiti e crediti:

• Nessun limite massimo di durata — puoi impostare ritardi di minuti, giorni, settimane o oltre
• 1 credito consumato quando il nodo Ritardo viene eseguito, indipendentemente dalla durata
• Nessun credito consumato durante l’attesa — un ritardo di 5 minuti costa come un ritardo di 5 giorni

​

Azioni di comunicazione

​

Invia email

Invia un’email dal tuo flusso di lavoro. Ottimo per email di gruppo basate su modelli. Le email avranno l’aspetto di quelle inviate dalla tua casella di posta. Non adatto a newsletter (che richiedono una formattazione più ricca) o a sequenze di email automatizzate. Prerequisiti: Aggiungi un account email in Impostazioni → Account Configurazione:

• Seleziona l’account email del mittente

Per tutti i passaggi seguenti, puoi fare riferimento a variabili dei passaggi precedenti per la personalizzazione.

• Inserisci l’indirizzo email del destinatario.

• Imposta l’oggetto della email.
• Componi il corpo del messaggio. Puoi formattare i link, creare elenchi numerati, elenchi puntati, aggiungere allegati.

​

Modulo

Visualizza un modulo durante l’esecuzione del flusso di lavoro per raccogliere l’input dell’utente. Le risposte possono quindi essere utilizzate nei passaggi successivi per creare record, inviare email o eseguire qualsiasi altra azione basata sull’input. Configurazione:

• Configura i campi che verranno chiesti agli utenti di compilare. Per ogni campo, scegli
  • un tipo tra testo, numero, data, un determinato record, un campo di selezione. I campi di selezione di tutti gli oggetti sono disponibili.
  • un’etichetta
  • un valore predefinito sotto Placeholder (opzionale)
• Modifica il titolo del modulo

Output: Le risposte ai moduli sono disponibili per l’uso in passaggi successivi. Esempio: Il flusso di lavoro “Quick Lead” è disponibile per impostazione predefinita in tutti gli spazi di lavoro, disponibile ovunque nel Menu Comandi Cmd + K. Come compilare il modulo:

• Attiva il tuo flusso di lavoro manuale dal menu comandi Cmd K
• Compila il modulo visualizzato nel pannello laterale e fai clic su Submit.

​

Azioni di integrazione

​

Codice

Esegue JavaScript personalizzato all’interno del tuo workflow. In background, ogni azione Code è supportata dalla propria logic function, una funzione TypeScript lato server che viene eseguita sulla piattaforma Twenty. Quando aggiungi un’azione Code, Twenty crea una logic function dedicata per quel passaggio e ne espone l’editor inline, in modo che il codice che scrivi rimanga all’interno del flusso di lavoro. Configurazione:

• Accedi alle variabili dai passaggi precedenti. Puoi modificare dinamicamente i nomi delle variabili.

• Scrivi il codice JavaScript nell’editor
• Restituisci variabili per l’uso in passaggi successivi
• Verifica il codice direttamente nel passaggio

​

Riutilizzare una logic function tra i flussi di lavoro

L’azione Code inline è ideale per la logica “usa e getta”, ma il codice che contiene appartiene a quel singolo passaggio. Quando vuoi condividere la stessa logica tra vari flussi di lavoro o mantenerla come sorgente versionata in un’app, definisci una reusable logic function al posto di copiare e incollare il codice in ogni azione Code. Una logic function è definita una volta in un’app (usando l’SDK defineLogicFunction) ed esposta al generatore di flussi di lavoro aggiungendo workflowActionTriggerSettings. Una volta installata l’app, quella funzione compare come azione autonoma nel generatore di flussi di lavoro, insieme alle azioni integrate. Selezionandola, vengono mostrati i campi di input che hai dichiarato (con i selettori di variabili, proprio come per le altre azioni) e viene eseguito il tuo codice condiviso, senza bisogno di JavaScript inline. Entrambe vengono eseguite sullo stesso runtime di logic function, quindi un’azione Code che hai prototipato inline può in seguito essere trasformata in una reusable logic function con modifiche minime.

​

Richiesta HTTP

Invia una richiesta a un API esterno come parte del tuo workflow. Configurazione:

• Inserisci l’URL del punto finale dell’API. È possibile utilizzare parametri dai passaggi precedenti.
• Seleziona metodo HTTP (GET, POST, PUT, PATCH, DELETE)
• Aggiungi intestazioni e valori richiesti
• Fornisci una risposta di esempio per l’anteprima della struttura

​

Azioni AI

​

Agente AI - In arrivo

Esegue un agente AI all’interno del tuo flusso di lavoro per svolgere attività intelligenti. Configurazione:

• Agente: Seleziona un agente AI esistente o usa l’agente predefinito
• Prompt: Scrivi l’istruzione per l’agente AI
• Fai riferimento a variabili dei passaggi precedenti nel prompt

Cosa possono fare gli agenti AI:

• Analizzare e riassumere dati
• Classificare o categorizzare i record
• Generare contenuti testuali
• Prendere decisioni basate sui dati
• Interagire con i dati del tuo CRM utilizzando strumenti

Output: La risposta dell’agente AI è disponibile per l’uso nei passaggi successivi. Se l’agente ha uno schema di output strutturato, la risposta seguirà tale formato.