il blog delle automazioni

Custom field GoHighLevel: contatto o opportunità, e perché non lo trovi in un form

Sommario

La risposta diretta

Un custom field GoHighLevel appartiene a un oggetto specifico: contatto oppure opportunità. Questa scelta è permanente. Se crei un campo sull’oggetto sbagliato, non esiste un pulsante per convertirlo: va eliminato e ricreato sull’oggetto corretto. I campi opportunità non compaiono nei form di contatto, e viceversa.

Perché esiste questa distinzione

GoHighLevel separa i dati in due livelli. Il contatto è la persona: il suo numero di telefono, la fonte da cui è arrivato, la data di nascita. L’opportunità è la trattativa specifica: il budget dichiarato, l’urgenza, i tempi di chiusura stimati. Una persona può avere più opportunità aperte contemporaneamente. I dati del contatto rimangono stabili; i dati dell’opportunità cambiano a ogni deal.

Se stai raccogliendo informazioni che appartengono alla persona indipendentemente dalla trattativa, il campo va sull’oggetto contatto. Se stai raccogliendo informazioni che hanno senso solo dentro una pipeline specifica, il campo va sull’oggetto opportunità. Sbagliare questo passaggio è la causa principale per cui un campo sembra sparire dopo la creazione.

Per un quadro completo di come funziona GoHighLevel come sistema, la guida completa in italiano su GoHighLevel copre anche la logica degli oggetti e delle pipeline.

Schema a due colonne che distingue i dati del contatto dai dati dell

Come creare un custom field GoHighLevel: i passi

Il percorso è: Settings → Custom Fields. Da lì vedi l’elenco di tutti i campi esistenti, divisi per oggetto.

Prima di cliccare su «Create field», cerca nell’elenco se ne esiste già uno equivalente. GoHighLevel viene precaricato con diversi campi standard e, nel tempo, un sub-account accumula campi creati da colleghi o importati tramite snapshot. Un campo duplicato con nome leggermente diverso è un problema che si porta dietro per sempre: i merge field puntano a chiavi diverse, i filtri restituiscono risultati parziali, i report mostrano dati spezzati.

Scegliere l’oggetto

In alto nella schermata Custom Fields c’è un selettore che ti permette di passare tra contatti e opportunità. Assicurati di essere sull’oggetto giusto prima di procedere. Quello che selezioni qui determina dove il campo sarà disponibile per sempre.

Scegliere il tipo di campo

Il tipo di campo determina cosa può contenere e come viene visualizzato. Le opzioni principali includono: testo su una riga, testo lungo, numero, valuta (Monetary), menu a tendina, radio button, checkbox, selettore di data, upload di file, firma. I campi opportunità supportano anche tipi estesi come link e utente assegnato.

Il tipo non si cambia dopo la creazione, esattamente come l’oggetto. Scegli quello che serve davvero, non quello che sembra più flessibile al momento.

Compilare il form di creazione

I campi da compilare sono:

  • Field name: il nome visibile nell’interfaccia
  • Cartella di appartenenza (opzionale, ma utile se hai molti campi)
  • Key: l’identificativo tecnico del campo
  • Descrizione e testo segnaposto

Controlla la Live preview prima di salvare. Clicca «Create custom field» per concludere.

Compilazione di un form con attenzione alla Key del custom field GoHighLevel

La Key: a cosa serve davvero

La Key è l’identificativo interno del campo, generata automaticamente dal nome ma modificabile prima del salvataggio. È quello che usano i merge field nelle email e negli SMS, i filtri nei workflow e le integrazioni esterne via API.

Se scrivi una Key illeggibile o lasci quella generata da un nome con caratteri speciali, la trovi poi dentro i template e non capisci a quale campo corrisponde. Usare una Key leggibile e consistente — per esempio contact.fonte_referral o opportunity.budget_dichiarato — ti risparmia ore di debug sui workflow.

L’articolo su custom value e custom field su GoHighLevel approfondisce la differenza tra i due tipi di dato e quando usare l’uno o l’altro.

La regola

La Key non si cambia in sicurezza dopo che il campo è in produzione

Se la Key è già usata in template, workflow o integrazioni, cambiarla rompe tutti quei riferimenti in silenzio. Nessun errore visibile: i merge field restituiscono semplicemente stringa vuota.

  • Key leggibile subito — sceglila al momento della creazione, non dopo
  • Formato consistente — usa uno schema fisso per tutta la sub-account
  • Mai cambiare in produzione — se serve un nome diverso ricrea il campo con la Key corretta

Perché il campo non compare nel form o nel workflow

La causa quasi sempre è l’oggetto. I form di GoHighLevel raccolgono dati del contatto: mostrano solo i campi con oggetto contatto. Se hai creato un campo opportunità aspettandoti di vederlo nel form builder, non lo troverai.

Lo stesso vale per i workflow di tipo contatto: i filtri, le azioni «Update Contact Field» e i merge field di contatto leggono solo i campi contatto. Un campo opportunità è invisibile in quel contesto, non perché sia nascosto, ma perché appartiene a un oggetto diverso.

Tabella: dove compare ogni tipo di campo

Contesto Campi contatto Campi opportunità
Form builder Sì No (salvo form con sezione opportunità)
Workflow — Update Contact Field Sì No
Workflow — Update Opportunity Field No Sì
Pipeline / scheda opportunità No Sì
Merge field nelle email Sì (con prefisso contact) Sì (con prefisso opportunity)

Altre trappole frequenti

Campi con nomi simili o doppi: se hai «Budget» e «Budget cliente» sull’opportunità, il rischio di puntare al campo sbagliato nei workflow è alto. Prima di creare, filtra l’elenco.

