Avertissement : cet article est le résultat de la traduction automatique, l'exactitude et la fidélité de la traduction ne sont donc pas garanties.

Utiliser l’interface de ligne de commande de l’agent HubSpot

Dernière mise à jour: 29 septembre 2026

Disponible avec le ou les abonnements suivants, sauf mention contraire :

Tous les produits et les abonnements

L’interface de ligne de commande de l’agent HubSpot connecte les agents de codage IA, tels que ceux de l’application ChatGPT, de l’application Claude et de Claude Code , à votre compte HubSpot. Après avoir connecté l’ILC à HubSpot, vous pouvez demander à un agent IA d’effectuer des tâches répétitives dans le CRM, d’analyser des données, de générer des résumés et de vous aider à gérer les processus sur votre compte. Lorsque vous déléguez des tâches à des agents IA, ils peuvent utiliser l’interface de ligne de commande des agents pour automatiser le travail routinier à votre place, aidant ainsi votre équipe à consacrer plus de temps aux initiatives stratégiques.

Par exemple, au lieu d’examiner manuellement les fiches d’informations chaque semaine, vous pouvez demander à un agent IA d’identifier les fiches d’informations incomplètes, de résumer l’activité du pipeline ou de préparer des analyses de compte à l’aide des informations de HubSpot.

Si vous êtes un développeur cherchant à écrire des scripts personnalisés ou à utiliser l’ILC de l’agent HubSpot manuellement dans votre terminal, reportez-vous à la documentation des développeurs de HubSpot.

Avant de commencer

Avant de commencer à utiliser l’interface de ligne de commande de l’agent HubSpot, assurez-vous d’avoir accès à un agent de codage IA. Les agents pris en charge incluent ceux de l’application ChatGPT, de l’application Claude, de Claude Code et de nombreux autres agents de codage IA compatibles.

Remarque : Si vous utilisez Claude Cowork dans un compte d’équipe ou Entreprise, il se peut que l’administrateur de votre organisation doive api.hubapi.com ajouter à la liste d’inclusion avant que l’ILC puisse être installée ou exécutée. En savoir plus sur la liste d’inclusion dans Claude Cowork.

Quand utiliser l’interface de ligne de commande de l’agent HubSpot

L’interface de ligne de commande de l’agent est utile pour les tâches opérationnelles répétitives ou récurrentes qui nécessitent l’examen de grandes quantités de données CRM. Cela inclut des tâches telles que l’exécution d’une revue hebdomadaire du pipeline, la mise à jour en masse des fiches d’informations ou l’envoi de résumés programmés à votre équipe après une réunion mensuelle récurrente. Découvrez d’autres exemples de cas d’utilisation.

Si vous souhaitez poser des questions ponctuelles ou rédiger un brouillon de contenu à l’aide de vos données HubSpot, les options connecteur HubSpot pour Claude ou HubSpot pour ChatGPT ne nécessitent pas l’installation d’une interface de ligne de commande.

À quoi les agents IA peuvent accéder avec l’interface de ligne de commande des agents HubSpot

L’interface de ligne de commande de l’agent HubSpot peut effectuer des actions en utilisant les autorisations de l’utilisateur HubSpot connecté. En fonction de vos autorisations utilisateur, cela peut inclure la création, la mise à jour ou la suppression de fiches d’informations dans votre compte.

Après avoir connecté l’interface de ligne de commande de l’agent HubSpot, les agents IA peuvent travailler avec les informations de votre compte HubSpot, notamment :

Contacts, entreprises, transactions, tickets, objets personnalisés et autres fiches d’informations du CRM.
Workflows.
Pipelines et phases du pipeline.
Propriétés et propriétés personnalisées.
Enregistrements de revenus (lecture seule) : contrats, factures, commandes, paiements, devis, modèles de devis et abonnements (BÊTA).
Associations entre fiches d’informations.
Historique de l’activité.

Remarque : consultez toujours les recommandations générées par l’IA et les actions proposées avant d’appliquer des modifications à vos données CRM.

Meilleures pratiques

Lorsque vous travaillez avec des agents IA connectés à HubSpot :

Commencez par générer des rapports, des résumés et des tâches d’analyse avant d’utiliser des actions qui modifient les données.
Lors de la configuration de tâches planifiées ou récurrentes, commencez par un cas d’utilisation unique et précis avant de passer à une automatisation plus large.
Passez en revue les recommandations générées et les mises à jour à grande échelle avant d’appliquer les modifications.
Certaines actions peuvent supprimer ou remplacer des données HubSpot. Le cas échéant, utilisez l’option --dry-run pour prévisualiser les modifications avant de les appliquer.
Utilisez des prompts clairs et spécifiques qui décrivent le résultat souhaité.
Suivez les politiques de gouvernance et de sécurité des données de votre organisation.

