Créer un sandbox et déployer les modifications en production

Remarque : À compter du30 avril 2026, les environnements de test standard hérités ne sont plus pris en charge. Pour faciliter la transition, les limites des sandbox ont été temporairement augmentées pour les comptes disposant toujours d’un sandbox hérité, vous permettant de créer un nouveau sandbox pendant que votre sandbox hérité reste disponible jusqu’à ce que vous soyez prêt à le supprimer.

Avant de commencer

Compréhension des exigences

Limites et considérations

• Découvrez quels utilisateurs sont copiés dans un compte sandbox lors de la création et comment les modifications des utilisateurs affectent les comptes de production et sandbox.
• Découvrez quelles ressources de production sont copiées dans un compte sandbox lors de la création d’un sandbox.
• Découvrez quelles configurations d’objets et ressources sont prises en charge dans la fonctionnalité de déploiement en production.
• Les ID de contact, d’entreprise, de transaction, de ticket et d’objet personnalisé auront des ID différents selon les comptes sandbox et de production. Vous pouvez envisager de créer une nouvelle propriété personnalisée (par exemple, ID de fiche d’informations externe) et utiliser des automatisations pour copier des ID de fiches d’informations de production dans ce champ, que vous pourrez ensuite utiliser dans votre sandbox si nécessaire à des fins de test.
• Vous pouvez inscrire uniquement 100 000 fiches d’informations par jour dans tous les workflows pour l’ensemble du compte sandbox. Toute inscription supplémentaire à un workflow au-delà du maximum sera supprimée. Vous serez averti dans votre compte lorsque la limite aura été atteinte et que vous pourrez à nouveau synchroniser.
• Si un certain type de ressource n’est pas copié dans un compte sandbox standard lors de sa création, les ressources qui dépendent de ce type de ressource ne seront pas non plus synchronisées. Par exemple, étant donné que les enquêtes ne peuvent pas être copiées dans des comptes sandbox standard, tous les workflows qui utilisent des enquêtes comme déclencheurs ou actions ne seront pas copiés. 
• Les intégrations de votre compte de production ne seront pas connectées automatiquement au compte sandbox standard. Pour toute intégration existante que vous souhaitez connecter à un compte sandbox, HubSpot recommande de connecter la version sandbox de cette intégration afin d’éviter toute perturbation de vos données CRM.
• Vous pouvez envoyer des e-mails de test individuels et des e-mails marketingà partir d’un compte sandbox standard à des fiches d’informations de contacts qui partagent la même adresse e-mail que les utilisateurs de sandbox existants.
  
  • Si vous envoyez des e-mails à des contacts qui ne sont pas des utilisateurs de sandbox, les e-mails ne seront pas envoyés car ils ne sont pas des utilisateurs du compte sandbox standard.
  • Les e-mails envoyés à partir d'un compte sandbox standard seront acheminés sur les adresses IP partagées que le compte de production utilise.

Comprendre la gestion des utilisateurs dans les comptes sandbox

Les utilisateurs de la Sandbox sont gérés indépendamment des utilisateurs du compte de production. Lorsque vous créez un compte sandbox, HubSpot copie les utilisateurs disposant d’autorisations spécifiques du compte de production. Après la création, certains changements de statut d’utilisateur dans le compte de production sont automatiquement répercutés dans le sandbox, tandis que les changements effectués dans le sandbox n’affectent pas le compte de production.

Lorsque vous créez un compte sandbox,

Par défaut, HubSpot copie les utilisateurs suivants du compte de production vers la sandbox :

• Super administrateurs
• Administrateurs tiersavec un accès élevé
• Utilisateursdisposant d’autorisations d’accès aux outils de développeur

Par défaut, les utilisateurs qui ne disposent pas de l’une de ces autorisations ne sont pas copiés dans la sandbox. Pour ajouter des utilisateurs après la création de la sandbox, ajoutez-les séparément au compte sandbox.

Après avoir créé un compte sandbox

Utilisez le tableau ci-dessous pour comprendre comment l’ajout, la désactivation et la réactivation d’utilisateurs affectent les comptes de production et sandbox.

Créer un sandbox standard

Pour créer les sandbox :

