Open Office Hours Saison 1 : Session 4 - Connexions : Salesforce & HubSpot

February 05, 2026 · Andreea Arseni · Open Office Hours

Bien configurer votre connexion Salesforce ou HubSpot dès le départ vous évite bien des maux de tête par la suite. Ce guide présente les bonnes pratiques pour les deux plateformes et vous montre, étape par étape, comment configurer les connexions dans MyRapidi.

Lors de la 4e session de notre série Open Office Hours, nous expliquons comment se connecter à Salesforce et à HubSpot via Rapidi.

Comment configurer les connexions Salesforce et HubSpot

Regardez le replay de notre quatrième session : Connexions - Salesforce et HubSpot

Bonnes pratiques pour la connexion Salesforce

Utiliser un utilisateur d’intégration dédié

N’utilisez pas vos identifiants Salesforce personnels pour votre intégration. Créez plutôt un utilisateur d’intégration dédié.

Pourquoi ? Pour deux raisons. D’abord, si quelqu’un quitte l’entreprise et que son compte est désactivé, votre intégration tombe en panne. Nous l’avons vu chez des clients, et la réparation n’a rien d’agréable. Ensuite, un utilisateur dédié vous offre une piste d’audit propre. Vous voyez exactement quelles modifications proviennent de l’intégration et lesquelles sont des saisies manuelles.

Bon à savoir :
Salesforce inclut par défaut une licence d’utilisateur d’intégration. Inutile d’acheter une licence séparée. Il suffit d’attribuer les bons ensembles d’autorisations, et vous êtes prêt.

Configurer les bonnes autorisations d’API

Donnez à votre utilisateur d’intégration uniquement les accès dont il a besoin. Ni plus, ni moins. Cela signifie :

• Un accès en lecture et en écriture aux champs précis utilisés dans l’intégration
• Un accès aux objets que vous synchronisez (comptes, contacts, opportunités, objets personnalisés, etc.)
• Une sécurité au niveau des champs correctement définie, pour que l’utilisateur puisse réellement lire et écrire chaque champ de vos transferts

Si vous négligez la sécurité au niveau des champs, l’intégration peut tourner tout en ignorant des champs sans rien signaler. Vérifiez ce point tôt.

Garder les limites d’API en tête

Salesforce plafonne le nombre d’appels d’API par période de 24 heures pour chaque org. Connaissez vos limites et planifiez en conséquence, surtout si vous lancez des synchronisations fréquentes ou traitez de gros volumes de données.

Toujours tester d’abord dans une sandbox

Salesforce permet de créer facilement un environnement sandbox. Depuis votre org de production, vous pouvez demander une copie complète ou partielle. Utilisez cette sandbox pour construire et tester votre intégration avant de toucher aux données de production.

Quelques points à connaître sur les sandboxes Salesforce :

• Lorsque vous créez la sandbox, vous en devenez automatiquement l’administrateur. Vous vous connectez avec les mêmes identifiants. Si des collègues ont besoin d’y accéder, vous devrez les ajouter.
• Lorsque vous actualisez une sandbox, l’ID de l’org Salesforce change. Vous devrez donc réautoriser votre connexion Rapidi ensuite.
• L’actualisation est utile lorsque vous avez besoin de données de production à jour pour vos tests.

Bonnes pratiques pour la connexion HubSpot

1 Utiliser un utilisateur dédié

HubSpot ne propose pas de type « utilisateur d’intégration » intégré comme Salesforce. Vous pouvez néanmoins créer un compte utilisateur distinct pour l’intégration. Votre piste d’audit reste ainsi propre, et vous évitez les mêmes risques de continuité.

2 Choisir les bons scopes

Lorsque vous autorisez votre connexion HubSpot, vous devez accorder l’accès aux bons objets. Assurez-vous que l’utilisateur d’intégration peut atteindre tout ce que vous prévoyez de synchroniser.

3 Surveiller vos limites de débit

HubSpot gère les limites de débit différemment de Salesforce. Vous aurez affaire à la fois à des limites de rafale par seconde et à des limites quotidiennes. Les valeurs exactes dépendent de votre niveau d’abonnement HubSpot ; vérifiez donc ce qui s’applique à votre compte.

4 Vérifier l’accès aux objets personnalisés

Si votre intégration utilise des objets personnalisés, vérifiez que votre abonnement HubSpot les prend en charge. Toutes les offres HubSpot n’incluent pas l’accès aux objets personnalisés, et cela peut devenir bloquant si vous ne le vérifiez pas en amont.

5 Tester dans une sandbox

Comme pour Salesforce, utilisez un environnement sandbox HubSpot pour vos tests. Construisez-y votre intégration, validez son bon fonctionnement, puis déployez-la en production.

Configurer les connexions dans MyRapidi

Une fois vos utilisateurs et vos autorisations préparés, voici comment créer et configurer des connexions dans la plateforme Rapidi.

1 Créer une nouvelle connexion

