Come collegare HubSpot a Excel - Interrogare i dati del CRM con SQL

Connetti HubSpot a Excel

Ottieni i dati da HubSpot in Excel

Importa i dati in tempo reale dal tuo account HubSpot in Excel e aggiornali quando vuoi. Nessun driver ODBC, nessuna esportazione, nessuna macro. La prima volta ci vogliono circa dieci minuti, ed è incluso nel piano gratuito.

Circa 10 minuti Non è necessaria alcuna programmazione. Le credenziali restano con te Eccelli ovunque, anche sul web.

Quello che otterrai alla fine

Un foglio di calcolo che mostra i risultati in tempo reale di una query SQL sul tuo account HubSpot, con un pulsante che visualizza le righe più recenti ogni volta che i dati cambiano. Ad esempio:

Vendite.xlsx — Excel

CasaInserisciDatiFlussi di query

	A	B	C	D	E
1	ID cliente	nome di battesimo	cognome	Paese	totale
2	1042	Maria	Alvarez	U.S.A.	1,284.50
3	1043	Daniel	Okafor	U.S.A.	612.00
4	1047	Priya	Nair	U.S.A.	2,090.75
5	1051	Tommaso	Berg	U.S.A.	338.20
6	1056	Lucia	Ferreira	U.S.A.	1,455.00
7	1060	Kenji	Sato	U.S.A.	874.10
8

Foglio1 In diretta da HubSpot

HubSpot protegge i tuoi dati tramite la sua API. Importarli in Excel di solito significa esportare un file CSV dalla dashboard di HubSpot ogni volta che hai bisogno di dati aggiornati. Query Streams elimina questo passaggio: un piccolo programma di supporto chiamato Agent esegue la query direttamente dove si trovano i tuoi dati e un componente aggiuntivo di Excel richiede le righe desiderate. Solo i risultati vengono trasmessi, tramite un collegamento crittografato, e il file Excel può trovarsi ovunque: sul tuo laptop a casa, sul computer di un collega dall'altra parte del paese o su Excel sul web.

Cosa ti servirà

Un account Query Streams

Il piano gratuito è sufficiente per questa guida. Registrati su my.querystreams.com.

L'agente su qualsiasi computer sempre acceso

Un piccolo programma che viene eseguito in background e si connette a HubSpot quando Excel lo richiede. Richiede solo una connessione a Internet.

Le tue credenziali di accesso a HubSpot

Dovrai accedere a HubSpot una sola volta e consentire l'accesso in lettura. Non è necessario inserire password in Query Streams.

Collegalo in cinque passaggi

1. Crea il tuo account

   Vai a my.querystreams.com e iscriviti. Scegli il Gratuito piano. Si tratta di un piano reale, non di una versione di prova, che include la connessione al tuo account HubSpot e l'esecuzione di query da Excel.

2. Installa l'agente su qualsiasi computer sempre acceso.

   Accedi, apri Scaricamentoe installa l'agente su qualsiasi computer o server sempre acceso con accesso a Internet. L'operazione richiede un minuto e da quel momento in poi si avvia automaticamente.

   Perché un piccolo programma invece di un driver? L'Agent è un'unica installazione per Windows, Mac o Linux (circa 85 MB su Windows, poco più di 100 MB su Mac e Linux) che funziona silenziosamente in background. Stabilisce una connessione in uscita crittografata con Query Streams, nello stesso modo di un browser, quindi non è necessario aprire porte del firewall né configurare una VPN. Le chiavi rimangono sul computer e le righe vengono inviate ovunque vi troviate, anche tramite Internet se necessario. L'unico elemento che dovete gestire è il componente aggiuntivo.

   La pagina di download mostra La tua chiave di accesso. Incollalo nell'Agente quando richiesto e attendi che il badge venga letto Connesso ai flussi di queryQuesta è l'unica operazione che si esegue sull'agente stesso.

   Se volete, potete trovare le guide complete: Finestre, Mac, Linux.

