Connecteur Qonto x HubSpot - Installation

🧩 Documentation d’installation du connecteur Conto ↔ HubSpot

Introduction

Le connecteur Conto ↔ HubSpot développé par Yes We Sales permet de synchroniser automatiquement les données entre HubSpot (CRM) et Conto (logiciel de facturation).
L’objectif :

  • Centraliser les actions commerciales et administratives dans un seul environnement ;

  • Faciliter la création de factures directement depuis HubSpot ;

  • Éviter les doubles saisies et les erreurs de synchronisation.


Pré-requis

Avant de commencer l’installation, assurez-vous d’avoir :

  • Un compte HubSpot avec droits administrateur ;

  • Un compte Conto actif et accessible ;

  • Vos identifiants d’API Conto :

    • Slug (identifiant de votre organisation)

    • Clé secrète

  • Un taux de TVA applicable à vos transactions (par exemple 20 % pour la France).


Étape 1 – Installation du connecteur dans HubSpot

  1. Rendez-vous sur la marketplace HubSpot ou suivez le lien fourni par Yes We Sales.

  2. Cliquez sur Installer le connecteur Conto.

  3. Une fois installé, vous serez redirigé vers l’interface de configuration initiale du connecteur.


Étape 2 – Configuration de Conto dans le connecteur

  1. Dans l’interface de configuration, cliquez sur Configurer Conto.

  2. Trois champs sont à renseigner :

    • Slug :

      • Connectez-vous à votre espace administrateur Conto.

      • Allez dans Paramètres → Intégrations et partenariats → Clés API.

      • Copiez le slug affiché et collez-le dans le champ correspondant.

    • Clé secrète :

      • Toujours dans la section Clés API, copiez la clé secrète générée et collez-la dans le champ correspondant.

    • TVA (%) :

      • Indiquez simplement le chiffre (ex. 20 pour la France), sans symbole %.

  3. Validez la configuration.

    • Si les identifiants sont corrects, un message de confirmation verte indiquera que Conto est bien connecté.


Étape 3 – Choix du plan et activation

  • Sélectionnez le plan d’abonnement qui vous convient :

    • Mensuel, sans engagement ;

    • Annuel, plus économique.

  • Une fois le paiement validé, le connecteur est activé dans HubSpot.


Étape 4 – Vérification de l’intégration dans HubSpot

  1. Ouvrez votre portail HubSpot.

  2. Allez dans Paramètres → Applications connectées.

  3. Cherchez Conto Connector dans la liste.

  4. Cliquez sur Actions → Paramètres.

  5. Vérifiez que les deux emplacements de la carte d’application soient bien cochés.

    • Cela permet d’afficher le connecteur directement dans vos fiches de transactions (deals).

  6. Cliquez sur Enregistrer.


Étape 5 – Vérification sur une transaction

  1. Ouvrez une transaction HubSpot existante ou créez-en une nouvelle.

  2. Rafraîchissez la page.

  3. Sur le panneau de droite, cherchez le bloc Conto Connector.

    • S’il n’est pas visible, faites défiler jusqu’en bas : il peut apparaître tout en bas lors de la première utilisation.

    • Vous pouvez ensuite le glisser-déposer plus haut dans le panneau.


Étape 6 – Préparer les données d’entreprise dans HubSpot

Pour que la création de factures fonctionne, certaines propriétés d’entreprise doivent être renseignées :

Champ requis Description Exemple
Nom de l’entreprise Nom complet Yes We Sales
Adresse Rue et numéro 10 rue du Faubourg
Ville Localité Paris
Code postal Format à 5 chiffres 75009
Pays/Région Code ISO FR, ES, UK, etc.
Tax Identification Number (SIRET) Numéro fiscal obligatoire 123 456 789 00012

⚠️ Sans le numéro SIRET, il est impossible de créer une facture dans Conto.


Étape 7 – Créer une transaction avec lignes de produits

  1. Dans votre transaction HubSpot, ajoutez les lignes de produits :

    • Depuis votre bibliothèque de produits HubSpot, ou

    • En créant des produits personnalisés.

  2. Enregistrez la transaction et vérifiez que le montant total s’actualise bien.


Étape 8 – Générer une facture Conto

  1. Une fois la transaction validée par le prospect :

    • Ouvrez le panneau Conto Connector (à droite).

    • Cliquez sur Générer la facture.

  2. Une notification verte confirme la création.

  3. La facture est automatiquement générée dans Conto → Espace Brouillon.

  4. Cliquez sur le lien direct pour ouvrir la facture.

  5. Vous pouvez alors :

    • Modifier le brouillon,

    • Ajouter une remise,

    • Créer une facture d’acompte, etc.


Étape 9 – Synchronisation des informations

  • Les données remontent automatiquement de Conto vers HubSpot :

    • Identifiant de la facture

    • Date d’émission

    • Date d’échéance

    • Statut (brouillon, envoyé, payé, etc.)

  • La mise à jour du statut se fait toutes les 24 heures.

Vous pouvez également créer plusieurs factures (ex. 50 % d’acompte, 50 % de solde) sur une même transaction.


Étape 10 – Vérification et utilisation continue

  • Pour chaque facture générée, HubSpot affiche un récapitulatif automatique.

  • L’équipe commerciale, le back-office et la direction financière peuvent suivre en temps réel :

    • Les statuts de facturation,

    • Les montants,

    • Et les échanges sans quitter HubSpot.


✅ Conclusion

L’intégration Conto ↔ HubSpot permet :

  • De fluidifier le processus commercial et de facturation ;

  • D’aligner les données entre les équipes commerciales et administratives ;

  • De gagner en visibilité sur un environnement unique.