1. Connectez-vous à MyRapidi et accédez à la section Connections.
2. Cliquez pour ajouter une nouvelle connexion et sélectionnez Salesforce ou HubSpot.
3. Rapidi attribue automatiquement un code de connexion unique. Vous pouvez remplacer la description par un libellé parlant, comme « Salesforce Production » ou « HubSpot Sandbox ».
4. Enregistrez la connexion.

2 Autoriser

Cliquez sur le bouton Authorize pour relier la connexion à votre instance.

Salesforce

Vous êtes redirigé vers une page de connexion Salesforce. Avant de vous connecter, vérifiez l’URL. Par défaut, elle affiche login.salesforce.com, mais vous devrez peut-être la remplacer par l’URL propre à votre org. Si vous êtes déjà connecté à une autre org Salesforce dans votre navigateur, déconnectez-vous d’abord. Sinon, vous risquez d’autoriser la mauvaise org par erreur.

HubSpot

Vous êtes redirigé vers HubSpot pour approuver l’accès. Sélectionnez le bon compte et confirmez.

Après l’autorisation, Rapidi affiche une confirmation indiquant la date, l’heure et l’utilisateur qui a autorisé la connexion.

3 Tester

Après l’autorisation, cliquez sur Test pour vérifier que Rapidi peut se connecter à votre instance. Attendez le message de réussite avant de passer à la suite.

4 Read design

C’est l’étape la plus souvent oubliée. Cliquez sur Read Design pour que Rapidi lise tous les objets et champs auxquels votre utilisateur d’intégration a accès.

La durée dépend de votre niveau d’accès. Si l’utilisateur dispose d’un accès administrateur à des centaines d’objets, cela peut prendre quelques minutes. Si l’accès se limite à une poignée d’objets, l’opération se termine rapidement.

Erreur fréquente
Si vous sautez l’étape « Read design », vos transferts ne verront pas les nouveaux objets ou champs. C’est l’une des questions de dépannage que nous recevons le plus souvent.

Parcourir la structure des objets

Une fois le Read Design terminé, vous pouvez vérifier ce qui est disponible en ouvrant n’importe quel transfert et en cliquant sur Browse Table Layout. Recherchez un objet précis (par exemple « Contact » ou « Order ») pour afficher tous ses champs. S’il manque un objet ou un champ, relisez le design ou vérifiez les autorisations de votre utilisateur.

Aide-mémoire

Questions fréquentes sur Salesforce

1. Dois-je acheter une licence séparée pour un utilisateur d’intégration ?

Non. Salesforce inclut par défaut cinq licences d’utilisateur d’intégration gratuites. Vous attribuez la licence utilisateur « Salesforce Integration » et le profil « Salesforce API Only System Integrations ». Aucun achat supplémentaire n’est nécessaire.

C’est un point largement mal compris. Les discussions sur la Salesforce Trailblazer Community et sur Salesforce Ben rappellent régulièrement que ces licences sont fournies en standard avec chaque org.

2. Pourquoi mon utilisateur d’intégration n’a-t-il pas accès aux objets ou aux champs après la configuration ?

C’est la frustration n° 1 sur les forums. La licence utilisateur « Salesforce Integration » ne fonctionne qu’avec des ensembles d’autorisations, pas avec des autorisations basées sur le profil. Vous ne pouvez pas ajouter d’accès aux objets au profil lui-même.

Vous devez : créer un ensemble d’autorisations qui accorde l’accès en lecture/écriture à des objets et champs précis, attribuer la licence d’ensemble d’autorisations (PSL) Salesforce API Integration, puis attribuer l’ensemble d’autorisations à l’utilisateur.

La plupart des orgs gèrent encore les accès via les profils, si bien que ce nouveau modèle prend beaucoup de monde au dépourvu. Un blogueur l’a décrit comme « l’assemblage du pire projet IKEA de tous les temps ».

3. Pourquoi mon intégration a-t-elle cessé de fonctionner après l’actualisation d’une sandbox ?

Lorsque vous actualisez une sandbox, l’ID de l’org Salesforce change. Toute intégration connectée à l’ancienne sandbox perd immédiatement sa connexion.

Vous devez réautoriser la connexion (et pas seulement la retester), vous connecter à la nouvelle instance de sandbox et, souvent, mettre à jour l’URL. Certains outils ne permettent pas une simple réautorisation — vous devez supprimer puis rajouter entièrement la connexion.

À noter également : après l’actualisation d’une sandbox, il peut falloir jusqu’à 48 heures avant de pouvoir vous connecter via test.salesforce.com. Pendant ce délai, utilisez plutôt l’URL de connexion My Domain de votre sandbox.

4. Comment vérifier ma consommation d’API, et que se passe-t-il quand j’atteins la limite ?

Consultez la consommation dans Setup → System Overview → API Requests, Last 24 Hours. Pour la consommation mensuelle, allez dans Setup → Company Information → Usage-Based Entitlements.

