Nota bene: la traduzione in italiano di questo articolo è fornita solo per comodità. La traduzione viene creata automaticamente tramite un software di traduzione e potrebbe non essere stata revisionata. Pertanto, la versione inglese di questo articolo deve essere considerata come la versione di governo contenente le informazioni più recenti. È possibile accedervi qui.

Utilizza la CLI di HubSpot Agent

Ultimo aggiornamento: 29 settembre 2026

Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:

Tutti i prodotti e i piani

La CLI di HubSpot Agent collega gli agenti di programmazione basati sull’intelligenza artificiale, come quelli delle app ChatGPT, Claude e Claude Code, al tuo account HubSpot. Dopo aver collegato l’Agent CLI a HubSpot, puoi chiedere a un agente AI 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 AI, 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 documentazione per sviluppatori di HubSpot.

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 quelli presenti nell’app ChatGPT, nell’app Claude,in Claude Code e in 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 origini autorizzate prima che la CLI possa essere installata o eseguita. Scopri di più sull’inserimento nell’elenco delle origini autorizzate in Claude Cowork.

Quando utilizzare la CLI di HubSpot Agent

La CLI per agenti è utile per attività operative ripetitive o ricorrenti che richiedono la revisione di grandi quantità di dati CRM. Ciò include attività quali l’esecuzione di una revisione settimanale della pipeline, l’aggiornamento in blocco dei record o l’invio di riepiloghi programmati al tuo team dopo una riunione mensile ricorrente. Scopri altri esempi di casi d’uso.

Se desideri porre domande sporadiche o redigere contenuti utilizzando i tuoi dati HubSpot, il connettore HubSpot per Claude o il connettore HubSpot per ChatGPT sono opzioni che non richiedono l’installazione della CLI.

A cosa possono accedere gli agenti IA con HubSpot Agent CLI

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 HubSpot Agent CLI, gli agenti IA possono utilizzare 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.
Record relativi ai ricavi (sola lettura): contratti, fatture, ordini, pagamenti, preventivi, modelli di preventivo e abbonamenti (BETA).
Associazioni tra record.
Cronologia delle attività.

Nota: controlla sempre i suggerimenti generati dall’IA e le azioni proposte prima di applicare modifiche ai tuoi dati CRM.

Migliori pratiche

Quando si lavora con agenti IA collegati a HubSpot:

Inizia con attività di reporting, riepiloghi e analisi prima di utilizzare azioni che modificano i dati.
Quando si configurano attività pianificate o ricorrenti, iniziare con un singolo caso d’uso ben circoscritto prima di passare a un’automazione più ampia.
Esamina i suggerimenti generati e gli aggiornamenti su larga scala prima di applicare le modifiche.
Alcune azioni possono eliminare o sovrascrivere i dati di HubSpot. Laddove disponibile, utilizzare l'opzione --dry-runper visualizzare in anteprima le modifiche prima di applicarle.
Utilizza istruzioni chiare e specifiche 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.

Apri il tuo agente AI.
Incolla il seguente prompt nell’area di lavoro dell’agente per installare la CLI dell’agente.

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.

Quando richiesto, accedi al tuo account HubSpot.
Verifica le autorizzazioni richieste.
Fai clic su " Connetti app".

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

Esempi di casi d’uso

Gli esempi seguenti mostrano come diversi team possono utilizzare gli agenti IA collegati tramite la CLI di HubSpot Agent.

Team di marketing

