Creare un ambiente di test e implementare le modifiche nell'ambiente di produzione

Nota bene: a30 aprile 2026, le sandbox standard legacy non saranno più supportate. Per facilitare la transizione, i limiti delle sandbox sono stati temporaneamente aumentati per gli account che dispongono ancora di una sandbox legacy, consentendoti di crearne una nuova mentre quella legacy rimane disponibile fino a quando non sarai pronto a eliminarla.

Prima di iniziare

Comprendere i requisiti

Limitazioni e considerazioni

• Per impostazione predefinita, tutti i Super Amministratori, gli amministratori partner dicon accesso privilegiato e gli utenti con autorizzazioni di accesso agli strumenti di sviluppovengonocopiati nell’ambiente di test al momento della creazione.
  • Dopo la creazione, quando si aggiunge un Super Amministratore all’account di produzione, sarà necessario aggiungerlo manualmente all’account sandbox.
  • Dopo la creazione, quando un Super Admin viene rimosso dall’account di produzione, verrà automaticamente rimosso dall’account sandbox.
• Scopri quali risorse di produzione vengono copiate in un account sandbox durante la creazione della sandbox.
• Scopri quali configurazioni degli oggetti e risorse sono supportate nella funzionalità di distribuzione in produzione.
• Gli ID di contatti, aziende, opportunità, ticket e oggetti personalizzati avranno valori diversi tra l’account sandbox e quello di produzione. Puoi valutare la creazione di una nuova proprietà personalizzata (ad es. "ID record esterno") e utilizzare le automazioni per copiare gli ID dei record di produzione in questo campo, che potrai poi utilizzare nel tuo account sandbox se necessario a scopo di test.
• È possibile registrare solo 100.000 record al giorno in tutti i flussi di lavoro per l’intero account sandbox. Qualsiasi registrazione aggiuntiva ai flussi di lavoro oltre il limite massimo verrà ignorata. Riceverai una notifica nel tuo account quando il limite sarà stato raggiunto e ti verrà indicato quando potrai eseguire nuovamente la sincronizzazione.
• Se un determinato tipo di risorsa non viene copiato in un account sandbox standard al momento della creazione, anche le risorse che dipendono da quel tipo di risorsa non verranno sincronizzate. Ad esempio, poiché i sondaggi non possono essere copiati negli account sandbox standard, tutti i flussi di lavoro che utilizzano i sondaggi come trigger o azioni non verranno copiati. 
• Le integrazioni presenti nel tuo account di produzione non verranno collegate automaticamente all’account sandbox standard. Per qualsiasi integrazione esistente che desideri collegare a un account sandbox, HubSpot consiglia di collegarti alla versione sandbox di tale integrazione per evitare interruzioni dei tuoi dati CRM.
• È possibile inviare email di test individuali ed email di marketing daun account sandbox standard ai record dei contatti che condividono lo stesso indirizzo email degli utenti sandbox esistenti.
  
  • Se invii email a contatti che non sono utenti della sandbox, le email non verranno inviate poiché non sono utenti dell’account sandbox standard.
  • Le email inviate da un account sandbox standard verranno instradate tramite gli indirizzi IP condivisi utilizzati dall’account di produzione.

Creare una sandbox standard

Per creare la sandbox:

1. Nel tuo account HubSpot, fai clic sulle icona delle impostazioni nella barra di navigazione principale.
2. Nel menu della barra laterale sinistra, seleziona Sandbox.
3. Fare clic su Crea sandbox.
   
   
   
4. Nel pannello di destra, sotto Nome sandbox, inserisci il nome della sandbox.
   • La casella di controllo Copia risorse di produzione sarà selezionata per impostazione predefinita, poiché la sandbox deve riprodurre il tuo account di produzione. Fai clic sull'downIcon giù per visualizzare l'elenco delle risorse che verranno copiate nella tua sandbox.
   • Fai clic sul menu a discesa " A cosa serve questa sandbox?" e selezionale opzioni. Per rimuovere le opzioni, fai clic sulla X accanto all'opzione.
   •  Seleziona la casella di controllo "Copia 5.000 contatti e record associati " per copiare i tuoi 5.000 contatti aggiornati più di recente e fino a 100 delle relative opportunità, aziende e ticket (per contatto).

