Creare e modificare oggetti personalizzati
Ultimo aggiornamento: 25 agosto 2025
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
|
|
|
|
|
Se la vostra azienda richiede una relazione o un processo che va oltre gli oggetti standard del CRM, potete creare un oggetto personalizzato. Gli utenti con permessi di superamministrazione negli account Enterprise possono definire un oggetto personalizzato nelle impostazioni dell'oggetto personalizzato o tramite API.
Una volta definito, è possibile creare proprietà, gestire pipeline e personalizzare le associazioni tra oggetti personalizzati e altri oggetti. È inoltre possibile utilizzare gli oggetti personalizzati in altri strumenti di HubSpot, come e-mail di marketing, flussi di lavoro e report.
Attenzione: a seconda dell'abbonamento, ci sono limiti al numero di oggetti e proprietà personalizzate che si possono avere. Per saperne di più sui limiti, consultate il nostro catalogo dei prodotti e servizi HubSpot.
Prima di iniziare
Prima di definire un oggetto personalizzato, è importante valutare se è l'opzione corretta per la vostra azienda e per la qualità dei vostri dati in HubSpot.
Alcune domande da considerare prima di creare un oggetto personalizzato sono:
- È possibile utilizzare un oggetto CRM esistente e le sue proprietà per organizzare i dati invece di un oggetto personalizzato?
- Potrebbero esserci sovrapposizioni o incoerenze di dati tra l'oggetto personalizzato e un oggetto esistente?
- Ci sono caratteristiche esclusive degli oggetti esistenti che si desidera utilizzare? Ad esempio, le e-mail di marketing possono essere inviate solo ai contatti, non ad altri oggetti.
- Esistono report precostituiti collegati agli oggetti esistenti che si desidera utilizzare? Ad esempio, i report di attribuzione delle transazioni e le previsioni di vendita sono collegati direttamente alle transazioni, non ad altri oggetti.
Per comprendere le relazioni tra gli oggetti e i dati esistenti, è possibile visualizzare una panoramica del modello di dati dell'account. Per ulteriori indicazioni su quando creare un oggetto personalizzato, consultare questa lezione della HubSpot Academy o rivolgersi al proprio Customer Success Manager.
Glossario
Ci sono alcuni termini e concetti che è bene conoscere prima di creare un oggetto personalizzato.
- Nome dell'oggetto: il titolo dell'oggetto personalizzato. Vi verrà chiesto di definire un nome plurale e un nome singolare. Ad esempio, Aziende è un nome plurale dell'oggetto, mentre Azienda è il nome singolare dell'oggetto.
- Proprietà di visualizzazione primaria: la proprietà utilizzata per denominare un record dell'oggetto. È la principale proprietà identificativa dell'oggetto e può essere utilizzata per cercare i record nella pagina dell'indice. Per impostazione predefinita, appare come prima colonna nella pagina dell'indice dell'oggetto e in alto a sinistra su ogni record. Ad esempio, Nome della società è la proprietà principale di visualizzazione per le società.
- Etichetta: il nome della proprietà come appare nel CRM HubSpot, ad esempio nei record o nelle pagine di indice. Ad esempio, la proprietà aziendale Nome azienda è l'etichetta. Le etichette delle proprietà sono soggette a modifiche e non devono essere utilizzate da integrazioni o API.
- Nome interno: il valore interno di una proprietà che viene utilizzato da integrazioni o API. Ad esempio, il valore interno della proprietà Company name è
name
. I nomi interni non possono essere modificati, pertanto devono essere utilizzati dalle integrazioni e dalle API per fare riferimento alla proprietà.
- Proprietà secondarie: proprietà aggiuntive di identificazione di un oggetto. Queste proprietà appaiono nella scheda del profilo di un record sotto la proprietà di visualizzazione primaria. Possono anche essere utilizzate per cercare i record nella pagina dell'indice. Per gli oggetti personalizzati, appaiono anche come filtri rapidi aggiuntivi nella pagina dell'indice. Ad esempio, le proprietà secondarie per le Aziende sono Nome di dominio dell'azienda e Numero di telefono, mentre una proprietà secondaria personalizzata per gli Animali domestici potrebbe essere Tipo di animale domestico.
Esempi
Gli esempi che seguono si basano su casi d'uso comuni per aiutare a capire come un oggetto personalizzato possa influire sui dati di un account, ma non sono da intendersi come consigli per ogni scenario. Per sapere se un oggetto personalizzato è adatto al vostro caso d'uso specifico, contattate il vostro Customer Success Manager.
I seguenti sono buoni esempi di oggetti personalizzati:
- Un allevamento di animali domestici vuole tenere traccia degli animali in pensione, associare ogni animale ai suoi proprietari e tenere traccia delle attività relative a ciascun animale. Crea un oggetto Pets con il nome dell'animale come proprietà principale e il tipo di animale come proprietà secondaria. Visualizzano e cercano gli animali con cui lavorano in una pagina indice, salvano le viste in base al tipo di animale, associano i contatti a un animale e gestiscono le attività e gli appuntamenti all'interno del record di un animale.
- Una concessionaria di auto vuole mantenere un database delle auto attualmente in inventario o vendute e tenere traccia delle richieste di vendita relative a ciascuna auto. Crea un oggetto Cars con Model come proprietà principale di visualizzazione. Creano una pipeline di oggetti personalizzati per tenere traccia delle auto che passano da fasi come nuovo all'inventario, nel processo di acquisto e venduto. Si visualizzano le chiamate di richiesta o le e-mail registrate nel record di ogni auto e si associano i contatti e gli accordi quando l'auto viene venduta.
I seguenti sono esempi in cui si sconsiglia la creazione di un oggetto personalizzato:
- Una scuola ha un database di studenti, genitori e insegnanti. Si vogliono creare oggetti personalizzati per Genitori e Insegnanti per distinguere i tipi di contatto. Questo non è un buon caso d'uso, perché un oggetto personalizzato non dovrebbe replicare un oggetto CRM esistente. Una persona può essere sia genitore che insegnante, con conseguente sovrapposizione di dati. Inoltre, la scuola non potrebbe inviare e-mail di massa ai genitori e agli insegnanti perché non sono contatti. Si potrebbero invece includere tutti i tipi di contatto nell'oggetto Contatti e creare una proprietà personalizzata Tipo di contatto con le opzioni Studente, Genitore e Insegnante.
- Un'azienda che si occupa di ristrutturazioni domestiche utilizza le note sui record di HubSpot per fare richieste interne ai propri appaltatori. Si vuole creare un oggetto Notes per tenere traccia di tutte le richieste. Questo non è un buon caso d'uso, perché gli oggetti personalizzati non dovrebbero sostituire le attività. Questo aggiunge ulteriori passaggi rispetto all'etichettatura degli utenti, le attività di altri record non possono essere associate automaticamente ai record di note personalizzati e non si possono utilizzare i report di attività precostituiti. Inoltre, le informazioni su un progetto potrebbero essere archiviate in più posti se gli utenti aggiornano sia il record della nota personalizzata che un altro record associato, con il rischio di avere dati duplicati o in conflitto. Si potrebbero invece creare note sui record, associarle ad altri record, etichettare gli utenti di HubSpot e utilizzare report predefiniti per monitorare l'attività delle note.
Creare un oggetto personalizzato
Se siete super amministratori, potete creare un oggetto personalizzato nelle impostazioni di HubSpot o tramite API. Per creare un oggetto personalizzato in HubSpot:
- Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.
- Nel menu della barra laterale sinistra, spostarsi su Oggetti > Oggetti personalizzati.
- Se si tratta del primo oggetto personalizzato, fare clic su Crea un oggetto personalizzato al centro della pagina. Se si sta creando un altro oggetto personalizzato, fare clic su Crea oggetto personalizzato in alto a destra.
- Nel pannello di destra, impostare l'oggetto personalizzato:
- Per impostare il nome dell'oggetto personalizzato:
- Nome oggetto (singolare): inserire il titolo singolare dell'oggetto personalizzato (ad esempio, Animale domestico).
- Nome oggetto (plurale): inserire il titolo plurale dell'oggetto personalizzato (ad esempio, Animale domestico).
- Inserire una descrizione opzionale dell'oggetto che spieghi agli utenti dell'account cos'è l'oggetto e come deve essere utilizzato.
- Per impostare il nome dell'oggetto personalizzato:
-
- Per creare la proprietà di visualizzazione primaria dell'oggetto:
- Proprietà di visualizzazione primaria: inserire un'etichetta per la proprietà utilizzata per denominare un record dell'oggetto (ad esempio, Nome dell'animale domestico per gli animali domestici). Questa proprietà è necessaria per creare un record di oggetto personalizzato.
- Tipo di proprietà: selezionare il tipo di proprietà di visualizzazione primaria, Testo a riga singola o Numero.
- Per creare la proprietà di visualizzazione primaria dell'oggetto:
-
-
- Fare clic sulla matita edit sotto l'etichetta per modificare il nome interno della proprietà, quindi fare clic su Salva per confermare. Il nome interno è utilizzato dalle integrazioni o dalle API e non può essere modificato una volta creato l'oggetto.
- Selezionare la casella di controllo per richiedere valori univoci per la proprietà di visualizzazione primaria. Se questa opzione è attivata, gli utenti non potranno inserire lo stesso valore per più record (ad esempio, per l'oggetto Ordini, la proprietà primaria Numero d'ordine dovrebbe richiedere valori unici).
-
-
- Per creare una proprietà secondaria per l'oggetto personalizzato:
- Proprietà secondaria: inserire un'etichetta per la proprietà che viene visualizzata sotto la proprietà primaria in un record (ad esempio, Tipo di animale domestico e Numero di telefono del proprietario per gli animali domestici). Le proprietà secondarie non sono necessarie per creare un record di oggetto personalizzato e possono essere aggiunte o rimosse in seguito, modificando l'oggetto personalizzato.
- Tipo di proprietà: il tipo di proprietà di visualizzazione secondaria, testo a riga singola o numero.
- Fare clic sulla matita edit sotto l'etichetta per modificare il nome interno della proprietà, quindi fare clic su Salva per confermare. Il nome interno è utilizzato dalle integrazioni o dalle API e non può essere modificato una volta creato l'oggetto.
- Per creare una proprietà secondaria per l'oggetto personalizzato:
-
- Per aggiungere un'altra proprietà di visualizzazione secondaria, fare clic su + Aggiungi proprietà. Questa opzione appare solo dopo aver impostato un'etichetta e un tipo di proprietà per la prima proprietà secondaria.
- Per rimuovere una proprietà secondaria esistente, fare clic sull'icona di eliminazione delete accanto alla proprietà.
- Una volta terminato, fare clic su Crea nella parte inferiore del pannello.
Per creare un oggetto personalizzato si può anche utilizzare il proprio modello di dati o Breeze Copilot.
Una volta definito un oggetto personalizzato, è possibile eseguire le seguenti operazioni nelle impostazioni dell'oggetto personalizzato:
- Creare e modificare le proprietà dell'oggetto personalizzato, compresa l'impostazione delle proprietà che appaiono quando si creano manualmente nuovi record di oggetti personalizzati.
- Creare etichette di associazione per definire le associazioni dell'oggetto personalizzato con altri oggetti.
- Creare e gestire pipeline di oggetti personalizzati per utilizzare fasi che seguono i processi dell'oggetto personalizzato.
- Creare record di oggetti personalizzati.
- Personalizzare le proprietà che appaiono nelle barre laterali, nelle schede di associazione e nelle schede dei record di oggetti personalizzati .
- Vedere come l'oggetto personalizzato si inserisce nel modello di dati dell'account.
Modificare o eliminare un oggetto personalizzato
Una volta creato un oggetto personalizzato, gli utenti con i permessi di superamministrazione possono modificarne il nome e le proprietà o eliminare l'oggetto dall'account HubSpot. È possibile modificare ed eliminare gli oggetti personalizzati nelle impostazioni dell'oggetto personalizzato o tramite API. Per modificare o eliminare nelle impostazioni:
- Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.
- Nel menu della barra laterale sinistra, spostarsi su Oggetti > Oggetti personalizzati.
- Se si hanno più oggetti personalizzati, selezionare l'oggetto da modificare o eliminare.
- Nella scheda Impostazione, fare clic su Azioni, quindi selezionare una delle seguenti opzioni:

-
- Vedere dove viene utilizzato l'oggetto: fare clic per espandere la sezione desiderata e vedere dove viene utilizzato l'oggetto in HubSpot. Fare clic sul nome di una risorsa per navigare nello strumento.
- Modifica dell'oggetto personalizzato: è possibile modificare il nome singolare, il nome plurale e la descrizione dell'oggetto, nonché aggiungere o rimuovere le proprietà di visualizzazione secondarie. Se è necessario modificare la proprietà di visualizzazione primaria, è possibile farlo con l'API dell'oggetto personalizzato. Non è possibile modificare i nomi interni dell'oggetto o delle proprietà.
- Per modificare i nomi delle proprietà di visualizzazione primarie o secondarie esistenti, fare clic su Modifica etichetta proprietà per passare alle impostazioni della proprietà.
- Per aggiungere una proprietà secondaria, fare clic su + Aggiungi proprietà, quindi inserire il nome della proprietà e selezionare il tipo di proprietà.
- Per rimuovere una proprietà secondaria, passare il mouse sulla proprietà e fare clic sull'icona delete per eliminarla. Se si rimuove una proprietà secondaria, essa sarà ancora accessibile nei record di oggetti personalizzati, ma non sarà più visualizzata nella scheda profilo o nei filtri della pagina indice. Se si desidera eliminare la proprietà, si può apprendere come archiviare ed eliminare le proprietà nelle impostazioni della proprietà.
- Fare clic su Salva per confermare le modifiche.
- Elimina oggetto personalizzato: nella finestra di dialogo, selezionare la casella di controllo per confermare che non è possibile ripristinare un oggetto personalizzato eliminato, quindi fare clic su Elimina oggetto per confermare. Non è possibile eliminare un oggetto personalizzato che è attualmente utilizzato da altri strumenti, pertanto è necessario rimuovere i riferimenti all'oggetto da tali strumenti prima di eliminarlo.
Definire le associazioni di oggetti personalizzati
Prima di poter aggiungere associazioni ai record degli oggetti personalizzati, è necessario creare le associazioni nelle impostazioni. È possibile impostare associazioni con contatti, aziende, offerte e biglietti, nonché con altri oggetti personalizzati e all'interno dello stesso oggetto personalizzato.
- Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.
- Nel menu della barra laterale sinistra, spostarsi su Oggetti e selezionare Oggetti personalizzati.
- Se si dispone di più oggetti personalizzati, fare clic sul menu a discesa Seleziona un oggetto e selezionare l'oggetto personalizzato per il quale si desidera definire le associazioni.
- Fare clic sulla scheda Associazioni.
- Se si sta aggiungendo la prima associazione dell'oggetto, fare clic su Crea nuova associazione. Per aggiungere un'altra associazione, fare clic sul menu a discesa Seleziona associazioni oggetto, quindi selezionare Crea nuova associazione.
- Nella finestra di dialogo, fare clic sul menu a discesa, quindi selezionare l'oggetto a cui si desidera associare l'oggetto personalizzato.
- Fare clic su Crea.
È ora possibile associare i record degli oggetti selezionati e creare etichette per descrivere le associazioni.