Attività	Esempio di richiesta per l'agente IA
Identifica i contatti che necessitano di follow-up o di pulizia dei dati.	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.
Esamina le campagne e-mail alla ricerca di oggetti e CTA che non siano in linea con le linee guida relative al tono di voce del marchio.	Esamina le mie ultime 10 campagne email e segnala le righe dell’oggetto o i CTA che non seguono le nostre linee guida relative al tono di voce del marchio. Elenca ogni problema indicando il nome della campagna, il testo segnalato e una revisione suggerita.
Identifica i modelli di messaggistica presenti nelle landing page ad alto rendimento che sono correlati a tassi di conversione più elevati.	Analizza le mie landing page con le migliori prestazioni in base al tasso di conversione. Identifica modelli di messaggistica comuni, come la struttura dei titoli, la formulazione dei CTA o il tipo di offerta, e riassumi ciò che hanno in comune.
Crea un elenco di re-engagement dei contatti che non hanno aperto le email in una sequenza di nurture.	Individua tutti i contatti attualmente iscritti a una sequenza di nurturing che non hanno aperto alcuna email negli ultimi 30 giorni. Crea un segmento con il loro nome, azienda, fase del ciclo di vita e data dell’ultima attività.
Monitorare lo stato attuale della pipeline delle trattative provenienti da una campagna webinar.	Individua tutte le trattative con fonte di lead "webinar" e mostra la loro fase attuale nella pipeline, il responsabile, l’importo e la data dell’ultima attività. Riassumi quante sono attive, in stallo o chiuse.
Identifica i modelli relativi al settore, alle dimensioni dell’azienda e alla fonte dei lead tra i clienti più adatti.	Esamina le mie opportunità chiuse con esito positivo degli ultimi 12 mesi e riassumi le combinazioni più comuni di settore, dimensioni dell’azienda e fonte del lead. Evidenzia eventuali modelli che potrebbero aiutare a perfezionare il nostro profilo del cliente ideale.
Monitorare le sequenze attive e segnalare cali significativi nei tassi di apertura delle e-mail.	Controlla tutte le sequenze attive e confronta i tassi di apertura delle ultime due settimane con quelli delle due settimane precedenti. Segnala eventuali sequenze in cui i tassi di apertura sono diminuiti di oltre il 20%, indicando il nome della sequenza, il tasso attuale e quello precedente.

Team di vendita e operazioni di fatturato

Compito	Esempio di prompt per l’agente IA
Monitorare lo stato della pipeline e identificare le trattative che richiedono attenzione.	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.
Individua le trattative inattive di alto valore che richiedono un follow-up e una revisione.	Individua tutte le trattative aperte di importo superiore a $[importo] che non hanno registrato attività negli ultimi 14 giorni. Ordina per valore della trattativa e includi il nome della trattativa, il responsabile, la data di chiusura e l'ultima attività.
Preparati per un incontro con un cliente riassumendo la cronologia dell’affare, dell’assistenza, delle e-mail e delle note.	Domani ho un incontro con [Azienda]. Riassumi le loro trattative aperte e quelle chiuse di recente, gli ultimi 5 ticket di assistenza, l’attività e-mail recente e tutte le note registrate negli ultimi 60 giorni.
Analizza le trattative non concluse per identificare le fasi della pipeline in cui le opportunità hanno subito i maggiori ritardi.	Esamina le trattative che non hanno rispettato la data di chiusura nell’ultimo trimestre. Per ciascuna di esse, indica in quale fase della pipeline hanno trascorso più tempo e identifica le due o tre fasi in cui le trattative si bloccano più frequentemente.
Genera un riepilogo giornaliero delle trattative che si stanno avvicinando alla data di chiusura ma per le quali manca attività recente.	Ogni giorno alle 8:00, individua le trattative che si chiuderanno entro i prossimi 7 giorni e che non hanno registrato attività negli ultimi 3 giorni. Inviami un riepilogo con il nome della trattativa, il responsabile, l’importo, la data di chiusura e il tipo di ultima attività.

Responsabili delle vendite

Compito	Esempio di prompt per l’agente IA
Analizza le trascrizioni delle chiamate per individuare temi relativi al coaching e al feedback sui prodotti.	Analizza le trascrizioni delle chiamate recenti per individuare temi relativi alla durata della conversazione, alle menzioni della concorrenza, al feedback dei clienti e alle esitazioni dei potenziali clienti, quindi crea una dashboard dedicata al coaching e al feedback sui prodotti con esempi di trascrizioni e link alle chiamate di origine.
Identifica i rappresentanti o i team con modelli di durata della conversazione insolitamente alti o bassi.	Analizza le trascrizioni delle chiamate degli ultimi 30 giorni e calcola il rapporto medio della durata della conversazione per ogni addetto. Segnala chiunque abbia un rapporto superiore al 70% o inferiore al 30% e includi un estratto di trascrizione di esempio per ciascuno.
Individua i riferimenti ricorrenti alla concorrenza nelle recenti chiamate di vendita.	Esamina le trascrizioni delle chiamate degli ultimi 60 giorni e identifica i concorrenti menzionati più spesso. Per ciascuno, indica quante chiamate includevano una menzione, in quali fasi della trattativa sono emersi e una citazione di esempio.
Riassumi i temi relativi alle esitazioni dei potenziali clienti per segmento, fase della trattativa o area di prodotto.	Esamina le trascrizioni delle chiamate recenti alla ricerca di espressioni che indichino esitazioni o obiezioni da parte dei potenziali clienti. Raggruppa i temi per fase della trattativa e segmento di potenziali clienti, quindi riassumi i 5 principali modelli di esitazione con citazioni di esempio.
Estrai esempi di trascrizioni che supportino i temi relativi al coaching o al feedback sui prodotti.	Dalle trascrizioni delle chiamate degli ultimi 30 giorni, individua da tre a cinque esempi di domande di approfondimento efficaci e da tre a cinque esempi di occasioni mancate nella gestione delle obiezioni. Includi il nome del rappresentante, la data della chiamata e una citazione diretta per ciascuno.
Crea un dashboard che colleghi le informazioni ricavate dalle chiamate ai record e alle trascrizioni di origine.	Crea una dashboard di coaching che riassuma i rapporti relativi al tempo di conversazione, le menzioni della concorrenza e i temi delle obiezioni emersi dalle chiamate degli ultimi 30 giorni. Per ogni insight, includi un link alla chiamata di origine e al record della trattativa associato.