Nota: è possibile copiare 5.000 contatti e i record associati durante la creazione di un ambiente sandbox standard. Se non si copiano i record durante la creazione dell’ambiente sandbox, è possibile esportare eimportare record di prova nell’ambiente sandbox in un secondo momento. È possibile importare manualmente fino a 200.000 record per ciascuno dei seguenti oggetti: contatti, aziende, opportunità, ticket, oggetti personalizzati, carrelli, fatture, eventi di marketing e ordini per tipo di record. Per i restanti tipi di record, scopri come monitorare l'utilizzo dei dati CRM.

6. Fai clic su Crea sandbox standard.
7. Il processo di creazione della sandbox potrebbe richiedere alcune ore, a seconda del numero di risorse, delle funzionalità del piano di produzione e dei Superamministratori, degli amministratori partner ce con accesso privilegiato e degli utenti con autorizzazioni di accesso agli strumenti di sviluppo che devono essere copiati dal proprio account di produzione. Scopri come vengono gestite le autorizzazioni negli account sandbox.
8. Lo stato viene monitorato nella colonna " Creato il". Una volta creato, lo stato viene aggiornato con la data e l'ora di creazione.
9. Per esaminare le risorse non riuscite, fare clic sulla scheda " Registro attività ". Quindi, fare clic sullo stato accanto alla sandbox per visualizzare i dettagli di creazione. 
   • Fai clic sulla scheda Risorse non riuscite per visualizzare le risorse non riuscite e i dettagli dell’errore.
   • Fai clic sulla scheda Risorse copiate per visualizzare un elenco delle risorse create.

Accedere alla sandbox standard

Tutti i superamministratori che sono stati copiati durante la creazione della sandbox possono accedere a una sandbox dal menu principale del proprio account.

1. Nel tuo account HubSpot, clicca sul nome del tuo account in alto a destra. 
2. Passa il mouse sul nome del tuo account per visualizzare un elenco dei tuoi account recenti. 
3. Nel menu a tendina, clicca sul nome della sandbox a cui desideri accedere.
   
   
   
4. Nella parte superiore della finestra verrà visualizzato un banner che indica che ti trovi nell’account sandbox standard.

 I super amministratori possono accedere a una sandbox anche dalle impostazioni dell'account:

1. Nel tuo account HubSpot, fai clic sulle icona delle impostazioni nella barra di navigazione principale.
2. Nel menu della barra laterale sinistra, seleziona Sandbox.
3. Fai clic sul nome della sandbox a cui desideri accedere. 
4. Per uscire da un account sandbox, in alto a destra, clicca sul nome del tuo account di produzione.

Configurare una distribuzione in produzione

Una volta apportate le modifiche nella sandbox, è possibile distribuire le risorse supportate al proprio account di produzione. Per configurare una distribuzione in produzione, accedere al proprio account di produzione, quindi:

1. Nel tuo account HubSpot, fai clic sulle icona delle impostazioni nella barra di navigazione principale.
2. Nel menu laterale a sinistra, seleziona Sandbox.
3. In alto a destra, seleziona" Configura una distribuzione".
   • Nella colonna Tipi di risorse supportate, seleziona le risorse che desideri distribuire. Se stai distribuendo oggetti, accanto alle risorse, fai clic su Seleziona configurazione.
   • Per capire cosa è possibile distribuire con ciascuna risorsa, nel banner in alto, clicca su Visualizza [X] comportamenti di distribuzione. Nel pannello di destra, esamina le informazioni. Quindi, clicca su Chiudi.
     
     
     