1. Dans votre compte HubSpot, cliquez sur l'icône Paramètres dans la barre de navigation principale.
2. Dans le menu latéral de gauche, sélectionnez Sandboxes.
3. Cliquez sur Créer une sandbox .
   
   
   
4. Dans le panneau de droite, sous Nom de la sandbox, saisissez le nom de la sandbox.
   • La case à cocher Copier les ressources de production sera cochée par défaut, car la sandbox sandbox doit reproduire votre compte de production. Cliquez sur l’icône downIcon Bas pour consulter la liste des ressources qui seront copiées dans votre sandbox.
   • Cliquez sur le menu déroulant À quoi sert cette sandbox ? et sélectionnez les options. Pour supprimer des options, cliquez sur le X à côté de l’option.
   •  Sélectionnez la case à cocher Copier 5 000 contacts et fiches d’informations associés pour copier vos 5 000 derniers contacts mis à jour et jusqu’à 100 transactions, entreprises et tickets associés (par contact).

Remarque : Vous pouvez copier 5 000 contacts et les fiches d’informations associées lors de la création de votre sandbox standard. Si vous ne copiez pas les fiches d’informations lors de la création du sandbox, vous pouvez exporter et importer des fiches d’informations de test dans votre sandbox à une date ultérieure. Vous pouvez importer manuellement jusqu’à 200 000 fiches d’informations pour chacun des objets suivants : contacts, entreprises, transactions, tickets, objets personnalisés, paniers, factures, événements marketing et commandes par type de fiche d’informations. Pour les autres types de fiches d’informations, découvrez comment suivre l’utilisation des données de votre CRM.

6. Cliquez sur Créer un sandbox standard .
7. Le processus de création de la sandbox peut prendre quelques heures, selon le nombre de ressources, les fonctionnalités de plan de production et les super administrateurs, les administrateurs partenaires avec un accès élevé et les utilisateurs disposant d’autorisations d’accès aux outils de développement doivent être copiés depuis votre compte de production. Découvrez comment sont gérées les autorisations dans les comptes sandbox.
8. Le statut est suivi dans la colonne Créé le . Une fois créé, le statut est mis à jour à la date et à l’heure de création.
9. Pour consulter les ressources dont la publication a échoué, cliquez sur l’onglet Journaux d’activités . Ensuite, cliquez sur le statut à côté du sandbox pour afficher les détails de sa création. 
   • Cliquez sur l'onglet Ressources ayant échoué pour voir les ressources ayant échoué et les détails des erreurs.
   • Cliquez sur l’onglet Ressources copiées pour voir la liste des ressources créées.

Accéder à la sandbox standard

Tous les super administrateurs qui ont reçu une copie lors de la création du sandbox peuvent accéder à un sandbox à partir du menu des comptes principal.

1. Dans votre compte HubSpot, cliquez sur le nom du compte dans l'angle supérieur droit. 
2. Passez le curseur de votre souris sur le nom de votre compte pour afficher une liste de vos comptes récents. 
3. Dans le menu déroulant, cliquez sur le nom du sandbox auquel vous souhaitez accéder.
   
   
   
4. Une bannière s’affiche en haut de la fenêtre, indiquant que vous êtes dans le compte sandbox standard.

 Les super administrateurs peuvent également accéder à une sandbox à partir des paramètres du compte :

1. Dans votre compte HubSpot, cliquez sur l'icône Paramètres dans la barre de navigation principale.
2. Dans le menu latéral de gauche, sélectionnez Sandboxes.
3. Cliquez sur le nom de la sandbox à laquelle vous souhaitez accéder. 
4. Pour quitter un compte sandbox, dans l’angle supérieur droit, cliquez sur le nom de votre compte de production.

Configurer un déploiement de production

Une fois que vous avez effectué vos modifications dans votre sandbox, vous pouvez déployer les ressources prises en charge sur votre compte de production. Pour configurer un déploiement de production, accédez à votre compte de production, puis :