Merge field e filtri che restituiscono vuoto: questo non significa che il campo non esiste o che sia rotto. Significa che quel contatto o quell’opportunità non ha ancora un valore per quel campo. Un campo vuoto è silenzioso per definizione — non genera errori, non avvisa nessuno. I workflow che dipendono da campi custom devono avere una guardia: controlla che il campo abbia un valore prima di usarlo in un’azione critica.

GoHighLevel

Hai 14 giorni per testare i custom field su un caso reale

Inizia creando tre campi contatto con Key leggibile e usali in un form e in un workflow. Nella seconda settimana ripeti la stessa cosa con i campi opportunità nella pipeline.

  • Settimana 1 — Crea i campi contatto, collegali a un form e verifica che il merge field funzioni in un’email
  • Settimana 2 — Crea i campi opportunità, aggiungili alla scheda pipeline e usa Update Opportunity Field in un workflow

Attiva la prova di 14 giorni →

Link di affiliazione: se ti iscrivi da qui io prendo una commissione, tu paghi uguale. Lo linko perché ci lavoro dentro ogni giorno.

Le cartelle: ordine prima che serva

Con pochi campi le cartelle sembrano inutili. Con trenta campi per oggetto diventano l’unico modo per trovare quello che cerchi senza scorrere tutto l’elenco. Il percorso è Settings → Custom Fields → scheda Folders → Create folder.

Una struttura ragionevole raggruppa i campi per area funzionale: qualificazione, dati contrattuali, preferenze di comunicazione. Non per chi li ha creati e non per data di creazione.

Il caso del form opportunità

GoHighLevel permette di aggiungere una sezione opportunità a un form, in modo che un singolo invio crei sia il contatto sia l’opportunità. In quel contesto i campi opportunità diventano visibili nel form builder, ma solo nella sezione dedicata all’opportunità.

Se stai usando questa funzione e vuoi che il visitatore inserisca un importo variabile, hai bisogno di un custom field opportunità di tipo numerico o valuta: il campo «Opportunity Value» standard è fisso nelle impostazioni del form e non si compila dal front-end. Questo è uno di quei casi in cui la distinzione contatto/opportunità smette di essere astratta e diventa un problema concreto da risolvere prima di pubblicare il form.

Per approfondire come funziona il form builder di GoHighLevel, l’articolo su form GoHighLevel con ordine a zero mostra un caso pratico di configurazione avanzata.

Cosa fare se il campo è sull’oggetto sbagliato

Non esiste una funzione di conversione. Il percorso è: esporta i valori esistenti se ne hai già (dai contatti o dalle opportunità tramite il modulo di esportazione), elimina il campo sbagliato, crea il nuovo campo sull’oggetto corretto con la Key che ti serve, aggiorna tutti i workflow, template e integrazioni che puntavano alla vecchia Key.

È un lavoro noioso e il rischio di lasciare un riferimento orfano è reale. Per questo la scelta dell’oggetto al momento della creazione non è un dettaglio: è la decisione che determina tutto il resto. Se non sei sicuro, chiediti: questo dato descrive la persona o descrive questa trattativa specifica?

Questa stessa logica — strutturare prima, poi costruire — vale per ogni componente di GoHighLevel che tocchi i dati: i campi rotti o mal configurati si propagano nei snapshot e nei workflow senza generare errori visibili. Il silenzio non è salute.

Domande frequenti

Posso convertire un custom field da contatto a opportunità su GoHighLevel?

No. L’oggetto assegnato al momento della creazione è permanente. Per cambiarlo bisogna eliminare il campo esistente e ricrearlo sull’oggetto corretto. Tutti i riferimenti alla vecchia Key nei workflow e nei template vanno aggiornati manualmente.

Cos’è la Key di un custom field GoHighLevel e dove si usa?

La Key è l’identificativo tecnico del campo. I merge field nelle email e negli SMS la usano per richiamare il valore. I filtri nei workflow e le integrazioni via API la usano per leggere e scrivere il campo. Va definita in modo leggibile prima di mettere il campo in produzione.

Perché il merge field di un custom field restituisce stringa vuota?

Perché quel contatto o quell’opportunità non ha ancora un valore per quel campo. Un campo vuoto non genera errori: restituisce silenzio. Nei workflow che dipendono da quel valore aggiungi una condizione che verifica se il campo è compilato prima di procedere.

I campi opportunità compaiono nei form GoHighLevel?

Solo se il form ha una sezione dedicata all’opportunità abilitata. In quel caso i campi opportunità sono disponibili nella sezione specifica del form builder. In un form standard che crea solo contatti, i campi opportunità non compaiono.

Trasparenza: in questo articolo c’è un link di affiliazione. Se ti iscrivi da lì io ricevo una commissione, per te non cambia niente. Linko solo strumenti che uso in produzione.

Iscriviti GRATIS a Gohighlevel

Il miglior software per scalare il tuo business. Se mi contatti dopo la prova gratuita dimostrando che ti sei iscritto con il mio link, hai una consulenza gratuita.

Hai domande?

Ogni tuo dubbio è un’opportunità per me di aiutarti.

Angelo Marcoccia

CHI SONO

Ho passato gli ultimi anni a costruire i sistemi che hanno portato un business da zero a oltre un milione di euro al mese — acquisizione, vendita, delivery e dati, tutto automatizzato. Oggi progetto gli stessi sistemi per infobusiness e agenzie che vogliono crescere senza esplodere di operatività. Quello che consiglio, lo so costruire con le mie mani.

INIZIA A CAPIRCI QUALCOSA

Mettiamoci in contatto

LEGGI IL BLOG SUlle automazioni

AUTOMATIZzA IL TUO BUSINESS