Amministratori RevOps e CRM

Compito	Esempio di prompt per l’agente IA
Pulisci le proprietà del CRM senza compromettere le risorse a valle.	Individua le proprietà CRM duplicate o obsolete, mostra dove vengono utilizzate nei flussi di lavoro, nei report e nelle viste. Quindi visualizza in anteprima un piano di pulizia per sostituire, rimuovere o riordinare i campi prima di applicare le modifiche.
Identifica le proprietà duplicate che raccolgono le stesse informazioni su oggetti diversi.	Analizzare tutte le proprietà relative a contatti, aziende e trattative e contrassegnare quelle che sembrano raccogliere le stesse informazioni con nomi diversi. Elencare i nomi delle proprietà, i relativi oggetti e un'azione suggerita per ciascuna coppia duplicata.
Individua i campi obsoleti che compaiono ancora nei flussi di lavoro, nei report, nelle viste o nei layout dei record.	Individua tutte le proprietà CRM che non sono state aggiornate negli ultimi 12 mesi ma che compaiono ancora in flussi di lavoro attivi, report salvati, viste elenco o layout delle schede dei record. Mostra dove ciascuna di esse viene utilizzata prima di apportare qualsiasi modifica.
Visualizza in anteprima l’impatto della rimozione o della sostituzione di una proprietà del CRM prima di apportare modifiche.	Desidero rimuovere la proprietà [Nome proprietà]. Prima di apportare qualsiasi modifica, mostrami tutti i flussi di lavoro, i report, gli elenchi e i layout dei record che la utilizzano e mostrami in anteprima cosa non funzionerebbe più o dovrebbe essere aggiornato.
Riorganizza i campi dei record in modo che amministratori e rappresentanti vedano per prime le informazioni più importanti.	Per il layout del record di contatto, sposta questi campi nella parte superiore della barra laterale delle proprietà: [Campo 1], [Campo 2], [Campo 3]. Visualizza l’anteprima prima di applicare le modifiche.
Generare un riepilogo della pulizia che mostri cosa è stato modificato e cosa deve ancora essere rivisto.	Dopo aver completato la pulizia delle proprietà del CRM, genera un riepilogo di tutte le proprietà che sono state rimosse, sostituite o rinominate, quali risorse sono state aggiornate e un elenco di tutti i campi che necessitano ancora di una revisione manuale.

Team operativi

Attività	Esempio di prompt per l’agente IA
Consolida i ticket di assistenza correlati e conserva la cronologia della pulizia.	Raggruppa i ticket di assistenza duplicati, conserva i dettagli del ticket di origine, indirizza ogni ticket principale alla fase corretta della pipeline e invia al team un riepilogo della pulizia con tutti i record che necessitano ancora di revisione.
Trova i ticket di assistenza duplicati o correlati relativi allo stesso cliente o allo stesso tipo di problema.	Individua tutti i ticket di assistenza aperti relativi alla stessa azienda che sono stati creati a distanza di 30 giorni l'uno dall'altro. Raggruppali per azienda e tipo di problema e contrassegna quelli che sembrano essere duplicati.
Unisci il contesto del ticket in un record principale, conservando i dettagli della fonte.	Per i ticket duplicati identificati in precedenza, unisci la descrizione, la cronologia dei contatti e le note di ciascun ticket di origine nelle note del record principale prima di chiudere i duplicati.
Indirizza i ticket consolidati alla fase corretta della pipeline in base allo stato attuale.	Per ogni ticket principale consolidato, controlla il suo stato attuale e spostalo nella fase corretta della pipeline: i problemi aperti in “In corso”, i ticket in attesa di risposta in “In attesa del cliente” e i problemi risolti in “Chiuso”.
Contrassegnare i ticket che richiedono una revisione manuale prima del consolidamento.	Prima di consolidare qualsiasi ticket, contrassegna i record che presentano una controversia di pagamento in sospeso, un timer SLA attivo o una nota contrassegnata come "escalation". Non unirli. Elencali invece per la revisione manuale.
Invia un riepilogo della pulizia con i record uniti, le questioni aperte e i responsabili del follow-up.	Una volta completato il consolidamento dei ticket, invia al responsabile del team di assistenza un riepilogo che elenchi ogni ticket principale creato, quali ticket di origine sono stati uniti ad esso, eventuali domande aperte che richiedono un follow-up e chi è responsabile di ciascuna fase successiva.