Connecter l’interface de ligne de commande de l’agent HubSpot

Suivez les étapes ci-dessous pour indiquer à votre agent d’installer l’ILC de l’agent HubSpot. Si vous êtes un développeur, découvrez comment installer manuellement l’interface de ligne de commande de l’agent HubSpot.

Ouvrez votre agent IA.
Collez l’prompt suivante dans l’espace de travail de votre agent pour installer l’ILC de l’agent.

Install the HubSpot Agent CLI in this agent workspace. If this workspace uses a POSIX shell (macOS, Linux, WSL, or Bash), run `curl -fsSL https://api.hubapi.com/hub/cli/backend/hub-cli/latest/install.sh | sh`. If it uses Windows PowerShell, run `irm https://api.hubapi.com/hub/cli/backend/hub-cli/latest/install.ps1 | iex`. Then authenticate with `hubspot auth login`, install HubSpot Agent CLI Skills with `npx skills add hubspot/agent-cli-skills`, and use `hubspot --help` to explore what's available.

Lorsque vous y êtes invité, connectez-vous à votre compte HubSpot.
Vérifiez les autorisations requises.
Cliquez sur Connecter l'application.

Une fois l’authentification terminée, l’agent IA peut accéder aux données HubSpot en fonction de vos autorisations.

Exemples de cas d'utilisation

Les exemples suivants montrent comment différentes équipes peuvent utiliser les agents IA connectés via l’ILC des agents HubSpot.

Les équipes marketing

Tâche	Exemple de prompt pour l’agent IA
Identifiez les contacts qui ont besoin d’un suivi ou d’un nettoyage des données.	Tous les lundis à 8 h, identifiez les contacts les plus qualifiés sans transaction associée, sans activité de vente récente ou sans champs d’enrichissement clés, puis envoyez aux RevOps une liste de nettoyage prioritaires avec des suggestions des actions suivantes à entreprendre.
Examinez les campagnes d’e-mail à la recherche de lignes d’objet et de CTA qui ne correspondent pas aux directives relatives au ton de marque.	Passer en revue mes 10 dernières campagnes d’e-mails et signaler les lignes d’objet ou les CTA qui ne respectent pas les directives relatives au ton de marque. Listez chaque problème avec le nom de la campagne, le texte signalé et une révision suggérée.
Identifiez les modèles de communication sur les pages de destination performantes qui sont corrélés à des taux de conversion plus élevés.	Analyser mes pages de destination les plus performantes par taux de conversion. Identifiez les modes de communication courants, tels que la structure du titre, la formulation du CTA ou le type d’offre, et résumez ce qu’ils ont en commun.
Créez une liste de réengagement des contacts qui n’ont pas ouvert d’e-mails dans une séquence de nurturing.	Trouvez tous les contacts actuellement inscrits dans une séquence de nurturing qui n’ont ouvert aucun e-mail au cours des 30 derniers jours. Créez un segment avec leur nom, leur entreprise, la phase du cycle de vie et la date de la dernière activité.
Suivez le statut actuel du pipeline des transactions provenant d’une campagne de webinar.	Trouvez toutes les transactions avec une source de leads de webinar et affichez leur phase de pipeline actuelle, leur propriétaire, leur montant et la date de la dernière activité. Résumez le nombre d’entre elles qui sont actives, bloquées ou fermées.
Identifiez les tendances en matière de secteur d’activité, de taille d’entreprise et de source de leads parmi les clients les plus qualifiés.	Passez en revue les transactions fermées-gagnées des 12 derniers mois et résumez les combinaisons les plus courantes entre le secteur d’activité, la taille de l’entreprise et la source de leads. Mettre en évidence toutes les tendances qui pourraient aider à affiner le profil de client idéal.
Surveillez les séquences actives et signalez les baisses significatives des taux d’ouverture des e-mails.	Vérifiez toutes les séquences actives et comparez les taux d’ouverture des deux dernières semaines aux deux semaines précédentes. Signalez les séquences pour lesquelles les taux d’ouverture ont chuté de plus de 20 %, en indiquant leur nom, le taux actuel et le taux précédent.

