L'azione Aggiorna Campo Contatto del Workflow ti permette di scrivere nuovi valori nei campi standard o personalizzati di un contatto — oppure di cancellare i valori nei campi personalizzati — direttamente da un Workflow. Con l'ultimo aggiornamento puoi usare Valori Dinamici per ulteriori tipi di campo, consentendo al Workflow di impostare valori live da step precedenti o da campi salvati, senza dover digitare manualmente testo o numeri.

INDICE DEI CONTENUTI

Panoramica

L'azione Aggiorna Campo Contatto di HITLEAD aggiorna i dati di un contatto nel momento esatto in cui il Workflow viene eseguito. Puoi scegliere di aggiornare un campo con un valore oppure di cancellare un valore esistente; tutte le modifiche sono visibili nei Log di esecuzione.

Questa azione viene usata comunemente per mantenere i dati dei Contatti accurati ai fini di personalizzazione, segmentazione, Reportistica e logica downstream del Workflow.

Come aggiungere l'azione Aggiorna Campo Contatto

  1. Vai su Automation → Workflows.
  2. Apri un Workflow esistente oppure creane uno nuovo.
  3. Clicca sull'icona + nel punto in cui vuoi aggiungere un'azione.
  4. Dal pannello delle azioni, seleziona Update Contact Field.

Schermata 1 — Azione Workflow - Aggiorna Campo Contatto

Configurazione dell'azione

Nome dell'azione

Assegna all'azione un nome descrittivo, così sarà facile riconoscerla nel canvas del Workflow e nei Log di esecuzione.

Schermata 2 — Azione Workflow - Aggiorna Campo Contatto

Seleziona il tipo di azione

Scegli come deve comportarsi l'azione. La selezione determina quali opzioni di configurazione vengono mostrate.

Opzioni del tipo di azione:

  • Update field data – scrive un nuovo valore in un campo
  • Clear field data – rimuove il valore memorizzato (solo campi personalizzati)

Schermata 3 — Azione Workflow - Aggiorna Campo Contatto

Aggiorna i dati del campo

Usa questa modalità per sovrascrivere il valore di un campo del contatto.

  1. Seleziona il campo del contatto che vuoi aggiornare.
  2. Inserisci un valore usando:
    • Un valore statico, oppure
    • Un Valore Dinamico (dati live dal Workflow o dal contatto)

Il nuovo valore sostituisce quello esistente nel momento in cui il Workflow raggiunge questo step.

Schermata 4 — Azione Workflow - Aggiorna Campo Contatto

Cancella i dati del campo

Usa questa modalità per rimuovere il valore memorizzato in un campo personalizzato del contatto.

  1. Scegli Clear field data come tipo di azione.
  2. Seleziona uno o più campi personalizzati da svuotare.
  3. Quando l'azione viene eseguita, il valore del campo viene impostato su vuoto.

Attenzione: La cancellazione dei valori può influire sulle Smart List, sui filtri e sulle condizioni dei Workflow. Verifica sempre le dipendenze prima di pubblicare.

Usare i Valori Dinamici in Aggiorna Campo Contatto

Ora puoi usare i Valori Dinamici per impostare i campi del contatto usando output live di step precedenti del Workflow o campi del contatto salvati. Questo elimina la necessità di digitare valori manualmente e di duplicare la logica.

I Valori Dinamici vengono risolti a runtime per ogni singolo contatto.

Tipi di campo supportati

I Valori Dinamici sono supportati per i seguenti tipi di campo in Update Contact Field:

  • Numerico – punteggi, contatori
  • Select / Dropdown (non è richiesto l'ID opzione in questo contesto)
  • Monetario – totali, importi

Importante: I campi Select / Dropdown non richiedono l'ID opzione quando si aggiornano i campi del contatto. (Questo è diverso dalle condizioni If/Else, dove invece l'ID opzione è obbligatorio.)

Come usare i Valori Dinamici

  1. Aggiungi un'azione Update Contact Field al tuo Workflow.
  2. Scegli Update field data come tipo di azione.
  3. Seleziona il campo del contatto di destinazione.
  4. Nel campo del valore, passa a Dynamic Value.
  5. Scegli un valore tra:
    • L'output di uno step precedente del Workflow, oppure
    • Un campo del contatto salvato.
  6. Salva e pubblica il Workflow.

Esempio d'uso

Dopo che un paziente conferma un appuntamento, il Workflow acquisisce il tipo di conferma (ad esempio, Follow-up o Nuova visita). Quel valore viene poi scritto dinamicamente in un campo personalizzato del contatto, mantenendo i dati accurati e garantendo l'invio della comunicazione di follow-up corretta.

Aggiornare più campi contemporaneamente

Puoi aggiornare più di un campo in una singola azione:

  • Clicca su Add field per aggiungere ulteriori righe di campo.
  • Per maggiore chiarezza e facilità di audit, alcuni team preferiscono usare azioni separate per Update e Clear.

Considerazioni sui tipi di campo e validazione

Per evitare errori, assicurati che i valori corrispondano al tipo di campo:

  • Testo / Numero: Usa i formati appropriati.
  • Data: Usa valori data validi o valori dinamici basati su data.
  • Dropdown / Checkbox / Radio: Il valore deve corrispondere a un'opzione esistente.
  • Email / Telefono: Fornisci valori nel formato corretto.

I campi devono esistere già. Questa azione non crea nuovi campi.

Domande frequenti

D: Posso aggiornare campi standard del contatto come Email o Telefono?

Sì. L'opzione Update field data supporta sia i campi standard che quelli personalizzati del contatto.

D: Posso cancellare i campi standard del contatto?

No. L'opzione Clear field data supporta solo i campi personalizzati del contatto.

D: Posso aggiornare più campi in una sola azione?

Sì. Usa Add field per aggiornare più campi nella stessa azione.

D: Qual è la differenza tra Valori Dinamici e token?

I Valori Dinamici ti permettono di selezionare output live da step precedenti del Workflow o da campi. I token continuano a funzionare, ma i Valori Dinamici eliminano la necessità di digitare o mappare i valori manualmente.

D: Cosa succede se uso il formato sbagliato?

L'aggiornamento potrebbe non superare la validazione. Controlla i tipi di campo e verifica i Log di esecuzione.

D: La cancellazione di un valore influirà sulle Smart List o sui Workflow?

Sì. La cancellazione di un valore può cambiare l'appartenenza alle liste o la logica di branching.

Articoli correlati

  • Azione Workflow – If/Else
  • Azione Workflow – Wait