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 :
- Cliquez sur "Create a private app"
- Nommez votre app (ex: "Dust Integration")
- 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 contactscrm.objects.contacts.write— Écriture des contacts (optionnel)crm.objects.companies.read— Lecture des entreprisescrm.objects.deals.read— Lecture des dealscrm.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 :
- Cliquez sur "Create app"
- Confirmez la création
- 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 :
- Cliquez sur "Add connection"
- Sélectionnez HubSpot
- Collez votre Access Token
- 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"
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
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 accompagnementConclusion
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 :
- Commencez par l'intégration en lecture seule
- Créez 2-3 agents pour les cas d'usage les plus fréquents
- Mesurez le temps gagné par semaine
- Activez le MCP pour l'écriture une fois l'adoption validée
- É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.