Guida completa ai Custom Field, ai Custom Values e ai codici dinamici (merge fields) utilizzati in tutte le funzioni della piattaforma

Introduzione

Koachify Suite permette di personalizzare ogni comunicazione tramite campi dinamici.
Questi campi sono inseriti nei testi, nelle email, nei funnel, nei messaggi WhatsApp/SMS e nelle automazioni, per mostrare informazioni uniche e personalizzate per ogni singolo utente.

I campi dinamici funzionano attraverso codici come:

Questi codici vengono “sostituiti” da Koachify con i dati reali del contatto o dell’account.

In Koachify esistono:

Custom Field → campi del contatto (sia quelli già presenti che quelli che crei tu)
Custom Values → valori globali del tuo account (creati manualmente da te)
Campi dinamici di sistema → non visibili nelle impostazioni, ma disponibili quando stai scrivendo messaggi o impostando automazioni

Tutti questi elementi vengono inseriti attraverso strumenti specifici presenti nei vari editor.

1. Custom Field (Campi del contatto)

I custom field sono tutti i campi presenti nel profilo di un contatto, sia quelli standard (es. nome, email) sia quelli creati da te per raccogliere informazioni extra.

Esempi di custom field preesistenti:

{{contact.first_name}}
{{contact.last_name}}
{{contact.email}}
{{contact.phone}}
{{contact.attribution_source_first}}
{{contact.attribution_source_latest}}
{{contact.created_at}}

Esempi di custom field creati dall’utente:

obiettivo_principale
tipo_servizio
punteggio_quiz
fase_progetto
interesse_primario

Quando crei un nuovo campo, Koachify genera automaticamente il suo codice dinamico utilizzabile nei contenuti.

Puoi vedere e gestire i tuoi custom field in:
Contatti → Impostazioni Campi

💡 Nota importante:
I campi dinamici di sistema (es: appuntamenti, membership, calendari, quiz, ecc.) non compaiono qui, perché sono campi interni generati automaticamente dal sistema.

2. Custom Values (Valori globali dell’account)

I custom values servono per memorizzare informazioni che NON riguardano il contatto, ma il tuo business.

Esempi di custom values:

Nome azienda
Firma email
Link calendario
Link funnel principale
Link WhatsApp opt-in
Orari supporto
Indirizzo aziendale

Come funzionano i custom values

Li crei tu manualmente
Dai loro un nome
Il sistema genera automaticamente il relativo codice dinamico
Puoi inserirli ovunque

Esempio:

Puoi gestirli in:
Impostazioni → Custom Values

3. Campi dinamici di sistema (visibili solo contestualmente)

Esistono moltissimi campi dinamici “nascosti”, non elencati nell’area impostazioni.

Questi campi compaiono SOLO quando sei nell’editor corretto.

Esempi:

Campi appuntamento (disponibili solo nelle notifiche o automazioni appuntamenti)

Campi membership / corsi / E-learning (disponibili nelle automazioni relative)

Campi flussi conversazionali, WhatsApp, ecc.

Questi campi non sono modificabili e non si trovano nell’area dei Custom Field:
appartengono al motore interno di Koachify.

4. Come inserire i campi dinamici (le icone corrette)

🔹 4.1 Nelle email, nei funnel e nei testi

Quando scrivi un testo (email, pagina, sezione del funnel), nell’editor appare un’icona che sembra:

👉 un pulsante rettangolare con una barra verticale sulla sinistra

Cliccandolo vedrai:

tutti i custom field disponibili
tutti i custom values
tutti i campi dinamici contestuali che Koachify permette in quel punto

Questa è la modalità corretta per inserire codici nei testi.

🔹 4.2 Nelle automazioni e nelle condizioni

Nelle azioni delle automazioni (es. “Invia Email”, “Invia WhatsApp”, “Aggiungi Tag”, “Aggiungi Nota”), compare un’icona:

👉 a forma di etichetta da vestito

Cliccando l’icona potrai:

inserire custom field
inserire custom values
inserire campi contestuali (appuntamento, corso, membership, pipeline, ecc.)

Questo è essenziale per:

tag dinamici
note personalizzate
messaggi automatici
routing personalizzato

5. Dove puoi usare i campi dinamici in Koachify Suite

✔️ Email Marketing

Personalizzazioni rapide:

Ciao {{contact.first_name}}, abbiamo ricevuto la tua richiesta.

✔️ Funnel e landing

Esempio:

Benvenuto {{contact.first_name}} nella tua area riservata!

✔️ WhatsApp 2.0 e SMS

Messaggi personalizzati:

Ciao {{contact.first_name}}, ecco il link richiesto: {{custom_values.link_funnel}}

✔️ Automazioni

Esempio di tag dinamico:

source_{{contact.attribution_source_first}}

✔️ Calendari e notifiche

Il tuo appuntamento è confermato per {{appointment.start_time}}.

✔️ Quiz e Sondaggi

Hai ottenuto: {{contact.quiz_score}}

✔️ Area E-Learning

Per mostrare dati personalizzati dentro contenuti e percorsi.

6. Esempi pratici

✉️ Email di benvenuto

Ciao {{contact.first_name}},

grazie per esserti registrato.

A presto,

🏷️ Tag dinamico per la sorgente

Azione → Aggiungi tag (modalità dinamico):

source_{{contact.attribution_source_first}}

📅 Promemoria appuntamento

Il tuo appuntamento è il {{appointment.start_time}}.

🧪 Risultati quiz

Punteggio finale: {{contact.quiz_score}}

7. Best practice per usare i campi dinamici

✔️ Non scrivere a mano i codici dei custom values

Koachify li genera automaticamente.

✔️ Usa l’editor corretto

Email/funnel → pulsante rettangolare
Automazioni → icona etichetta

✔️ Testa sempre con l’anteprima

Molti errori provengono da campi che il contatto non ha compilato.

✔️ Evita troppi campi dinamici nei messaggi commerciali

Meglio personalizzazioni semplici e chiare.

✔️ Mantieni un naming coerente per i custom field

Evita spazi, usa underscore.

Conclusione

I campi dinamici sono uno degli strumenti più potenti di Koachify Suite.
Permettono di:

personalizzare ogni comunicazione
attivare automazioni intelligenti
generare tag dinamici
mostrare contenuti personalizzati nei funnel
creare quiz e percorsi avanzati
ottimizzare l’esperienza automatizzata per ogni utente

Una volta compresi, diventano fondamentali per lavorare in modo scalabile, preciso e professionale.

Correlato a

Ricerca

Benvenuto nell'area Supporto Clienti

Come personalizzare testi, email e automazioni con i campi dinamici in Koachify Suite