Les équipes opérationnelles commerciales et de chiffre d’affaires

Tâche	Exemple de prompt pour l’agent IA
Surveillez l’état du pipeline et identifiez les transactions qui requièrent votre attention.	Tous les matins à 7 heures, vérifier mon pipeline pour les transactions qui se concluent cette semaine et qui n’ont pas eu d’activité au cours des 5 derniers jours et envoyez-moi un récapitulatif.
Trouvez les transactions inactives à forte valeur ajoutée qui nécessitent un suivi et un examen.	Trouvez toutes les transactions ouvertes supérieures à [montant] $ sans activité au cours des 14 derniers jours. Triez par valeur de transaction et incluez le nom de la transaction, le propriétaire, la date de fermeture et la dernière activité.
Préparez une réunion client en résumant l’historique des transactions, du support, des e-mails et des notes.	J’ai une réunion avec [Entreprise] demain. Résumez leurs transactions ouvertes et récemment conclues, les 5 derniers tickets de support, leur activité d’e-mail récente et toutes les notes consignées au cours des 60 derniers jours.
Analysez les transactions glissées pour identifier les phases du pipeline où les opportunités sont les plus longues à stagner.	Examinez les transactions dont la date de fermeture a été perdue au cours du dernier trimestre. Pour chacune d’entre elles, affichez l’étape du pipeline dans laquelle le lead a passé le plus de temps et identifiez les deux ou trois phases où les transactions stagnent le plus souvent.
Générez quotidiennement un récapitulatif des transactions qui approchent de la date de fermeture mais qui n’ont pas d’activité récente.	Tous les jours à 8 heures du matin, constatez des transactions conclues au cours des 7 prochains jours et aucune activité au cours des 3 derniers jours. Envoyez-moi un récapitulatif avec le nom de la transaction, le propriétaire, le montant, la date de fermeture et le dernier type d’activité.

Leader des ventes

Tâche	Exemple de prompt pour l’agent IA
Analysez les transcriptions des appels pour identifier les thèmes de coaching et de feedback sur les produits.	Analysez les transcriptions d’appels récents pour connaître le temps de parole, les noms de concurrents, les retours clients et les thèmes d’hésitation des prospects, puis créez un tableau de bord de coaching et de feedback produit avec des exemples de transcriptions et des liens vers les appels sources.
Identifiez les représentants ou les équipes ayant un temps de conversation inhabituellement élevé ou faible.	Analysez les transcriptions des appels des 30 derniers jours et calculez le ratio moyen de temps de conversation par représentant. Signalez toute personne dont le ratio est supérieur ou inférieur à 30 % et incluez un exemple d’extrait de transcription pour chacune.
Trouvez les mentions récurrentes de concurrents lors des appels commerciaux récents.	Analysez les transcriptions des appels des 60 derniers jours et identifiez les concurrents mentionnés le plus souvent. Pour chacun d’eux, indiquez combien d’appels comprenaient une mention, la phase de transaction à laquelle ils se sont trouvés et un exemple de devis.
Résumez les thèmes d’hésitation des prospects par segment, étape de transaction ou domaine de produit.	Analysez les transcriptions d’appels récents afin de détecter tout langage qui indiquerait des hésitations ou des objections de la part du prospect. Regroupez les thèmes par phase de transaction et par segment de prospect, puis résumez les 5 principales hésitations avec des exemples de citations.
Extrayez des exemples de transcriptions qui traitent des thèmes du coaching ou du feedback sur les produits.	À partir des transcriptions d’appels des 30 derniers jours, retrouvez trois à cinq exemples de questions de découverte pertinentes et trois à cinq exemples de moments où vous avez manqué une gestion des objections. Incluez le nom du représentant, la date d’appel et une citation directe de chacun.
Créez un tableau de bord qui relie les informations sur les appels aux fiches d’informations et transcriptions sources.	Créer un tableau de bord de coaching résumant les ratios de temps de conversation, les mentions des concurrents et les thèmes d’objection des appels des 30 derniers jours. Pour chaque information, incluez un lien vers l’appel source et la fiche d’informations de transaction associée.

RevOps et administrateurs de CRM

Tâche	Exemple de prompt pour l’agent IA
Nettoyez les propriétés du CRM sans casser les ressources en aval.	Trouvez les propriétés CRM dupliquées ou obsolètes, et affichez où elles sont utilisées dans les workflows, les rapports et les vues. Puis, prévisualisez un plan de nettoyage pour remplacer, supprimer ou réorganiser les champs avant d’appliquer les modifications.
Identifiez les propriétés en double qui collectent les mêmes informations pour différents objets.	Analysez toutes les propriétés de contacts, d’entreprises et de transactions et signalez celles qui semblent collecter les mêmes informations sous des noms différents. Listez les noms des propriétés, leurs objets et une action suggérée pour chaque paire de doublons.
Trouvez les champs obsolètes qui apparaissent toujours dans les workflows, les rapports, les vues ou les présentations de fiche d’informations.	Trouvez toutes les propriétés CRM qui n’ont pas été mises à jour au cours des 12 derniers mois, mais qui apparaissent toujours dans des workflows actifs, des rapports enregistrés, des vues de liste ou des fiches d’informations. Indique où chacun est utilisé avant d’apporter des modifications.
Prévisualisez l’impact de la suppression ou du remplacement d’une propriété du CRM avant d’apporter des modifications.	Je souhaite supprimer la propriété [Nom de la propriété]. Avant d’apporter des modifications, montrez-moi chaque workflow, rapport, liste et fiche d’informations qui l’utilise, et prévisualisez ce qui ne fonctionnerait pas ou devrait être mis à jour.
Réorganisez les champs des fiches d’informations afin que les administrateurs et les représentants voient les informations les plus importantes en premier.	Pour la mise en page de la fiche d’informations d’un contact, déplacez ces champs vers le haut de la barre latérale des propriétés : [Champ 1], [Champ 2], [Champ 3]. Prévisualisez avant d’appliquer les modifications.
Générez un résumé du nettoyage indiquant ce qui a changé et ce qui doit encore être révisé.	Une fois le nettoyage des propriétés du CRM terminé, générez un récapitulatif de toutes les propriétés supprimées, remplacées ou renommées, des ressources mises à jour et une liste de tous les champs qui nécessitent encore un examen manuel.

Les équipes opérationnelles

Tâche	Exemple de prompt pour l’agent IA
Regroupez les tickets de support associés et préservez l’historique de nettoyage.	Regroupez les tickets de support en double, conservez les détails du ticket source, acheminez chaque ticket parent vers la bonne étape du pipeline et envoyez à l’équipe un résumé du nettoyage avec toutes les fiches d’informations qui doivent encore être examinées.
Trouvez des tickets de support en double ou associés pour le même client ou le même type de problème.	Trouvez tous les tickets de support ouverts de la même entreprise qui ont été créés à 30 jours d’intervalle. Regroupez-les par entreprise et par type de problème, puis signalez ceux qui semblent être des doublons.
Fusionnez le contexte du ticket dans une fiche d’informations parent tout en préservant les détails de la source.	Pour les tickets en double identifiés ci-dessus, fusionnez la description, l’historique des contacts et les notes de chaque ticket source dans les notes de la fiche d’informations parent avant de fermer les doublons.
Acheminez les tickets consolidés vers la bonne phase du pipeline en fonction du statut actuel.	Vérifiez le statut actuel de chaque ticket parent consolidé et déplacez-le vers la bonne phase de pipeline : problèmes ouverts à En cours, tickets en attente d’une réponse à En attente d’une réponse du client et problèmes résolus à Fermés.
Signalez les tickets qui nécessitent un examen humain avant la consolidation.	Avant de consolider des tickets, signalez les fiches d’informations qui présentent un litige de paiement en cours, un compte SLA actif ou une note indiquant une remontée. Ne les fusionnez pas. Répertoriez-les plutôt pour un examen manuel.
Envoyez un résumé du nettoyage avec les fiches d’informations fusionnées, les questions ouvertes et les responsables du suivi.	Une fois le regroupement des tickets terminé, envoyez au responsable de l’équipe de support un récapitulatif répertoriant chaque ticket parent créé, les tickets sources qui y ont été fusionnés, toutes les questions en suspens nécessitant un suivi et la personne responsable de chaque étape suivante.

Les équipes de support