4. Seleziona la casella di controllo accanto a ciascuna modifica idonea alla distribuzione. Se stai distribuendo oggetti, questa opzione si troverà nel pannello di destra e dovrai fare clic su Salva selezione.

Nota: èpossibile distribuire fino a 300 modifiche alla volta. 

7. Fare clic su Avanti. 
8. Eventuali connessioni verranno visualizzate nel passaggio " Risorse connesse ". Le risorse connesse sono altre risorse utilizzate dalle risorse selezionate e necessarie per la distribuzione.
   
   • Fare clic su " Visualizza configurazioni degli oggetti" nella colonna "Nome " per visualizzare ciò che verrà distribuito, in base alla connessione.
   • Fare clic su x risorse selezionate nella colonna "Utilizzate da " per visualizzare le connessioni.

   • Per includere la configurazione nella distribuzione, selezionare la casella di controllo " Aggiungi x connessioni alla mia distribuzione per continuare ", quindi fare clic su Avanti.

9.  Eventuali conflitti verranno rilevati automaticamente. Verifica l’errore e risolvi eventuali conflitti per procedere con la distribuzione. Se non vengono rilevati conflitti, fai clic su Avanti.
10. Nel campo "Nome distribuzione ", inserisci un nome per la tua distribuzione. Nel campo "Descrizione ", inserisci una descrizione. Fai clic su "Avanti".
11. Verifica la distribuzione in produzione. Quando sei pronto, fai clic su Distribuisci in produzione.
12. Nella finestra di dialogo, fare clic su Distribuisci in produzione per confermare.

13. Una volta avviata la distribuzione, nella scheda "Registro attività " di produzione la colonna "Stato" mostrerà "In corso". Una volta avviata, la distribuzione non può essere annullata.
14. Una volta completata la distribuzione, lo stato verrà aggiornato a [#] risorse distribuite.

• Nota: se la distribuzione non va a buon fine, consultare il registro degli errori di distribuzione per individuare la causa del problema. Per ulteriore assistenza,contattare il supporto tecnico.

15. Fare clic sul nome della distribuzione o su [#] risorse distribuite per visualizzare i dettagli della distribuzione.

Esaminare le attività nella sandbox

Per esaminare la cronologia delle azioni eseguite dagli utenti nella sandbox del proprio account:

1. Nel tuo account HubSpot, fai clic sulle icona delle impostazioni nella barra di navigazione principale.
2. Nel menu della barra laterale sinistra, vai suSandbox.
3. Fare clic sulla schedaRegistro attività.
4. Verrà visualizzato un elenco completo delle attività relative alla sandbox, tra cui:
   • Dettagli sulla creazione della sandbox (ad es. risorse copiate e motivi degli errori)
   • Distribuzioni di produzione passate
   • Eliminazioni delle sandbox
5. Fare clic sul menu a discesaTipo di log per filtrare in base ai diversi tipi di attività.

Best practice per le sandbox

Le sandbox consentono agli utenti di innovare in sicurezza al di fuori dei propri account di produzione. Si raccomanda di definire una strategia di sviluppo e di considerare i seguenti aspetti per garantire test affidabili nelle sandbox:

• Qual è lo scopo dell’ambiente di test? (ad es. sviluppo attivo, test di integrazione, formazione).
• Chi deve avere accesso? (ad es., valutare la possibilità di limitare i conflitti che possono influire sull’affidabilità dei test).
• È necessario disporre di più sandbox per supportare diversi casi d’uso?
• Qual è il modo migliore per creare e gestire i sandbox per supportare le esigenze di sviluppo?

Definire chiaramente questi aspetti contribuirà a garantire test affidabili e l’implementazione delle risorse supportate in produzione, tenendo conto al contempo di altri casi d’uso.

Di seguito sono riportati esempi di diversi scopi delle sandbox, degli utenti che dovrebbero avervi accesso e delle strategie di creazione per garantire test e sviluppo affidabili: