Synchronisation environement sandbox vs production

❌ Pourquoi ne puis-je pas tester les fonctionnalités en relation avec HubSpot ?

La communication entre les applications EREVO et le CRM HubSpot repose sur des appels API. Ces appels ciblent des objets métiers comme les contacts, transactions ou entreprises, identifiés via un ID unique directement présent dans l’URL HubSpot.

📌 Exemple d’URL HubSpot

https://app.hubspot.com/contacts/20415579/record/0-3/40984735928

Dans cet exemple, l’identifiant unique de l’objet contact est : 40984735928.
C’est ce type d’ID qui est enregistré dans notre base de données et utilisé lors des requêtes API.

🧪 Limites de l’environnement de test (sandbox) HubSpot

HubSpot propose un environnement sandbox destiné à simuler des opérations de test.
Cependant, cet environnement ne permet pas de reproduire fidèlement les comportements de production.

1. 🔁 Des identifiants différents

L’environnement sandbox permet de cloner certains objets depuis la production (emails, listes, workflows…), mais les objets clonés reçoivent de nouveaux identifiants, propres à cet environnement.

➡️ Concrètement :

La base de données de staging chez EREVO est une copie de la production ;
Elle contient donc les ID HubSpot issus de la production ;
Si une API tente de manipuler un objet via un ID de production dans l’environnement sandbox, l’objet sera introuvable.

Pour plus d’informations sur la différence entre un environement de staging et celui de production cliquez ici : staging-vs-production

2. ⚠️ Des propriétés absentes ou désynchronisées

Même lorsque des objets sont synchronisés, leurs propriétés personnalisées ne le sont pas toujours automatiquement.

Une propriété contact ou transaction créée récemment dans HubSpot production peut ne pas exister en sandbox ;
Toute tentative d’appel API sur cette propriété générera une erreur 400 : propriété inconnue.

🚧 Limites du staging côté EREVO

Chez EREVO, l’environnement de staging est connecté à une base de données contenant des ID de production HubSpot.

Ces ID ne sont pas valides dans le sandbox HubSpot ;
Les objets visés par l’API ne peuvent donc jamais être trouvés depuis cet environnement ;
Résultat : aucun test fiable n’est possible pour les fonctionnalités dépendant d’HubSpot.

🛑 En résumé

Il est impossible de tester les fonctionnalités HubSpot dans l’environnement de staging, en raison de :

L’incohérence des identifiants (différents entre production et sandbox)
L’absence potentielle de propriétés utilisées par les appels API
L’impossibilité d’accéder aux bons objets via les ID de la base staging

✅ Que faire pour tester les fonctionnalités liées à HubSpot ?

Pour tout test impliquant HubSpot (lecture, écriture, déclencheur, workflow…) :

Planifier une séance de test dédiée avec l’équipe technique ;
Réaliser le test en production (si le scénario est contrôlé) ;
Utiliser des données de test réversibles et validées.