Intégration Dust & HubSpot : le guide étape par étape pour automatiser vos ventes

Intégration Dust HubSpot Guide

L'intégration entre Dust.tt et HubSpot transforme radicalement la productivité des équipes commerciales. Vos agents IA accèdent aux données CRM en temps réel et peuvent même les mettre à jour automatiquement.

Ce guide vous accompagne pas à pas dans la mise en place de cette intégration, du premier clic jusqu'à vos premiers agents fonctionnels.

1. Pourquoi connecter Dust à HubSpot ?

Le défi de la donnée CRM

HubSpot centralise vos données commerciales : contacts, entreprises, deals, activités. Mais ces données restent souvent sous-exploitées :

  • Les commerciaux passent du temps à chercher des informations
  • Les préparations de RDV sont chronophages
  • La saisie CRM est perçue comme une corvée
  • Les managers manquent de visibilité temps réel

Ce que l'intégration Dust-HubSpot apporte

Avant Après
Recherche manuelle dans HubSpot Agent qui résume le contexte client
Saisie manuelle post-call Agent qui met à jour automatiquement
Reporting hebdomadaire Dashboard IA en temps réel
Alertes génériques Notifications contextuelles intelligentes
"Après l'intégration, nos commerciaux économisent 5h par semaine sur les tâches administratives CRM." — Client KOKORO, PME 25 personnes

2. Prérequis avant de commencer

Côté Dust

  • Un compte Dust Pro ou Enterprise (les intégrations ne sont pas disponibles sur le plan Starter)
  • Droits d'administration sur le workspace Dust
  • Au moins un agent fonctionnel (pour tester)

Côté HubSpot

  • Un compte HubSpot Professional ou Enterprise (Sales, Marketing ou Service Hub)
  • Droits Super Admin ou accès aux Private Apps
  • Au moins quelques contacts et deals dans le CRM

Compétences techniques

  • Compréhension de base des APIs REST
  • Familiarité avec les concepts HubSpot (contacts, deals, properties)
  • 15-30 minutes de disponibilité

3. Les 5 étapes de l'intégration

1 Créer une Private App HubSpot

Dans HubSpot, accédez à Settings > Integrations > Private Apps :

  1. Cliquez sur "Create a private app"
  2. Nommez votre app (ex: "Dust Integration")
  3. Ajoutez une description pour identifier l'usage

2 Configurer les scopes (permissions)

Dans l'onglet Scopes, activez les permissions nécessaires :

  • crm.objects.contacts.read — Lecture des contacts
  • crm.objects.contacts.write — Écriture des contacts (optionnel)
  • crm.objects.companies.read — Lecture des entreprises
  • crm.objects.deals.read — Lecture des deals
  • crm.objects.deals.write — Écriture des deals (optionnel)

Conseil : commencez par les permissions en lecture seule, puis ajoutez l'écriture une fois l'intégration validée.

3 Récupérer l'Access Token

Après avoir créé l'app :

  1. Cliquez sur "Create app"
  2. Confirmez la création
  3. Copiez l'Access Token affiché (il commence par pat-...)

Important : conservez ce token de façon sécurisée, il ne sera plus affiché.

4 Ajouter la connexion dans Dust

Dans Dust, accédez à Settings > Connections :

  1. Cliquez sur "Add connection"
  2. Sélectionnez HubSpot
  3. Collez votre Access Token
  4. Validez la connexion

Dust va vérifier que le token est valide et afficher les objets accessibles.

5 Tester avec un agent simple

Créez un agent de test pour valider l'intégration :

Tu es un assistant commercial.
Utilise HubSpot pour répondre aux questions sur les clients.

Quand on te demande des informations sur un contact ou une entreprise,
recherche dans HubSpot et résume les informations pertinentes.

Testez avec : "Donne-moi les infos sur [nom d'un contact existant]"

4. Vos premiers agents Dust-HubSpot

Agent "Préparateur de RDV"

Cet agent génère un brief complet avant chaque rendez-vous commercial :

Tu es un assistant de préparation commerciale.

Quand on te donne le nom d'un contact ou d'une entreprise :
1. Recherche toutes les informations disponibles dans HubSpot
2. Résume l'historique des interactions (emails, calls, meetings)
3. Liste les deals en cours et leur statut
4. Identifie les décideurs clés
5. Suggère 3 angles d'approche pour le RDV

Format ta réponse de façon claire et actionnable.

Utilisation : "@PrepRDV brief pour Entreprise XYZ"

Agent "Pipeline Analyst"

Cet agent analyse votre pipeline commercial et identifie les priorités :

Tu es un analyste commercial.

