BêtaUtiliser l’interface de ligne de commande de l’agent HubSpot

L’interface de ligne de commande de l’agent HubSpot connecte des agents de codage IA, tels que Claude Code, Claude Cowork et OpenAI Codex, à 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 à notre documentation développeurs.

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 Claude Code, Claude Cowork, OpenAI Codex 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.

À 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.
• 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.
• 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 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.

1. Ouvrez votre agent IA, tel que Cowork ou Codex.
2. 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.

3. Lorsque vous y êtes invité, connectez-vous à votre compte HubSpot.
4. Vérifiez les autorisations requises.
5. 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.

Pour commencer, utilisez l’un des exemples de prompts ci-dessous.

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. L’agent est particulièrement utile pour les tâches opérationnelles récurrentes qui nécessitent d’examiner de grandes quantités de données CRM.

Les équipes marketing

Tâche : identifiez les contacts qui ont besoin d’un suivi ou d’un nettoyage de données.

Exemple de prompt pour l’agent IA : Tous les lundis à 8 h, trouvez des contacts hautement 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.

Voici d’autres exemples :

• 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.
• Identifiez les modèles de communication sur les pages de destination performantes qui sont corrélés à des taux de conversion plus élevés.
• Créez une liste de réengagement des contacts qui n’ont pas ouvert d’e-mails dans une séquence de nurturing.
• Suivez le statut actuel du pipeline des transactions provenant d’une campagne de webinar.
• 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.
• Surveillez les séquences actives et signalez les baisses significatives des taux d’ouverture des e-mails.

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

Tâche : suivre l’état du pipeline et identifier les transactions qui requièrent votre attention.

Exemple de prompt pour l’agent IA : Tous les matins à 7 heures, vérifier dans mon pipeline les transactions qui n’ont pas eu d’activité au cours des 5 derniers jours et m’envoyer un récapitulatif.

Voici d’autres exemples :

• Trouvez les transactions inactives à forte valeur ajoutée qui nécessitent un suivi et un examen.
• Préparez une réunion client en résumant l’historique des transactions, du support, des e-mails et des notes.
• Analysez les transactions glissées pour identifier les phases du pipeline où les opportunités sont les plus longues à stagner.
• 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.

Leader des ventes

Tâche : analyser les transcriptions des appels à la recherche de thèmes de coaching et de feedback sur les produits.

Exemple de prompt pour l’agent IA : analysez les transcriptions d’appels récents pour le temps de parole, les noms de concurrents, le feedback des 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.

Voici d’autres exemples :

• Identifiez les représentants ou les équipes ayant un temps de conversation inhabituellement élevé ou faible.
• Trouvez les mentions récurrentes de concurrents lors des appels commerciaux récents.
• Résumez les thèmes d’hésitation des prospects par segment, étape de transaction ou domaine de produit.
• Extrayez des exemples de transcriptions qui traitent des thèmes du coaching ou du feedback sur les produits.
• Créez un tableau de bord qui relie les informations sur les appels aux fiches d’informations et transcriptions sources.

RevOps et administrateurs de CRM

Tâche : nettoyer les propriétés du CRM sans casser les actifs en aval.

Exemple de prompt pour l’agent IA : Recherchez les propriétés CRM dupliquées ou obsolètes, indiquez 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.

Voici d’autres exemples :

• Identifiez les propriétés en double qui collectent les mêmes informations pour différents objets.
• Trouvez les champs obsolètes qui apparaissent toujours dans les workflows, les rapports, les vues ou les présentations de fiche d’informations.
• Prévisualisez l’impact de la suppression ou du remplacement d’une propriété du CRM avant d’apporter des modifications.
• Réorganisez les champs des fiches d’informations afin que les administrateurs et les représentants voient les informations les plus importantes en premier.
• Générez un résumé du nettoyage indiquant ce qui a changé et ce qui doit encore être révisé.

Les équipes opérationnelles

Tâche : consolider les tickets de support associés et préserver l’historique de nettoyage.

Exemple de prompt pour l’agent IA : consolidez 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 nécessitent encore un examen.

Voici d’autres exemples :

• Trouvez des tickets de support en double ou associés pour le même client ou le même type de problème.
• Fusionnez le contexte du ticket dans une fiche d’informations parent tout en préservant les détails de la source.
• Acheminez les tickets consolidés vers la bonne phase du pipeline en fonction du statut actuel.
• Signalez les tickets qui nécessitent un examen humain avant la consolidation.
• Envoyez un résumé du nettoyage avec les fiches d’informations fusionnées, les questions ouvertes et les responsables du suivi.

Les équipes de support

Tâche : consulter l’historique du client sans ouvrir manuellement plusieurs fiches d’informations.

Exemple de prompt pour l’agent IA : Extrayez les 5 derniers tickets de ce contact, résumez chaque résolution et signalez toute tendance récurrente.

Voici d’autres exemples :

• Examinez l’historique des tickets récents et identifiez les problèmes récurrents des clients avant d’ouvrir un nouveau dossier.
• Priorisez les tickets qui ont dépassé les attentes en matière de temps de réponse.
• Analysez les tickets de facturation afin d’identifier les raisons les plus courantes pour lesquelles les clients contactent le support.
• Préparez des réponses aux tickets avec l’historique des transactions, des abonnements et des remontées d’incident.

Les équipes d’accompagnement client

Tâche : préparer des analyses de compte à l’aide des informations provenant de plusieurs outils HubSpot.

Exemple de prompt pour l’agent IA : 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 de chaque compte de mon portefeuille commercial.

Voici d’autres exemples :

• Identifiez les comptes clients présentant un risque élevé de perte de clients.
• Trouvez les contacts avec un faible engagement pour le renouvellement afin de les contacter de manière proactive.
• 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.
• Identifiez les opportunités d’expansion en comparant les tendances de croissance des comptes avec la taille historique des transactions.

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 OpenAI Codex.

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 en s’inscrivant à la version bêta de gouvernance de l’installation d’applications .

Si un utilisateur n’a pas l’autorisation de connecter l’ILC de l’agent HubSpot, il doit demander l’approbation d’un administrateur avant de le connecter.

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