3. Puntalo al tuo account HubSpot

   Torna al tuo browser, apri Agenti dati (Sotto Dati nel menu in alto). Il tuo agente è elencato lì. Fai clic Aggiungi connettore e scegliere HubSpotHai bisogno prima delle tue credenziali HubSpot? Apri la guida, quindi compila i campi richiesti:

   Crea le tue credenziali HubSpot (circa 5 minuti)

   Continuate a seguire questi passaggi con HubSpot aperto in un'altra scheda. Query Streams conserva i dati creati qui, in modo che il vostro agente possa utilizzarli, e legge esclusivamente da HubSpot.

   Chi può farlo?

   Super amministratore o un utente con l'autorizzazione di accesso agli strumenti per sviluppatori (chiavi di servizio). Le applicazioni private legacy richiedono un super amministratore.

   Raccomandato

   Chiave di servizio con ambiti di sola lettura (Sviluppo → Chiavi → Chiavi di servizio). HubSpot consiglia le chiavi di servizio per le sincronizzazioni dati pianificate con strumenti di BI e data warehouse e sta rimuovendo l'opzione per creare nuove app private legacy.

   Prima di iniziare

   • Un account HubSpot con privilegi di Super amministratore o con accesso agli strumenti per sviluppatori. A una chiave di servizio possono essere assegnati solo gli ambiti di cui il tuo utente HubSpot dispone già.
   • Assicurati di sapere quale account HubSpot vuoi interrogare. Una chiave legge solo l'account in cui è stata creata, quindi creala in quell'account e non in un account di test o sandbox.
   • Decidi quali tabelle di HubSpot desideri includere. Contatti, Aziende, Trattative, Proprietari, Pipeline, Fasi della pipeline e Proprietà sono incluse per impostazione predefinita; ogni tabella aggiuntiva richiede un proprio ambito di lettura (vedi Autorizzazioni).
   • L'agente Query Streams è installato e online su un computer sempre acceso, e il portale Query Streams è aperto in un'altra scheda: Agenti dati → Aggiungi connettore → HubSpot.

   Passaggi

   1. Accedi a HubSpot

      Apri HubSpot in una nuova scheda ed effettua l'accesso come Super amministratore oppure come utente con l'autorizzazione di accesso agli strumenti per sviluppatori.

      Se possiedi più di un account HubSpot, passa a quello di cui desideri accedere ai dati prima di continuare. La chiave funziona solo per l'account in cui è stata creata.

   2. Sviluppo aperto

      Nel menu di navigazione principale a sinistra, in basso, fai clic su Sviluppo (l'icona </>). Si aprirà la pagina Sviluppo con la relativa barra laterale: Panoramica, Progetti, Applicazioni legacy, Monitoraggio, Chiavi e altro ancora.

      Nessun elemento di sviluppo? Il tuo utente HubSpot non è un Super amministratore e non ha accesso agli strumenti per sviluppatori. Chiedi a un Super amministratore di creare la chiave o di concederti tale autorizzazione.

   3. Chiavi di servizio aperte

      Nella barra laterale Sviluppo, fai clic su Chiavi per espanderla, quindi fai clic su Chiavi di servizio (contrassegnata da un'icona Beta). Si aprirà la pagina Chiavi di servizio; se non ne hai ancora create, verrà visualizzato il messaggio Nessuna chiave di servizio creata.

      Non utilizzare la Chiave di accesso personale o la Chiave API per sviluppatori, che si trovano appena sopra le Chiavi di servizio nello stesso menu. Si tratta di chiavi per strumenti di sviluppo e non funzioneranno. Alcuni account accedono a questa pagina anche da Impostazioni (icona a forma di ingranaggio) → Integrazioni → Chiavi di servizio.

   4. Fai clic su Crea chiave di servizio

      Nella parte in alto a destra della pagina Chiavi di servizio, fai clic su Crea chiave di servizio. Si aprirà la pagina Crea chiave di servizio con una casella Nome e una sezione Ambiti.

   5. Dai un nome alla chiave

      Nel campo Nome, digita un nome che riconoscerai in seguito, ad esempio Query Streams sola lettura. HubSpot visualizza questo nome nei suoi log.

      Il nome deve essere univoco nel tuo account HubSpot.

   6. Apri il selettore del mirino

      Accanto a "Ambiti selezionati", fai clic su + Aggiungi nuovo ambito. Si aprirà un pannello a destra con una casella di ricerca "Trova un ambito" e una casella di controllo per ciascun ambito.

   7. Seleziona le quattro aree obbligatorie

      Digita ciascun nome in Trova un ambito e seleziona la relativa casella di controllo: crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read, crm.objects.owners.read. Questi quattro ambiti coprono tutte le tabelle che Query Streams sincronizza per impostazione predefinita.

      Seleziona solo gli ambiti che terminano con .read. Query Streams legge solo da HubSpot; non necessita mai di un ambito .write.

   8. Selezionare gli ambiti per eventuali tabelle aggiuntive

      Per ogni tabella aggiuntiva che desideri, seleziona il relativo ambito dall'elenco delle autorizzazioni qui sotto. Ad esempio: crm.objects.tickets.read per i biglietti; crm.objects.line_items.read per le voci, le tasse, gli sconti e le commissioni; crm.lists.read per gli elenchi. Salta questo passaggio se le tabelle predefinite sono sufficienti.

      È possibile aggiungere ambiti in un secondo momento senza creare una nuova chiave (aprire la chiave, quindi selezionare Modifica).

   9. Fai clic su Aggiorna

      Fai clic su Aggiorna nel pannello di destra. Il pannello si chiude e i tuoi oscilloscopi vengono visualizzati in Oscilloscopi selezionati.

   10. Controlla l'elenco degli ambiti

       Esamina gli ambiti selezionati. Se un elemento termina con .write, fai clic su Elimina accanto ad esso. Espandi Riepilogo degli ambiti selezionati se desideri un elenco in linguaggio semplice di ciò che la chiave può visualizzare.

   11. Crea la chiave

       Fai clic su Crea in alto a destra, quindi conferma nella finestra di dialogo che si apre.

   12. Apri la tua nuova chiave

       Vai su Sviluppo → Chiavi → Chiavi di servizio e fai clic sul nome della chiave appena creata. Si aprirà la pagina dei dettagli con una casella Chiave di servizio.

   13. Mostra e copia la chiave

       Nella casella Chiave di servizio il valore è parzialmente nascosto e inizia con pat- (ad esempio pat-na1-…). Fai clic su Mostra sotto di esso, quindi fai clic su Copia.

       Utilizza la funzione Copia anziché selezionare il testo manualmente: un carattere mancante, uno spazio finale o i punti nascosti faranno fallire il test. HubSpot non mostra la chiave una sola volta; puoi tornare indietro e cliccare di nuovo su Mostra. Trattala come una password.

   14. Incollalo in Query Streams e testalo

       Nel portale Query Streams, apri Data Agents, fai clic su Aggiungi connettore e scegli HubSpot. Incolla la chiave in Token di accesso all'app, digita un nome per la connessione, quindi fai clic su Verifica connessione. Il risultato sarà Connesso.

       Query Streams memorizza la chiave per il tuo agente e legge esclusivamente i tuoi dati HubSpot.

   15. Abbina le tabelle ai tuoi obiettivi

       Nella fase di sincronizzazione successiva, lascia attive solo le tabelle HubSpot i cui ambiti sono stati selezionati nei passaggi 7 e 8, quindi completa la procedura guidata.

       Una tabella attivata senza il relativo ambito non riesce a sincronizzarsi e restituisce un errore di accesso negato. Aggiungere l'ambito alla chiave (passaggio 8) oppure disattivare la tabella.

   Alternative

   Utilizzare un token di app privata legacy

   Il tuo account dispone già di un'app privata legacy che desideri riutilizzare. HubSpot sta rimuovendo l'opzione per crearne di nuove: gli account creati a partire dal 28 settembre 2026 non possono già farlo, mentre gli account più vecchi perderanno questa opzione il 26 ottobre 2026. Le app private esistenti e i relativi token continueranno a funzionare.

   Chi può farlo: Super amministratore

   1. Aprire le applicazioni legacy

      In HubSpot, fai clic su Sviluppo nel menu di navigazione principale a sinistra, quindi su Applicazioni legacy nella barra laterale Sviluppo.

      Nella vecchia navigazione di HubSpot, questa opzione si chiamava Impostazioni → Integrazioni → App private.

   2. Apri la tua app privata oppure avviane una nuova

      Se l'app è presente nell'elenco, fai clic sul suo nome e passa al passaggio 6 (o al passaggio 5 per aggiungere ambiti). In caso contrario, e se il pulsante è ancora presente, fai clic su Crea app legacy in alto a destra e scegli Privata nella finestra di dialogo.

      L'assenza del pulsante "Crea app legacy" significa che la creazione di app legacy è già disattivata per il tuo account. Utilizza invece una chiave di servizio (passaggi principali).

   3. Dai un nome alla nuova app

      Nella scheda Informazioni di base, inserisci un nome come Query Streams sola lettura. Il logo e la descrizione sono facoltativi.

   4. Aggiungi gli ambiti di lettura

      Fai clic sulla scheda Ambiti, fai clic su Aggiungi nuovo ambito, seleziona gli stessi ambiti dei passaggi principali 7 e 8, quindi fai clic su Aggiorna. Quindi fai clic su Crea app in alto a destra, leggi il messaggio del token di accesso nella finestra di dialogo e fai clic su Continua creazione.

   5. Aggiungere ambiti a un'app esistente (solo se necessario)

      Nella pagina dell'app, fai clic su Modifica app in alto a destra, apri la scheda Ambiti, aggiungi gli ambiti di lettura mancanti e salva. La stringa del token non cambia quando modifichi gli ambiti.

   6. Mostra e copia il token

      Nella pagina dell'app, fai clic sulla scheda Autenticazione. Sotto Token di accesso, fai clic su Mostra token, quindi su Copia. Il token inizia con pat-. Incollalo in Token di accesso all'app come nel passaggio principale 14.

      Se l'utente HubSpot che ha creato l'app viene rimosso da HubSpot, alcune chiamate falliscono con l'errore USER_DOES_NOT_HAVE_PERMISSIONS. Ruota il token (Ruota accanto ad esso) e incolla quello nuovo oppure spostalo in una chiave di servizio.

   Utilizzare il token di autenticazione statico di un'app della piattaforma per sviluppatori

   Il tuo team ha già creato un'app HubSpot sulla nuova piattaforma di sviluppo con la CLI di HubSpot, configurata con autenticazione statica e distribuzione privata. Per crearne una è necessaria la CLI; se non ne possiedi una, utilizza una chiave di servizio.

   Chi può farlo: Super amministratore o un utente con privilegi di sviluppatore per visualizzare il token; super amministratore o autorizzazione di accesso a HubSpot Marketplace per installare l'app

   1. Apri il progetto

      In HubSpot, fai clic su Sviluppo, quindi su Progetti nella barra laterale e infine sul nome del progetto che contiene la tua app.

   2. Apri l'app

      Nella scheda Panoramica del progetto, in Componenti del progetto, fai clic sul nome dell'app.

   3. Apri la scheda Distribuzione

      Fai clic sulla scheda Distribuzione.

   4. Installa l'app se non è ancora

      Nella sezione Gestisci distribuzione è elencato il tuo account HubSpot attuale. Fai clic su Installa ora, verifica che l'accesso richiesto corrisponda agli ambiti di lettura configurati, quindi fai clic su Connetti app.

      Un'app con token statico può essere installata in un solo account HubSpot standard alla volta.

   5. Mostra e copia il token

      Una volta installata, la scheda Distribuzione mostra un token di accesso. Fai clic su Mostra per visualizzarlo, copialo e incollalo in Token di accesso all'app come nel passaggio principale 14.

      Se in seguito modifichi gli ambiti dell'app, reinstallala utilizzando l'URL di reinstallazione nella scheda Distribuzione, altrimenti i nuovi ambiti non verranno applicati.

   Autorizzazioni a concedere

   Risorsa	Accesso	Utilizzato per
   crm.oggetti.contatti.leggi	Leggere	Obbligatorio. hubspot.contacts, oltre alle tabelle delle attività hubspot.calls, hubspot.emails, hubspot.meetings, hubspot.notes, hubspot.tasks e hubspot.communications (le API delle attività di HubSpot utilizzano questo ambito) e i campi contatto in hubspot.properties e hubspot.associations.
   crm.oggetti.aziende.lettura	Leggere	Obbligatorio. hubspot.companies e i campi company in hubspot.properties e hubspot.associations.
   crm.oggetti.offerte.lettura	Leggere	Obbligatorio. hubspot.deals, le pipeline di negoziazione in hubspot.pipelines e hubspot.pipeline_stages, e i campi relativi alle negoziazioni in hubspot.properties e hubspot.associations.
   crm.oggetti.proprietari.lettura	Leggere	Obbligatorio. hubspot.owners, gli utenti HubSpot proprietari dei record, in modo che trattative e contatti possano essere associati al nome di un rappresentante.
   crm.objects.tickets.read	Leggere	Solo se sincronizzi i ticket: hubspot.tickets e le pipeline dei ticket in hubspot.pipelines e hubspot.pipeline_stages. Le app meno recenti potrebbero mostrare invece l'ambito dei ticket legacy, che consente comunque le modifiche.
   crm.objects.products.read	Leggere	Solo se sincronizzi i prodotti: hubspot.products. Cerca i prodotti nel selettore; l'API dei prodotti di HubSpot accetta questo ambito, anche se la pagina di riferimento degli ambiti di HubSpot non lo elenca ancora.
   crm.objects.line_items.read	Leggere	Solo se sincronizzi voci, tasse, sconti o commissioni: hubspot.line_items, hubspot.taxes, hubspot.discounts, hubspot.fees.
   crm.objects.quotes.read	Leggere	Solo se sincronizzi Citazioni: hubspot.quotes.
   crm.objects.invoices.read	Leggere	Solo se sincronizzi le fatture: hubspot.invoices.
   crm.objects.subscriptions.read	Leggere	Solo se sincronizzi gli abbonamenti: hubspot.subscriptions (abbonamenti a HubSpot Commerce).
   crm.objects.commercepayments.read	Leggere	Solo se sincronizzi i pagamenti: hubspot.payments (pagamenti HubSpot Commerce).
   crm.objects.marketing_events.read	Leggere	Solo se sincronizzi gli eventi di marketing: hubspot.marketing_events.
   forme	Lettura e scrittura (HubSpot non ha un ambito di moduli di sola lettura)	Solo se sincronizzi i moduli o gli invii dei moduli: hubspot.forms e hubspot.form_submissions. Query Streams li legge soltanto.
   crm.objects.feedback_submissions.read	Leggere	Solo se sincronizzi Feedback: hubspot.feedback_submissions. Solo Service Hub Professional o Enterprise. Il riferimento all'ambito di HubSpot lo chiama crm.objects.feedback_submission.read, quindi cerca feedback nel selettore.
   crm.lists.read	Leggere	Solo se sincronizzi le liste: hubspot.lists.
   automazione	Lettura e scrittura (HubSpot non ha ambito di flussi di lavoro di sola lettura)	Solo se sincronizzi i flussi di lavoro: hubspot.workflows. Solo per account Professional o Enterprise. Query Streams legge solo le definizioni dei flussi di lavoro.
   crm.schemas.custom.read	Leggere	Solo se sincronizzi gli schemi personalizzati: hubspot.schemas (definizioni di oggetti personalizzati). Solo per account Enterprise.

   Incolla nei flussi di query

   Token di accesso all'app

   La chiave di servizio che hai copiato al passaggio 13 (inizia con pat-), oppure un token privato dell'app legacy, oppure un token di autenticazione statico dell'app della piattaforma per sviluppatori.

   Problemi comuni

   Il test di connessione fallisce con il messaggio "Token di accesso non valido o scaduto", subito dopo aver incollato una nuova chiave.

   Perché: Il valore non è una chiave di app o di servizio. La confusione più comune riguarda la Chiave di accesso personale o la Chiave API per sviluppatori, che si trovano accanto alle Chiavi di servizio in Sviluppo → Chiavi e sono destinate agli strumenti per sviluppatori di HubSpot.

   Aggiustare: Vai su Sviluppo → Chiavi → Chiavi di servizio, apri la tua chiave, fai clic su Mostra, quindi su Copia e incolla il risultato in Token di accesso all'app. Prova di nuovo la connessione; dovrebbe risultare Connesso.

   La procedura guidata segnala che il token dell'app HubSpot non è valido ancora prima di effettuare il test.

   Perché: È stata incollata solo una parte della chiave: il testo non inizia con pat- ed è molto breve o contiene uno spazio.

   Aggiustare: Tornate su HubSpot, cliccate su Mostra, quindi utilizzate il link Copia (non selezionate il testo manualmente) e incollate nuovamente.

   Non è possibile visualizzare la sezione Sviluppo nel menu di navigazione a sinistra di HubSpot, oppure la sezione Chiavi di servizio non è presente nella sezione Chiavi.

   Perché: Il tuo utente HubSpot non è un Super amministratore e non dispone dell'autorizzazione di accesso agli strumenti per sviluppatori.

   Aggiustare: Chiedi a un Super amministratore della tua azienda di creare la chiave (passaggi da 2 a 13) e di incollarla nella procedura guidata, oppure di concederti l'accesso agli strumenti per sviluppatori.

   Il test di connessione indica "Connesso", ma una tabella non riesce a sincronizzarsi e restituisce un errore "Accesso negato" oppure rimane vuota.

   Perché: Il problema principale è la mancanza dell'autorizzazione di lettura per quella tabella, oppure il tuo piano HubSpot non include questa funzionalità (i flussi di lavoro richiedono i piani Professional o Enterprise; gli schemi personalizzati richiedono il piano Enterprise; il feedback richiede Service Hub Professional o Enterprise).

   Aggiustare: Apri la chiave (Sviluppo → Chiavi → Chiavi di servizio → nome della chiave), fai clic su Modifica, aggiungi l'ambito dall'elenco delle autorizzazioni e salva, quindi sincronizza di nuovo. Se il tuo piano non include questa funzionalità, disattiva la tabella corrispondente nelle impostazioni di sincronizzazione della connessione.

   Le sincronizzazioni che prima funzionavano correttamente ora non funzionano più e restituiscono il messaggio "Token di accesso non valido o scaduto".

   Perché: Qualcuno ha ruotato o eliminato la chiave. Ruota e fai scadere ora blocca immediatamente la vecchia chiave; Ruota e fai scadere in seguito la blocca dopo 7 giorni.

   Aggiustare: Copia la chiave corrente da Sviluppo → Chiavi → Chiavi di servizio → nome chiave → Mostra → Copia. In Agenti dati, modifica la connessione HubSpot, incollala in Token di accesso app ed esegui il test di connessione.

   Con un token di app privata legacy, alcune tabelle non funzionano e restituiscono l'errore USER_DOES_NOT_HAVE_PERMISSIONS.

   Perché: L'utente di HubSpot che ha creato l'app privata è stato rimosso dall'account.

   Aggiustare: Ruota il token dell'app (Sviluppo → App legacy → app → Ruota) e incolla il nuovo token nella connessione, oppure crea una chiave di servizio.

   Non è possibile trovare "Crea app legacy" o la documentazione di HubSpot definisce le app private come legacy.

   Perché: HubSpot interromperà la creazione di nuove app private legacy (già disattivata per gli account creati a partire dal 28 settembre 2026; disattivata per gli account più vecchi a partire dal 26 ottobre 2026). Le app private esistenti continueranno a funzionare.

   Aggiustare: Creazione di una chiave di servizio (passaggi principali). I token privati dell'app esistenti possono rimanere invariati.

   I dati in Query Streams non corrispondono a quelli visualizzati in HubSpot.

   Perché: La chiave è stata creata in un account HubSpot diverso (ad esempio un account di prova o sandbox).

   Aggiustare: Passa all'account HubSpot corretto, crea una chiave e incollala nella connessione.

   Limiti da conoscere

   • I limiti di HubSpot per le chiavi di servizio e le app private sono: 100 richieste ogni 10 secondi per chiave nei piani Free e Starter, 190 nei piani Professional ed Enterprise, 250 con il componente aggiuntivo API Limit Increase. L'agente si adatta al limite più basso, quindi la prima sincronizzazione completa di un CRM di grandi dimensioni potrebbe richiedere del tempo.
   • Limite giornaliero per account HubSpot: 250.000 richieste per i piani Free e Starter, 625.000 per il piano Professional, 1.000.000 per il piano Enterprise. Il limite è condiviso da tutte le chiavi private di app e di servizio presenti nell'account, pertanto anche le altre integrazioni utilizzano lo stesso budget.
   • La funzione di ricerca CRM di HubSpot, utilizzata dall'agente per recuperare solo i record modificati, consente 5 richieste al secondo per account e un massimo di 10.000 risultati per query.
   • Alcune tabelle dipendono dal tuo piano HubSpot: Flussi di lavoro (Professional o Enterprise), Schemi personalizzati (Enterprise), Feedback (Service Hub Professional o Enterprise).
   • Le chiavi di servizio sono in versione beta pubblica (dal 10 febbraio 2026), pertanto HubSpot potrebbe modificarne i dettagli. HubSpot consiglia di ruotare le chiavi ogni sei mesi.
   • Non sarà possibile creare nuove app private legacy negli account creati a partire dal 28 settembre 2026, né negli account più vecchi creati a partire dal 26 ottobre 2026. Le app e i token esistenti continueranno a funzionare.

   Passaggi verificati l'8 ottobre 2026. Fonti: developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/changelog/service-keys, developers.hubspot.com/blog/hubspot-service-keys-the-right…, developers.hubspot.com/changelog/legacy-private-app-creat…, developers.hubspot.com/docs/apps/legacy-apps/private-apps…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/getting-started/developer-ove…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/developer-tooling/platform/us…, developers.hubspot.com/docs/api-reference/latest/crm/sear…, knowledge.hubspot.com/user-management/hubspot-user-permis…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/acti…, developers.hubspot.com/docs/api-reference/legacy/crm/acti…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/pipe…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/automati…, developers.hubspot.com/docs/api-reference/legacy/marketing…, developers.hubspot.com/docs/api-reference/legacy/account/…, docs.n8n.io/integrations/builtin/credentials/hubspot.

   Nome della società

   Un nome che riconoscerai in seguito, come ad esempio "Database delle vendite".

   Token di accesso all'app

   Un token per app private di HubSpot (inizia con pat-), che si trova in Impostazioni, Integrazioni, App private, la tua app, scheda Autenticazione.

   Cliccare Verifica la connessioneQuando legge Collegato, clicca RisparmiareLa connessione raggiunge il tuo agente in pochi secondi.

   Agenti di dati aperti

   Test fallito? Solitamente si tratta di un'autorizzazione mancante o di credenziali provenienti da un account HubSpot errato. La procedura guidata sopra elenca le problemi comuni e le relative soluzioni.

4. See your data in Query Builder Opzionale

   You can look at your HubSpot account before Excel is involved at all. Open Generatore di query in the portal and pick the connection you just made. The Schema tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click Correre and the rows appear under Risultati. Query Builder is on every plan, Free included.

   On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-in’s Saved Queries list, and on any plan you can copy the SQL into the next step.

5. Aggiungere flussi di query a Excel

   In Excel, vai a Inserisci → Ottieni componenti aggiuntivi, cerca Flussi di querye clicca AggiungiOppure aprilo direttamente da Query Streams su Microsoft AppSourceSul ripiano multifunzione compare il pulsante Query Streams. Accedi con lo stesso account.

   Funziona con Excel per Microsoft 365 su Windows e Mac, e con Excel sul web.

6. Porta il tuo primo tavolo

   Fai clic sul pulsante Query Streams, scegli Trasmetti una querye seleziona la connessione appena stabilita.

   Digita la query che vuoi eseguire. Questa estrae alcune colonne da un hubspot.offerte tavolo:

   Esempio · SQL

   SELECT dealname, dealstage, amount, closedate FROM hubspot.deals ORDER BY closedate DESC LIMIT 100;

   Sotto Scheda di destinazione scegliere Crea un nuovo foglioQuindi premi il pulsante di riproduzione (la freccia ▶). Le righe vengono importate in Excel in uno o due secondi. Premilo di nuovo ogni volta che i dati cambiano e il foglio si aggiornerà automaticamente.

   Non conosci SQL? Build it in Generatore di query first and paste it here, or pick it from Saved Queries if you saved it.

Buone mosse successive

• Salva la query nel portale, così puoi eseguirlo di nuovo con un solo clic, da Excel o Fogli Google.
• Aggiungi un filtro come ad esempio un intervallo di date, in modo che la stessa query possa rispondere "questo mese" senza modifiche.
• Condividi i risultati con un collega. Loro vedono le righe, non le tue credenziali.

Domande che le persone si pongono

Guide correlate

• Da HubSpot a Fogli Google
• Da Stripe a Microsoft Excel
• Da Shopify a Microsoft Excel
• Da Google Analytics 4 a Microsoft Excel
• Esecuzione di query SQL in Excel
• Tutte le guide