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 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.

​

Seleziona record

Seleziona un singolo record da un elenco di candidati, utilizzando una strategia di distribuzione. Utile per assegnare un lead in entrata a un rappresentante commerciale o per distribuire i record tra un insieme di assegnatari. Configurazione::

• Seleziona i record candidati nel campo Scegli da

• Scegli una strategia:

• Per Bilanciato in base al carico, seleziona l’oggetto e il campo utilizzati per contare il carico esistente per candidato

Output: Il record selezionato è disponibile 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:

• Selezionare l’array di record da un passo precedente (ad esempio, risultati da record di ricerca, da un trigger manuale con disponibilità di massa, da un nodo 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
• 0.0001 credito ($0.0001) consumato quando viene eseguito il nodo Ritardo, come un passaggio standard del workflow, 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 per le newsletter (che richiedono una formattazione più ricca) o le sequenze automatiche di posta elettronica. 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. È possibile formattare i collegamenti, creare liste numerate, elenchi punti puntati e aggiungere allegati.

​

Bozza di email

Crea una bozza di email invece di inviarla. Stessa configurazione di Invia email, ma il messaggio viene salvato nella cartella Bozze della casella di posta collegata per la revisione e l’invio manuali, anziché essere inviato automaticamente. Configurazione: Stessi campi di Invia email — account del mittente, destinatario, oggetto e corpo. Caso d’uso: email generate dall’AI o dal workflow che vuoi far revisionare a una persona prima dell’invio.

​

Crea evento calendario

Crea un evento in un calendario collegato. Configurazione:

• Seleziona l’account del calendario collegato
• Imposta il titolo, la descrizione e la posizione dell’evento
• Imposta data/ora di inizio e fine oppure contrassegna l’evento come per l’intera giornata
• Facoltativamente, imposta un fuso orario
• Aggiungi partecipanti
• Scegli se inviare inviti del calendario ai partecipanti
• Scegli se aggiungere un link per conferenza all’evento

Output: I dati dell’evento creato sono disponibili per l’uso nei passaggi successivi.

​

Modulo

Apre un modulo per la persona che avvia il flusso di lavoro, per raccogliere input sul momento. 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 tutti gli oggetti sono disponibili per la selezione.
  • un’etichetta
  • un valore predefinito sotto Placeholder (opzionale)
• Modifica il titolo del modulo
• Aggiungi istruzioni visualizzate sopra i campi (facoltativo). Possono includere variabili dei passaggi precedenti, ad esempio il nome del record a cui si riferisce il 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 dei comandi Cmd+K. Come compilare il modulo:

• Attiva il tuo flusso di lavoro manuale dal menu dei 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. È possibile modificare i nomi delle variabili dinamicamente.

• 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

Limiti: la richiesta non riesce se richiede più di 30 secondi o se il corpo della richiesta o della risposta supera 10 MB.

​

Azioni AI

​

Agente AI

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.

​

Classifica

Chiede a un modello AI di rispondere a una o più domande strutturate sui dati dei passaggi precedenti, ad esempio assegnando un punteggio a un lead o categorizzando un messaggio in entrata. A differenza di AI Agent, Classifica restituisce sempre un valore nella forma definita, quindi è adatto per guidare i rami in modo deterministico. Configurazione::

• Input: I dati da classificare (ad esempio, un record o testo da un passaggio precedente)
• Domande: Aggiungi una o più domande, ciascuna con:
  • Un nome — utilizzato per leggere la risposta a valle (ad esempio, {{stepId.answers.<name>}})
  • Un tipo: boolean, choice o score
  • Istruzioni per il modello
  • Criteri — le possibili scelte o i livelli di punteggio dal più basso al più alto (non necessario per boolean)

Output: La risposta a ciascuna domanda, indicizzata in base al relativo nome, oltre al modello utilizzato.