1. Dans votre compte HubSpot, cliquez sur l'icône Paramètres dans la barre de navigation principale.
2. Dans le menu latéral de gauche, sélectionnez Sandboxes.
3. Dans l’angle supérieur droit, configurez un déploiement.
   • Dans la colonne Types de ressources pris en charge , sélectionnez les ressources que vous souhaitez déployer. Si vous déployez des objets, à côté des ressources, cliquez sur Sélectionner une configuration.
   • Pour comprendre ce qui est éligible au déploiement avec chaque ressource, dans le bandeau supérieur, cliquez sur Afficher [X] comportements de déploiement. Dans le panneau de droite, examinez les informations. Cliquez ensuite sur Fermer.
     
     
     
4. Sélectionnez la case à cocher à côté de chaque modification pouvant être déployée. Si vous déployez des objets, cela se trouvera dans le panneau de droite et vous devrez cliquer sur Enregistrer la sélection.

Remarque : Vous pouvez déployer jusqu’à 300 modifications à la fois. 

7. Cliquez sur Suivant. 
8. Toutes les connexions s’afficheront à l’étape Ressources connectées . Les ressources connectées sont d’autres ressources qui sont utilisées par vos ressources sélectionnées et qui sont requises pour votre déploiement.
   
   • Cliquez sur Afficher les configurations d’objets dans la colonne Nom pour afficher ce qui sera déployé en fonction de la connexion.
   • Cliquez sur x actifs sélectionnés dans la colonne Utilisé par pour afficher les connexions.

   • Pour inclure la configuration dans le déploiement, cliquez sur la case à cocher Ajouter x connexions à mon déploiement pour continuer , puis cliquez sur Suivant.

9.  Tout conflit sera automatiquement détecté. Examinez l’erreur et résolvez tout conflit pour poursuivre le déploiement. Si aucun conflit n’est détecté, cliquez sur Suivant.
10. Dans le champ Nom du déploiement , saisissez un nom pour votre déploiement. Dans le champ Description , saisissez une description. Cliquez sur Suivant.
11. Passez en revue votre déploiement de production. Lorsque vous êtes prêt, cliquez sur Déployer en production.
12. Dans la boîte de dialogue, cliquez sur Déployer dans la production pour confirmer.

13. Une fois le déploiement lancé, l’onglet Journaux d’activités de production affiche la colonne Statut en cours. Une fois qu'un déploiement a démarré, il ne peut plus être annulé.
14. Une fois le déploiement terminé, le statut passera à [#] ressources déployées.

• Remarque : Si votre déploiement échoue, consultez le journal des erreurs de déploiement pour examiner ce qui a pu causer l’échec. Pour obtenir de l’aide, contactez le support.

15. Cliquez sur le nom du déploiement ou sur les ressources déployées [#] pour afficher les détails du déploiement.

Analyser les activités de sandbox

Pour consulter un historique des actions de sandbox effectuées par les utilisateurs dans votre compte :

1. Dans votre compte HubSpot, cliquez sur l'icône Paramètres dans la barre de navigation principale.
2. Dans le menu latéral de gauche, accédez à Sandboxes.
3. Cliquez sur l’onglet Journal d’activité .
4. Une liste complète des activités liées aux sandboxes apparaît, y compris :
   • Détails de la création de la sandbox (ressources copiées et raisons d’erreur)
   • Déploiements de production passés
   • Sandbox : suppressions
5. Cliquez sur le menu déroulant Type d’enregistrement pour filtrer les différents types d’activité.

Meilleures pratiques en matière de sandbox

Les sandboxes permettent aux utilisateurs d’innover en toute sécurité en dehors de leurs comptes de production. Il est recommandé de définir une stratégie de développement et de prendre en compte les aspects suivants pour garantir la fiabilité des tests dans les environnements de test :

• Quel est l’objectif du sandbox ? (par exemple, développement actif, tests d’intégration, formation).
• Qui a besoin d’un accès ? (par exemple, envisagez de limiter les conflits qui peuvent affecter la fiabilité des tests).
• Existe-t-il un besoin de plus d’environnements de test pour prendre en charge divers cas d’utilisation ?
• Quel est le meilleur moyen de créer et de gérer des environnements de test pour répondre aux besoins de développement ?

Une définition claire de ces aspects facilitera la fiabilité des tests et des déploiements des ressources prises en charge en production, tout en tenant compte d’autres cas d’utilisation.

Voici des exemples des différents objectifs des environnements de test, des utilisateurs qui doivent y accéder et des stratégies de création pour garantir un test et un développement fiables :