BetaUtilizza la CLI di HubSpot Agent

La CLI di HubSpot Agent collega gli agenti di programmazione basati sull'intelligenza artificiale, come Claude Code, Claude Cowork e OpenAI Codex, al tuo account HubSpot. Dopo aver collegato l’Agent CLI a HubSpot, puoi chiedere a un agente di intelligenza artificiale di svolgere attività CRM ripetitive, analizzare dati, generare riepiloghi e aiutarti a gestire i processi all’interno del tuo account. Quando deleghi attività agli agenti di intelligenza artificiale, questi possono utilizzare l’Agent CLI per automatizzare il lavoro di routine al posto tuo, consentendo al tuo team di dedicare più tempo alle iniziative strategiche.

Ad esempio, invece di esaminare manualmente i record ogni settimana, puoi chiedere a un agente AI di identificare i record incompleti, riassumere l’attività della pipeline o preparare le revisioni degli account utilizzando le informazioni provenienti da HubSpot.

Se sei uno sviluppatore e desideri scrivere script personalizzati o utilizzare manualmente la CLI di HubSpot Agent nel tuo terminale, consulta la nostra documentazione per sviluppatori.

Prima di iniziare

Prima di iniziare a utilizzare la CLI di HubSpot Agent, assicurati di avere accesso a un agente di programmazione basato sull’IA. Gli agenti supportati includono Claude Code, Claude Cowork, OpenAI Codex e molti altri agenti di programmazione basati sull’IA compatibili.

Nota: se utilizzi Claude Cowork in un account Team o Enterprise, l’amministratore della tua organizzazione potrebbe dover inserire api.hubapi.com nell’elenco delle risorse consentite prima che la CLI possa essere installata o eseguita. Scopri di più sull’inserimento nell’elenco delle risorse consentite in Claude Cowork.

A cosa possono accedere gli agenti di IA con la CLI di HubSpot Agent

HubSpot Agent CLI può eseguire azioni utilizzando le autorizzazioni dell’utente HubSpot collegato. A seconda delle tue autorizzazioni utente, ciò potrebbe includere la creazione, l’aggiornamento o l’eliminazione di record nel tuo account.

Dopo aver collegato la CLI di HubSpot Agent, gli agenti IA possono operare con le informazioni presenti nel tuo account HubSpot, tra cui:

• contatti, aziende, opportunità, ticket, oggetti personalizzati e altri record CRM.
• Flussi di lavoro.
• Pipeline e fasi delle pipeline.
• Proprietà e proprietà personalizzate.
• Associazioni tra record.
• Cronologia delle attività.

Nota bene: esamina sempre i suggerimenti generati dall’IA e le azioni proposte prima di applicare modifiche ai dati del tuo CRM.

Migliori pratiche

Quando si lavora con agenti di IA collegati a HubSpot:

• Iniziare con attività di reporting, riepiloghi e analisi prima di utilizzare azioni che modificano i dati.
• Esaminare i suggerimenti generati e gli aggiornamenti su larga scala prima di applicare le modifiche.
• Alcune azioni possono cancellare o sovrascrivere i dati di HubSpot. Se disponibile, utilizzare l'opzione --dry-run per visualizzare in anteprima le modifiche prima di applicarle.
• Utilizza prompt chiari che descrivano il risultato desiderato.
• Rispetta le politiche di governance e sicurezza dei dati della tua organizzazione.

Collegare la CLI di HubSpot Agent

Segui i passaggi riportati di seguito per indicare al tuo agente di installare la CLI di HubSpot Agent. Se sei uno sviluppatore, scopri di più su come installare manualmente la CLI di HubSpot Agent.

1. Apri il tuo agente AI, come Cowork o Codex.
2. Incolla il seguente prompt nell’area di lavoro del tuo agente per installare la CLI di HubSpot 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. Quando richiesto, accedi al tuo account HubSpot.
4. Verifica le autorizzazioni richieste.
5. Fai clic su " Connetti app".

Una volta completata l'autenticazione, l'agente IA potrà accedere ai dati di HubSpot in base alle tue autorizzazioni.

