--- title: HubSpot description: Installer, configurer et utiliser le connecteur HubSpot d'Insourcia - envoi de listes, enrichissement des comptes existants, mise à jour continue. --- Le connecteur HubSpot écrit les données d'entreprise d'Insourcia dans vos fiches **Companies** : identité légale, comptes annuels, dirigeant, signaux de vie de l'entreprise. Il couvre deux usages : envoyer une liste construite dans Insourcia vers HubSpot, et compléter les comptes que vous avez déjà. Il s'installe depuis Insourcia, par autorisation HubSpot. Aucune clé API à copier, aucun mot de passe à partager. > Les connecteurs CRM sont réservés au plan Pro. Ce qui est commun à tous les > connecteurs est décrit dans [Connecteurs CRM](/docs/guides/crm). ## Ce que fait l'application **Deux usages, et c'est le second qui porte la valeur.** - **Envoyer mes listes.** Une liste de sociétés construite dans Insourcia devient autant de fiches Company dans HubSpot, déjà renseignées, et tenues à jour. - **Compléter mes comptes.** Vos fiches existantes sont reconnues dans le registre des entreprises françaises, puis complétées. Un cabinet qui a déjà 800 comptes ne tire rien d'un connecteur qui ne sait que créer des fiches neuves. **Une règle gouverne tout le reste : le connecteur n'écrit jamais ce dont il n'est pas sûr.** Un compte HubSpot porte rarement un SIREN, et reconnaître la bonne société est parfois ambigu. Dans ce cas la fiche n'est **pas** écrite : elle est mise de côté et listée, avec les sociétés possibles, pour que vous tranchiez. Écrire le chiffre d'affaires d'un concurrent sur la fiche d'un client est la seule panne que ce connecteur ne doit jamais produire. ## Installer l'application 1. Connectez-vous à Insourcia, puis ouvrez **Paramètres > Intégrations** et **HubSpot**. 2. Cliquez sur **Connecter HubSpot**. 3. HubSpot vous demande de **choisir le compte** à connecter, si vous en administrez plusieurs. 4. HubSpot affiche l'**écran d'autorisation** listant les accès demandés. Validez pour continuer. 5. Vous revenez sur Insourcia : HubSpot apparaît comme connecté, avec le nom de votre compte. Les accès demandés, et rien de plus : | Accès | Ce qu'il permet | |---|---| | `crm.objects.companies.read` | Lire vos fiches Company, pour savoir lesquelles compléter | | `crm.objects.companies.write` | Écrire les données Insourcia dans ces fiches | | `crm.schemas.companies.read` | Vérifier quelles propriétés existent déjà | | `crm.schemas.companies.write` | Créer les propriétés `Insourcia` au premier envoi | | `oauth` | Maintenir la connexion | Le connecteur ne demande aucun accès aux contacts, aux transactions, aux tickets ni aux emails. ## Configurer l'application La configuration se fait entièrement dans Insourcia, sur la page HubSpot de **Paramètres > Intégrations**. Rien n'est à régler du côté HubSpot. ### Choisir les champs écrits Quatorze champs sont disponibles, regroupés par thème, dans la section **Champs écrits**. Vous cochez ceux que vous voulez, et **vous seul décidez** : un champ décoché n'est jamais créé ni écrit. | Groupe | Champs | |---|---| | **Identité** | SIREN, dénomination légale, forme juridique, code NAF, tranche d'effectif | | **Finances** | Chiffre d'affaires, résultat net, EBITDA, année de l'exercice | | **Dirigeants** | Dirigeant principal | | **Signaux** | En activité, procédure collective en cours | | **Traçabilité** | Fiche Insourcia, date de mise à jour par Insourcia | Les propriétés correspondantes sont créées dans HubSpot au premier envoi, toutes préfixées `insourcia_`. Le connecteur remplit aussi cinq propriétés standards quand elles sont vides : le nom, la rue, le code postal, la ville et le pays. Sans elles, les filtres géographiques et la vue carte de HubSpot ignoreraient les fiches créées. Une valeur que vous avez saisie n'est jamais remplacée, et aucune autre de vos propriétés n'est modifiée. ### Choisir les listes tenues à jour Dans **Vos listes Insourcia dans HubSpot**, activez l'interrupteur des listes à tenir à jour. Une liste activée est renvoyée dans la minute qui suit chaque modification, et chaque nuit. ### Mettre en pause sans déconnecter Le menu **•••** de la connexion propose **Mettre en pause** : les envois automatiques s'arrêtent, le compte reste connecté et la configuration intacte. **Reprendre** les relance. Utile le temps d'une migration ou d'un audit interne. La ligne **Dernier envoi** indique la fraîcheur. Si les envois automatiques ne passent plus alors qu'ils devraient, elle le signale plutôt que de rester rassurante. ## Utiliser l'application ### Envoyer une liste Activez la liste dans **Vos listes Insourcia dans HubSpot**, ou cliquez sur **Envoyer maintenant** pour un envoi ponctuel. Chaque société de la liste devient une fiche Company, renseignée avec les champs cochés. Une société déjà présente est mise à jour, pas dupliquée : le SIREN sert de clé. ### Compléter ou importer vos comptes La section **Vos sociétés HubSpot** part des comptes que vous avez déjà : - **Importer dans Insourcia** : vos comptes deviennent une liste Insourcia, pour la veille et les signaux, et leurs fiches HubSpot sont complétées. - **Compléter seulement** : les fiches HubSpot sont complétées, sans créer de liste. Chaque compte suit ce chemin : 1. **Déjà rattaché à un SIREN par Insourcia ?** Il est mis à jour directement. C'est ce qui rend une seconde exécution rapide. 2. **Sinon**, Insourcia cherche la société correspondante dans le registre. 3. **Société identifiée avec certitude** : la fiche est complétée. 4. **Plusieurs sociétés possibles** : la fiche n'est **pas** touchée. Le bouton **Vérifier les fiches ambiguës** vous les présente une à une, avec les candidats, pour que vous choisissiez. Le rapport de fin distingue toujours ce qui a été écrit de ce qui a été laissé de côté. Un écart n'est pas une panne : c'est le connecteur qui refuse de deviner. > Le code postal aide beaucoup à reconnaître une société. Si vos comptes le > portent, renseignez-le avant le premier enrichissement. ## Déconnecter l'application Sur la page HubSpot de **Paramètres > Intégrations**, ouvrez le menu **•••** de la connexion, puis **Déconnecter**. **Ce qui se passe, exactement :** - Le jeton d'accès est **révoqué auprès de HubSpot**. Insourcia ne peut plus rien lire ni écrire dans votre compte. - Notre copie est **effacée** : jeton, configuration, correspondances, historique des envois. - Les envois automatiques s'arrêtent immédiatement. **Ce qui ne se passe pas :** les propriétés `Insourcia` et les valeurs déjà écrites dans vos fiches HubSpot **restent en place**. Elles vous appartiennent. Aucune donnée n'est retirée de votre CRM à la déconnexion. Si vous souhaitez également les supprimer, faites-le depuis HubSpot, dans **Paramètres > Propriétés**, en filtrant sur le préfixe `insourcia_`. Un envoi déjà en cours au moment de la déconnexion termine le lot qu'il a commencé. Il n'en démarrera aucun autre. ## Désinstaller l'application La déconnexion ci-dessus suffit dans la plupart des cas. Pour retirer l'application du côté HubSpot : 1. Dans HubSpot, ouvrez **Paramètres > Intégrations > Applications connectées**. 2. Trouvez **Insourcia** dans la liste. 3. Menu **Actions > Désinstaller**, puis confirmez. La désinstallation révoque l'autorisation depuis HubSpot. Comme pour la déconnexion, les propriétés et valeurs déjà écrites dans vos fiches restent en place. ## Besoin d'aide Écrivez à [support@insourcia.io](mailto:support@insourcia.io).