Tâche	Exemple de prompt pour l’agent IA
Examinez l’historique client sans ouvrir manuellement plusieurs fiches d’informations.	Extraire les 5 derniers tickets de ce contact, résumer chaque résolution et signaler toute tendance récurrente en matière de problèmes.
Examinez l’historique des tickets récents et identifiez les problèmes récurrents des clients avant d’ouvrir un nouveau dossier.	Avant de créer un nouveau ticket pour [Contact], extrayez ses 10 derniers tickets, résumez chaque résolution et signalez tout problème qui apparaît plus d’une fois. Incluez l’objet, le statut et la date de résolution du ticket.
Priorisez les tickets qui ont dépassé les attentes en matière de temps de réponse.	Trouvez tous les tickets ouverts qui n’ont pas reçu de réponse dans la fenêtre SLA prévue. Triez-les en fonction de leur retard et incluez le propriétaire du ticket, le nom du contact et la date de la dernière activité.
Analysez les tickets de facturation afin d’identifier les raisons les plus courantes pour lesquelles les clients contactent le support.	Passez en revue tous les tickets étiquetés avec une catégorie liée à la facturation au cours des 90 derniers jours. Résumez les 5 principales raisons pour lesquelles les clients ont contacté le support, classées par volume de tickets et incluez le délai moyen de résolution pour chacune d’entre elles.
Préparez des réponses aux tickets avec l’historique des transactions, des abonnements et des remontées d’incident.	Pour ticket [ID du ticket], extrayez l’historique des transactions associées au contact, les détails de l’abonnement actuel et toute note de remontée précédente. Résumez le contexte et rédigez une réponse qui répond à la demande du client.

Les équipes d’accompagnement client

Tâche	Exemple de prompt pour l’agent IA
Préparez des analyses de compte à l’aide des informations provenant de plusieurs outils HubSpot.	Pour l’analyse de mon compte cette semaine, résumez les transactions ouvertes, l’activité de support récente et le dernier taux de recommandation net pour chaque compte de mon portefeuille commercial.
Identifiez les comptes clients présentant un risque élevé de perte de clients.	Passer en revue les comptes dans mon portefeuille et signaler ceux présentant au moins deux de ces signaux : baisse de la fréquence de connexion au produit, tickets de support ouverts datant de plus de 14 jours, taux de recommandation net inférieur à 7 ou aucune activité CSM dans les 30 derniers jours. Classez-les par niveau de risque.
Trouvez les contacts avec un faible engagement pour le renouvellement afin de les contacter de manière proactive.	Trouvez tous les contacts des comptes à renouveler dans les 60 prochains jours qui ne se sont pas connectés au produit au cours des 21 derniers jours. Créez une liste de communication par ordre de priorité avec le nom du contact, le compte, la date de renouvellement et la date de la dernière connexion.
Préparez des analyses de compte en résumant les activités récentes des ventes, du support et des clients en matière de feedback.	Pour [nom du compte], résumez toute l’activité des transactions au cours des six derniers mois, les tickets de support ouverts et récemment fermés, ainsi que toutes les réponses taux de recommandation net ou CSAT. Mettez-le en forme comme un brief préalable à la revue trimestrielle que je peux partager avec l’équipe de votre compte.
Identifiez les opportunités d’expansion en comparant les tendances de croissance des comptes avec la taille historique des transactions.	Examinez les comptes de mon portefeuille qui ont augmenté en effectifs ou en chiffre d’affaires au cours de la dernière année. Comparez le montant actuel de leurs transactions à celui de comptes similaires, et signalez les 10 premiers marchés comme des opportunités d’expansion potentielles.

Actualiser la bibliothèque de compétences

Les compétences CLI pour agents HubSpot fournissent des instructions prédéfinies qui aident les agents IA à exploiter les données HubSpot et à gérer les processus courants de HubSpot. La bibliothèque de compétences comprend des conseils sur les recherches dans le CRM, les opérations en masse, les tâches liées à la qualité des données, les workflows, le reporting et d'autres activités opérationnelles.

Vous pouvez consulter les compétences qui seront installées dans le référentiel GitHub public.

Pour mettre à jour la bibliothèque de compétences dans votre espace de travail d’agent IA, exécutez l’prompt suivante :

npx skills update

Découvrez-en davantage sur l’utilisation des compétences dans Claude et dans ChatGPT.

Gérer l’accès à l’interface de ligne de commande de l’agent HubSpot

Les super administrateurs peuvent gérer qui est autorisé à connecter l’ILC de l’agent HubSpot. Si un utilisateur n’est pas autorisé à connecter l’ILC de l’agent HubSpot, il doit demander l’approbation d’un super administrateur avant de le connecter.

Découvrez-en davantage sur la gestion des applications pouvant être installées sur votre compte HubSpot.

Cet article vous a-t-il été utile ?

Ce formulaire n'est utilisé que pour recueillir du feedback sur la documentation. Découvrez comment obtenir de l'aide sur HubSpot.