La limite quotidienne est une limite souple. Salesforce vous permet de la dépasser temporairement, mais si la consommation continue d’augmenter, un plafond strict s’applique et renvoie une erreur 403 REQUEST_LIMIT_EXCEEDED. Les appels restent bloqués jusqu’à ce que la consommation glissante sur 24 heures repasse sous la limite.

Vous pouvez configurer des notifications par e-mail à des seuils personnalisés (par exemple 50 %, 80 %, 90 %) pour repérer les pics tôt. Les orgs en Enterprise Edition démarrent à 100 000 requêtes par période de 24 heures, plus des appels supplémentaires en fonction des licences utilisateur.

5. Dois-je utiliser mes propres identifiants Salesforce pour les intégrations ?

Tous les guides de bonnes pratiques répondent non. Avec des identifiants personnels, l’intégration tombe en panne quand la personne quitte l’entreprise. Vous perdez une piste d’audit propre, puisque les modifications de l’intégration et les saisies manuelles se ressemblent. Et l’intégration obtient plus d’accès qu’elle n’en a réellement besoin.

Un utilisateur d’intégration dédié, doté des seules autorisations strictement nécessaires, est la recommandation standard de toutes les ressources Salesforce.

Questions fréquentes sur HubSpot

1. Quelles sont les limites de débit de l’API HubSpot, et pourquoi est-ce que je reçois des erreurs 429 ?

C’est la question la plus fréquente sur les HubSpot Developer Forums. Pour les applications privées comme pour les applications OAuth, la limite est de 100 requêtes par période de 10 secondes et par compte. Les limites quotidiennes varient selon le niveau d’abonnement.

Le dépassement de ces limites renvoie une erreur 429 Too Many Requests. La communauté recommande les API batch, les synchronisations incrémentales basées sur hs_lastmodifieddate et le respect de l’en-tête Retry-After. HubSpot vend aussi un API Add-On qui porte la limite de rafale à 200 par période de 10 secondes.

2. Puis-je utiliser des objets personnalisés avec mon offre HubSpot ?

Les objets personnalisés ne sont disponibles que dans les offres Enterprise. Les utilisateurs des offres Professional ou Starter découvrent souvent cette limitation après avoir déjà conçu leur intégration autour d’objets personnalisés.

De plus, Zapier ne prend pas en charge les objets personnalisés HubSpot, et la plupart des intégrations du Marketplace ne synchronisent que les objets standard. La communauté recommande souvent d’utiliser le pipeline Tickets comme solution de contournement pour la gestion de projet ou l’onboarding.

3. Comment configurer un environnement sandbox dans HubSpot ?

Les comptes sandbox HubSpot sont disponibles avec les offres Professional et Enterprise. Par défaut, vous pouvez créer une sandbox standard. Elle peut synchroniser jusqu’à 5 000 contacts (et les enregistrements associés) lors de sa création, ou vous pouvez importer manuellement jusqu’à 200 000 enregistrements par type d’objet.

Une limite importante : les intégrations de votre compte de production ne se connectent pas automatiquement à la sandbox. Vous devez les configurer à nouveau séparément.

Attention : HubSpot met fin aux anciennes sandboxes (legacy) le 16 mars 2026 et les remplace par un nouveau système de sandbox. Si vous utilisez une ancienne sandbox, planifiez votre migration dès maintenant.

4. Pourquoi mon jeton OAuth a-t-il cessé de fonctionner ?

Les jetons d’accès OAuth de HubSpot expirent au bout de 6 heures, et l’utilisation d’un jeton d’actualisation révoque immédiatement le jeton d’accès précédent. Si votre gestion des jetons ne traite pas correctement les cycles d’actualisation, l’intégration échoue sans rien signaler ou renvoie des erreurs 401 Unauthorized.

La solution : mettez en place une logique d’actualisation proactive des jetons et surveillez les réponses 401 pour déclencher une nouvelle authentification. Ce point surprend de nombreux développeurs qui découvrent HubSpot, car la fenêtre de 6 heures est plus courte que sur la plupart des plateformes.

5. Puis-je utiliser la licence d’utilisateur d’intégration gratuite de Salesforce avec HubSpot ?

La question a déclenché un débat animé sur la HubSpot Community. Au départ, l’équipe de HubSpot elle-même affirmait que la licence utilisateur « Salesforce Integration » ne fonctionnerait pas avec HubSpot et qu’une licence utilisateur Salesforce complète était nécessaire.

Mais des membres de la communauté ont ensuite confirmé que cela fonctionne, à condition de configurer les bons ensembles d’autorisations et groupes d’ensembles d’autorisations. L’essentiel est d’accorder l’accès aux objets précis que HubSpot synchronise (contacts, comptes, opportunités, etc.) via des ensembles d’autorisations plutôt que via un accès basé sur le profil.

La question revient sans cesse, car les recommandations officielles et l’expérience du terrain ne concordent pas toujours.