Team di assistenza

Attività	Esempio di prompt per l’agente AI
Esamina la cronologia del cliente senza aprire manualmente più record.	Estrai gli ultimi 5 ticket relativi a questo contatto, riassumi ogni risoluzione e segnala eventuali schemi ricorrenti di problemi.
Esamina la cronologia recente dei ticket e identifica i problemi ricorrenti del cliente prima di aprire un nuovo caso.	Prima di creare un nuovo ticket per [Contatto], estrai i suoi ultimi 10 ticket, riassumi ogni risoluzione e segnala eventuali problemi che si presentano più di una volta. Includi l'oggetto del ticket, lo stato e la data di risoluzione.
Dai priorità ai ticket che hanno superato i tempi di risposta previsti.	Individua tutti i ticket aperti che non hanno ricevuto una risposta entro la finestra SLA prevista. Ordinali in base al ritardo accumulato e includi il responsabile del ticket, il nome del contatto e la data dell’ultima attività.
Analizza i ticket relativi alla fatturazione per identificare i motivi più comuni per cui i clienti contattano l’assistenza.	Esamina tutti i ticket contrassegnati con una categoria relativa alla fatturazione degli ultimi 90 giorni. Riassumi i 5 motivi principali per cui i clienti hanno contattato l’assistenza, classificati in base al volume, e includi il tempo medio di risoluzione per ciascuno.
Preparare le risposte ai ticket includendo la cronologia pertinente relativa a trattative, abbonamenti ed escalation.	Per il ticket [ID ticket], estrai la cronologia delle trattative associate al contatto, i dettagli dell’abbonamento attuale ed eventuali note di escalation precedenti. Riassumi il contesto e redigi una risposta che affronti il problema del cliente.

Team di Customer Success

Attività	Esempio di prompt per l’agente AI
Prepara le revisioni degli account utilizzando le informazioni provenienti da diversi strumenti HubSpot.	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.
Identifica gli account dei clienti che presentano indicatori di elevato rischio di abbandono.	Esamina gli account nel mio portafoglio clienti e contrassegna quelli che presentano due o più dei seguenti segnali: calo della frequenza di accesso al prodotto, ticket di assistenza aperti da più di 14 giorni, punteggio NPS inferiore a 7 o assenza di attività del CSM negli ultimi 30 giorni. Classificali in base al livello di rischio.
Individua i contatti per il rinnovo con un basso coinvolgimento nel prodotto per un approccio proattivo.	Individuare tutti i contatti relativi agli account in scadenza di rinnovo nei prossimi 60 giorni che non hanno effettuato l’accesso al prodotto negli ultimi 21 giorni. Creare un elenco di contatti prioritari con il nome del contatto, l’account, la data di rinnovo e la data dell’ultimo accesso.
Prepara le revisioni degli account riassumendo le recenti attività relative a vendite, assistenza e feedback dei clienti.	Per [Nome account], riassumi tutte le attività relative alle trattative degli ultimi 6 mesi, i ticket di assistenza aperti e chiusi di recente, nonché eventuali risposte NPS o CSAT. Struttura il tutto come un briefing pre-QBR che io possa condividere con il team dell’account.
Identifica le opportunità di espansione confrontando le tendenze di crescita dell’account con il volume storico delle trattative.	Esamina gli account nel mio portafoglio clienti che hanno registrato una crescita in termini di organico o fatturato nell’ultimo anno. Confronta il loro volume attuale delle transazioni con i livelli raggiunti da account simili e contrassegna i primi 10 come potenziali opportunità di espansione.

Mantieni aggiornata la libreria delle competenze

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

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

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

npx skills update

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

Gestire l’accesso a HubSpot Agent CLI

I superamministratori possono gestire chi è autorizzato a connettersi alla CLI di HubSpot Agent. Se un utente non dispone dell’autorizzazione per connettersi alla CLI di HubSpot Agent, deve richiedere l’approvazione da parte di un superamministratore prima di effettuare la connessione.

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

L'articolo è stato utile?

Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.