Quand on te demande d'analyser le pipeline :
1. Liste les deals par stage dans HubSpot
2. Identifie les deals "à risque" (pas d'activité récente)
3. Calcule les montants par stage
4. Suggère des actions prioritaires

Sois concis et orienté action.

Utilisation : "@Pipeline analyse le pipeline Q1"

Agent "Résumé Client"

Cet agent fournit un résumé 360° d'un client en quelques secondes :

Tu es un assistant de relation client.

Quand on te demande un résumé client :
1. Recherche le contact/entreprise dans HubSpot
2. Liste les informations de contact clés
3. Résume l'historique de la relation (timeline)
4. Affiche les deals passés et en cours
5. Note les points d'attention (tickets ouverts, retards...)

Sois factuel et complet.

Utilisation : "@Client résumé de Marie Dupont"

Vous souhaitez que nos experts configurent votre intégration Dust-HubSpot et créent vos premiers agents commerciaux fonctionnels ?

Échanger avec un expert

5. Optimiser l'intégration

Activer le MCP pour l'écriture

Pour permettre à vos agents de modifier les données HubSpot (créer des contacts, mettre à jour des deals...), vous devez activer l'intégration MCP. Consultez notre guide technique sur les serveurs MCP et l'intégration Dust-HubSpot.

Mapper vos custom properties

Si vous utilisez des properties personnalisées dans HubSpot, documentez-les dans les instructions de vos agents :

Properties personnalisées à connaître :
- "lead_source_detail" : détail de la source du lead
- "qualification_score" : score de 1 à 10
- "decision_timeframe" : court/moyen/long terme

Créer des agents spécialisés par équipe

Plutôt qu'un agent générique, créez des agents adaptés à chaque rôle :

  • Agent SDR : focus sur la qualification et l'enrichissement
  • Agent AE : focus sur les deals et la préparation de RDV
  • Agent CSM : focus sur la relation client et les renouvellements
  • Agent Manager : focus sur le pipeline et le forecast

6. Résolution des problèmes courants

Erreur "Invalid token"

  • Vérifiez que le token n'a pas expiré
  • Confirmez que vous avez copié le token complet
  • Régénérez un nouveau token si nécessaire

Erreur "Insufficient permissions"

  • Vérifiez les scopes activés dans la Private App
  • Assurez-vous que l'utilisateur a les droits sur les données demandées
  • Pour certaines données, un plan HubSpot supérieur peut être requis

Données incomplètes ou manquantes

  • L'intégration n'accède qu'aux données pour lesquelles vous avez les scopes
  • Certains champs peuvent être vides dans HubSpot
  • Vérifiez la qualité de vos données sources

Performances lentes

  • Limitez le nombre de résultats demandés
  • Utilisez des filtres dans vos requêtes
  • Évitez de demander "tous les contacts" sans critère

Points clés à retenir

  • L'intégration Dust-HubSpot se configure en 15 à 30 minutes via une Private App HubSpot : commencez toujours par les permissions en lecture seule avant d'activer l'écriture.
  • Les trois agents prioritaires à déployer sont : le Préparateur de RDV (brief prospect en 30 secondes), le Pipeline Analyst (identification des deals à risque) et le Résumé Client (vue 360 d'un client).
  • Le MCP (Model Context Protocol) permet aux agents de modifier les données HubSpot et pas seulement de les lire — activez-le uniquement après avoir validé l'intégration en lecture seule.
  • Documentez explicitement vos custom properties HubSpot dans les instructions de chaque agent pour garantir la précision des réponses sur vos données métier spécifiques.
  • L'intégration requiert HubSpot Professional ou Enterprise et Dust Pro ou Enterprise — vérifiez vos plans avant de commencer la configuration.

Questions fréquentes

Quels sont les prérequis pour connecter Dust à HubSpot ?

Côté Dust, il vous faut un compte Pro ou Enterprise (les intégrations ne sont pas disponibles sur le plan Starter) et les droits d'administration sur le workspace. Côté HubSpot, un compte Professional ou Enterprise (Sales, Marketing ou Service Hub) est requis, ainsi que des droits Super Admin ou l'accès aux Private Apps. Techniquement, une compréhension de base des APIs REST et de la structuration des données HubSpot est recommandée. Pour un guide complet de déploiement, consultez notre article sur l'intégration Dust en entreprise.

Comment créer une Private App HubSpot pour l'intégration avec Dust ?

Dans HubSpot, accédez à Settings, puis Integrations, puis Private Apps. Cliquez sur 'Create a private app', donnez-lui un nom (ex: 'Dust Integration'), puis configurez les scopes de permissions : activez en lecture crm.objects.contacts.read, crm.objects.companies.read et crm.objects.deals.read au minimum. Après création, copiez l'Access Token généré (il commence par pat-) et conservez-le de façon sécurisée car il ne sera plus affiché. Commencez par les permissions en lecture seule pour valider l'intégration avant d'ajouter les droits d'écriture.

Que peut faire un agent Dust connecté à HubSpot ?

Un agent Dust connecté à HubSpot peut rechercher et résumer les informations sur un contact ou une entreprise, générer un brief de préparation avant un rendez-vous commercial (historique des interactions, deals en cours, décideurs clés), analyser le pipeline commercial et identifier les deals à risque. Avec les droits d'écriture activés via MCP, l'agent peut aussi mettre à jour automatiquement les fiches contact, créer des tâches de suivi et loguer des activités. Nos clients font économiser en moyenne 5h par semaine à leurs commerciaux sur les tâches administratives CRM.

Qu'est-ce que le MCP dans l'intégration Dust-HubSpot ?

Le MCP (Model Context Protocol) est un standard d'intégration qui permet aux agents Dust d'exécuter des actions dans HubSpot, pas seulement de lire des données. Avec le MCP activé, vos agents peuvent créer des contacts, mettre à jour des deals, ajouter des notes d'appel et modifier des propriétés. C'est la différence entre un agent qui 'sait' et un agent qui 'agit'. L'activation du MCP nécessite une configuration supplémentaire détaillée dans notre guide sur les serveurs MCP et l'intégration Dust-HubSpot.

Comment gérer les custom properties HubSpot dans les agents Dust ?

Pour que vos agents Dust comprennent et utilisent correctement vos propriétés personnalisées HubSpot, documentez-les explicitement dans les instructions (prompt système) de chaque agent. Listez le nom exact de la propriété (tel qu'il apparaît dans l'API HubSpot), sa signification métier et les valeurs possibles si c'est une liste déroulante. Cette documentation permet à l'agent de comprendre le contexte de chaque champ et d'y faire référence de manière pertinente. Plus vos propriétés sont documentées, plus l'agent sera précis et utile.

Quels agents Dust-HubSpot déployer en priorité ?

Les trois agents les plus impactants à déployer en premier sont : l'agent Préparateur de RDV (génère un brief complet sur un prospect en 30 secondes), l'agent Pipeline Analyst (analyse le pipeline par stage et identifie les deals à risque) et l'agent Résumé Client (fournit un résumé 360 d'un client existant). Ces trois agents couvrent les cas d'usage les plus chronophages pour les équipes commerciales. Pour plus d'idées, consultez notre catalogue des 49 agents IA Dust pour booster vos équipes.

Comment résoudre une erreur 'Invalid token' lors de l'intégration Dust-HubSpot ?

L'erreur 'Invalid token' survient dans trois situations : le token a été copié incomplètement (vérifiez que vous avez bien copié la totalité de la chaîne qui commence par 'pat-'), l'application HubSpot a été supprimée ou désactivée, ou le token a été révoqué. Si le problème persiste, régénérez un nouveau token dans votre Private App HubSpot (Settings, Integrations, Private Apps, cliquez sur votre app et régénérez le token) et mettez à jour la connexion dans Dust avec ce nouveau token.

L'intégration Dust-HubSpot est-elle compatible avec tous les plans HubSpot ?

Non. L'intégration via Private Apps requiert un compte HubSpot Professional ou Enterprise pour les hubs Sales, Marketing ou Service. Les comptes Starter et Gratuit ne donnent pas accès aux Private Apps ni aux fonctionnalités d'API avancées. Côté Dust, le plan Pro ou Enterprise est nécessaire pour activer les connexions CRM. Si vous êtes sur un plan inférieur, contactez-nous pour évaluer des options d'intégration alternatives via des outils d'automatisation comme Make ou n8n.

Combien de temps prend la configuration initiale de l'intégration Dust-HubSpot ?

La configuration de base (Private App, connexion Dust, premier agent de test) prend entre 15 et 30 minutes. La création d'agents métier fonctionnels et adaptés à vos processus commerciaux spécifiques demande 2 à 4 heures supplémentaires. Un déploiement complet avec plusieurs agents spécialisés (SDR, AE, CSM, Manager), la documentation des custom properties et la formation des équipes s'effectue en une à deux semaines. KOKORO peut prendre en charge l'ensemble de ce processus et avoir vos premiers agents opérationnels rapidement.

Besoin d'aide pour votre intégration ?

KOKORO peut configurer votre intégration Dust-HubSpot et créer vos premiers agents en moins de 2 semaines.

Demander un accompagnement

Conclusion

L'intégration Dust-HubSpot est un game changer pour les équipes commerciales. En quelques étapes simples, vos agents IA accèdent à tout le contexte client nécessaire pour être plus efficaces.

Les prochaines étapes pour aller plus loin :

  1. Commencez par l'intégration en lecture seule
  2. Créez 2-3 agents pour les cas d'usage les plus fréquents
  3. Mesurez le temps gagné par semaine
  4. Activez le MCP pour l'écriture une fois l'adoption validée
  5. Étendez à d'autres équipes (Marketing, Support...)

Pour une vue d'ensemble des possibilités Dust, consultez notre catalogue de 43 agents IA ou notre guide d'intégration Dust en entreprise.

Simon Guichard
Co-fondateur & CTO — Kokoro

+30 systèmes IA déployés en entreprise. Simon accompagne les PME et ETI françaises dans l'intégration concrète de l'intelligence artificielle : agents autonomes, automatisation intelligente, traitement documentaire. Il a co-fondé Kokoro avec une conviction : les entreprises de taille intermédiaire ont autant à gagner de l'IA que les grands groupes — elles ont juste besoin du bon partenaire pour y arriver.

Suivre sur LinkedIn