Per iniziare, utilizza uno dei prompt di esempio riportati di seguito.

Esempi di casi d'uso

Gli esempi seguenti mostrano come diversi team possano utilizzare gli agenti IA collegati tramite la CLI di HubSpot Agent. L’agente è particolarmente utile per attività operative ricorrenti che richiedono la revisione di grandi quantità di dati CRM.

Team di marketing

Compito: identificare i contatti che necessitano di follow-up o di pulizia dei dati.

Esempio di prompt per l’agente IA: ogni lunedì alle 8:00, individua i contatti altamente pertinenti che non presentano alcuna trattativa associata, nessuna attività di vendita recente o campi chiave di arricchimento mancanti, quindi invia a RevOps un elenco di pulizia ordinato per priorità con le azioni successive suggerite.

Altri esempi includono:

• Esamina le campagne e-mail alla ricerca di oggetti e CTA non conformi alle linee guida sul tono di voce del marchio.
• Identificare i modelli di messaggistica presenti nelle landing page ad alto rendimento che sono correlati a tassi di conversione più elevati.
• Creare un elenco di re-engagement dei contatti che non hanno aperto le email in una sequenza di nurturing.
• Monitorare lo stato attuale della pipeline delle trattative provenienti da una campagna webinar.
• Identificare i modelli relativi al settore, alle dimensioni dell’azienda e alla fonte dei lead tra i clienti più idonei.
• Monitorare le sequenze attive e segnalare cali significativi nei tassi di apertura delle email.

Team delle operazioni di vendita e dei ricavi

Compito: monitorare lo stato della pipeline e identificare le trattative che richiedono attenzione.

Esempio di richiesta per l’agente AI: ogni mattina alle 7:00, controlla la mia pipeline per individuare le trattative in chiusura questa settimana che non hanno registrato attività negli ultimi 5 giorni e inviami un riepilogo.

Altri esempi includono:

• Individua le trattative inattive di alto valore che richiedono un follow-up e una revisione.
• Prepararsi per un incontro con il cliente riassumendo la cronologia dell’affare, dell’assistenza, delle e-mail e delle note.
• Analizzare le trattative che hanno subito ritardi per identificare le fasi della pipeline in cui le opportunità sono rimaste in stallo più a lungo.
• Genera un riepilogo giornaliero delle trattative che si stanno avvicinando alla data di chiusura ma per le quali non si registrano attività recenti.

Responsabili delle vendite

Compito: analizzare le trascrizioni delle chiamate per individuare temi relativi al coaching e al feedback sui prodotti.

Esempio di richiesta per l’agente IA: analizza le trascrizioni delle chiamate recenti per individuare la durata della conversazione, i riferimenti alla concorrenza, il feedback dei clienti e i motivi di esitazione dei potenziali clienti, quindi crea un dashboard di coaching e feedback sui prodotti con esempi di trascrizioni e link alle chiamate di origine.

Altri esempi includono:

• Identificare i rappresentanti o i team con modelli di durata delle conversazioni insolitamente elevati o bassi.
• Individuare menzioni ricorrenti della concorrenza nelle recenti chiamate di vendita.
• Riassumere i temi relativi alle esitazioni dei potenziali clienti per segmento, fase della trattativa o area di prodotto.
• Estrarre esempi di trascrizioni a supporto dei temi relativi al coaching o al feedback sui prodotti.
• Creare una dashboard che colleghi le informazioni sulle chiamate ai record e alle trascrizioni di origine.

Amministratori RevOps e CRM

Compito: ripulire le proprietà del CRM senza compromettere le risorse a valle.

Esempio di prompt per l’agente AI: individua le proprietà CRM duplicate o obsolete, mostra dove vengono utilizzate nei flussi di lavoro, nei report e nelle visualizzazioni. Quindi mostra in anteprima un piano di pulizia per sostituire, rimuovere o riordinare i campi prima di applicare le modifiche.

Altri esempi includono:

• Identifica le proprietà duplicate che raccolgono le stesse informazioni su oggetti diversi.
• Individua i campi obsoleti che compaiono ancora nei flussi di lavoro, nei report, nelle viste o nei layout dei record.
• Visualizza in anteprima l’impatto della rimozione o della sostituzione di una proprietà del CRM prima di apportare modifiche.
• Riordinare i campi dei record in modo che amministratori e rappresentanti vedano per prime le informazioni più importanti.
• Generare un riepilogo delle operazioni di pulizia che mostri cosa è stato modificato e cosa deve ancora essere rivisto.

Team operativi

Compito: consolidare i ticket di assistenza correlati e conservare la cronologia della pulizia.

Esempio di prompt per l’agente AI: consolidare i ticket di assistenza duplicati, conservare i dettagli del ticket di origine, indirizzare ciascun ticket principale alla fase corretta della pipeline e inviare al team un riepilogo della pulizia con eventuali record che necessitano ancora di revisione.

Altri esempi includono:

• Individuare i ticket di assistenza duplicati o correlati relativi allo stesso cliente o allo stesso tipo di problema.
• Unire il contesto del ticket in un record principale, conservando i dettagli di origine.
• Indirizzare i ticket consolidati alla fase corretta della pipeline in base allo stato attuale.
• Contrassegnare i ticket che necessitano di revisione umana prima del consolidamento.
• Inviare un riepilogo della pulizia con i record unificati, le domande aperte e i responsabili del follow-up.

Team di assistenza

Compito: esaminare la cronologia del cliente senza aprire manualmente più record.

Esempio di richiesta per l’agente AI: estrai gli ultimi 5 ticket relativi a questo contatto, riassumi ciascuna risoluzione e contrassegna eventuali schemi ricorrenti di problemi.

Altri esempi includono:

• Esamina la cronologia recente dei ticket e identifica i problemi ricorrenti dei clienti prima di aprire un nuovo caso.
• Assegnare la priorità ai ticket che hanno superato i tempi di risposta previsti.
• Analizzare i ticket relativi alla fatturazione per identificare i motivi più comuni per cui i clienti contattano l’assistenza.
• Preparare le risposte ai ticket includendo la cronologia pertinente relativa a contratti, abbonamenti ed escalation.

Team di Customer Success

Compito: preparare le revisioni degli account utilizzando le informazioni provenienti da diversi strumenti HubSpot.

Esempio di richiesta per l’agente AI: Per la mia revisione degli account di questa settimana, riassumi le trattative aperte, le recenti attività di assistenza e l’ultimo punteggio NPS per ciascun account nel mio portafoglio clienti.

Altri esempi includono:

• Identifica gli account dei clienti che presentano indicatori di elevato rischio di abbandono.
• Individua i contatti per il rinnovo con un basso livello di coinvolgimento nei confronti del prodotto per un approccio proattivo.
• Preparare le revisioni degli account riassumendo le recenti attività relative a vendite, assistenza e feedback dei clienti.
• Identifica le opportunità di espansione confrontando le tendenze di crescita degli account con l’entità storica delle trattative.

Mantenere aggiornata la libreria delle competenze

Le competenze HubSpot Agent CLI forniscono indicazioni predefinite che aiutano gli agenti IA a lavorare con i dati HubSpot e i processi HubSpot più comuni. La libreria delle competenze include indicazioni per ricerche nel CRM, operazioni in blocco, attività relative alla qualità dei dati, flussi di lavoro, reportistica e altre attività operative.

È possibile esaminare le competenze che verranno installate nel repository GitHub pubblico.

Per aggiornare la libreria delle competenze nel proprio spazio di lavoro dell’agente IA, eseguire il seguente prompt:

npx skills update

Scopri di più sull’utilizzo delle competenze in Claude e in OpenAI Codex.

Gestisci l’accesso a HubSpot Agent CLI

I super amministratori possono gestire chi è autorizzato a connettersi alla CLI di HubSpot Agent aderendo alla versione beta di App Install Governance.

Se un utente non dispone dell’autorizzazione per connettersi alla CLI di HubSpot Agent, dovrà richiedere l’approvazione da parte di un amministratore prima di effettuare la connessione.

Scopri di più su come gestire quali app possono essere installate nel tuo account HubSpot.