logo HubSpot

CRM e marketing

Collegare HubSpot per Excel, Fogli Google, IA e REST

Dati CRM come tabelle virtuali: contatti, aziende, trattative, pipeline. Stesso SQL di sola lettura del data warehouse.

Un collegamento, ogni superficie

Dove possono andare i tuoi dati HubSpot

Query Streams trasforma un portale HubSpot in 31 tabelle SQL (contatti, aziende, trattative, ticket, impegni, preventivi, fatture, elenchi e le relative definizioni di pipeline), leggibili da Microsoft Excel, Fogli Google, Power BI, assistenti AI tramite MCP e un endpoint REST. Le associazioni vengono esportate come tabelle separate, quindi i collegamenti da contatto ad azienda e da trattativa a voce specifica sono gestiti tramite una normale JOIN, anziché richiedere un'esportazione da ricomporre manualmente.

  1. Per il tuo team, i fornitori e i partner
  2. HubSpot su Excel Microsoft Excel · Componente aggiuntivo di Excel

    Importa i risultati in tempo reale di HubSpot direttamente in un foglio di calcolo e aggiornali a piacimento: in Excel per desktop, Excel Online e Microsoft 365.

    Guida di HubSpot
  3. Da HubSpot a Fogli Google Componente aggiuntivo Fogli

    Esegui una query HubSpot salvata dalla barra laterale e trascina le righe nel foglio. I collaboratori che condividono il foglio possono aggiornarlo autonomamente.

    Guida di HubSpot
  4. Chiedi a Nova informazioni su HubSpot Nova AI · conversione da testo a SQL

    Poni una domanda in un linguaggio semplice. Nova conosce già le tue tabelle HubSpot, scrive ed esegue la query SQL, spiega la risposta e la rappresenta graficamente: non è necessario scrivere alcuna query né fornire credenziali.

    Come funziona la rosa
  5. HubSpot a Data Viewer Condivisione dei risultati · team, fornitori, partner · telefono, tablet, computer fisso

    Condividi i risultati di HubSpot in tempo reale con chiunque – un collega, un fornitore, un partner – sotto forma di griglia aggiungibile ai segnalibri, che si aggiorna automaticamente all'apertura su smartphone, tablet o computer. L'interlocutore visualizzerà i risultati, senza mai dover accedere al codice SQL o alle credenziali.

    Come funziona il visualizzatore di dati
  6. Per app e sistemi
  7. API REST di HubSpot Endpoint dell'HT

    Pubblica una query HubSpot come endpoint JSON autenticato, accessibile a qualsiasi applicazione, con specifiche OpenAPI 3.1 e raccolte predefinite per Postman, Insomnia e Hoppscotch. Non viene aperta alcuna porta del database.

    Come funziona un'API REST
  8. Da HubSpot a Power BI Power Query M

    Incolla la query Power Query M generata nell'editor avanzato di Power BI e il report leggerà i risultati in tempo reale da HubSpot tramite HTTPS, senza driver ODBC né porte di database aperte.

    Come funziona Power BI
  9. Da HubSpot ad Airtable Piattaforma di automazione

    Sincronizza le righe di HubSpot con una base Airtable a intervalli regolari, oppure recuperale tramite uno script di automazione di Airtable.

    Guida di HubSpot
  10. HubSpot a Baserow Piattaforma di automazione

    Alimenta una tabella Baserow da HubSpot tramite l'endpoint REST, sia in locale che nel cloud di Baserow.

    Guida di HubSpot
  11. HubSpot a SeaTable Piattaforma di automazione

    Mantieni aggiornato il database di SeaTable con i dati di HubSpot senza esportare un file o esporre il database stesso.

    Guida di HubSpot
  12. Da HubSpot a Smartsheet Piattaforma di automazione

    Trasferisci i risultati di HubSpot in una griglia di Smartsheet in modo che piani e report vengano letti dal sistema di origine e non dall'esportazione della settimana precedente.

    Guida di HubSpot
  13. Da HubSpot ad Anvil Anvil Works · Piattaforma per app

    Esegui il backup di un'app Anvil Python con HubSpot tramite l'endpoint REST anziché incorporare le credenziali del database nell'app.

    Guida di HubSpot
  14. Per gli strumenti di intelligenza artificiale
  15. Server HubSpot MCP Clienti di Claude, Cursor e MCP

    Concedi a un assistente IA l'accesso in sola lettura a HubSpot con lo schema necessario per scrivere codice SQL corretto, senza fornire le credenziali nella chat.

    Guida di HubSpot
  16. Consegnato alle persone
  17. Avvisi e report di HubSpot Slack · Discord · Email · Webhook

    Imposta una query HubSpot in modo che venga eseguita una query e i risultati vengano recapitati a Slack, Discord, via email o tramite un webhook firmato, oppure trattieni il messaggio finché il numero di righe, una soglia o una variazione percentuale non superano il valore da te impostato.

    Come funzionano gli avvisi e i report

Come funziona

5 passaggi, nessuna modifica al firewall in entrata

01

Crea un'app privata nel tuo portale HubSpot e assegnale i permessi di sola lettura per gli oggetti che ti interessano.

02

Installa l'agente di rete e incolla il token di accesso. Verrà memorizzato lì; HubSpot comunica solo con la tua rete.

03

Scegli quali delle 31 tabelle sincronizzare e con quale frequenza. Contatti, aziende, trattative, proprietari, pipeline, fasi della pipeline e proprietà sono attivati per impostazione predefinita.

04

Scrivi query SQL standard su hubspot.deals, hubspot.companies e gli altri, oppure lascia che sia Nova a scriverle.

05

Leggi i dati da Excel, Fogli Google, Power BI, MCP o REST e uniscili al tuo database nella stessa istruzione.

Analisi approfondita delle funzionalità

Cosa ti offre HubSpot

Le associazioni sono una tabella, non un puzzle.

Il problema dell'esportazione da HubSpot è che le informazioni interessanti risiedono nei collegamenti tra gli oggetti, e un file CSV di contatti non li contiene. Qui, invece, sono rappresentati in una tabella separata, con entrambe le parti presenti in ogni riga.

  • hubspot.associations contiene l'oggetto di origine, l'oggetto di destinazione, il tipo di associazione e l'etichetta, quindi i contatti di un'offerta o l'azienda di un biglietto sono rappresentati da una semplice JOIN.
  • Sono inclusi tutti i collegamenti: dai contatti alle aziende, dai contatti agli accordi, dalle aziende agli accordi, dagli accordi alle singole voci, dai biglietti ai contatti e dai biglietti alle aziende.
  • Anche le pipeline e le fasi della pipeline sono rappresentate da tabelle separate, pertanto la fase di un accordo corrisponde a un nome e a un ordine anziché a un ID non interattivo.

I 31 tavoli

  • oggetti CRM — contatti, aziende, accordi, biglietti, proprietari, pipeline, fasi della pipeline, prodotti, voci di riga.
  • Impegni — chiamate, email, riunioni, appunti, compiti, comunicazioni.
  • Commercio — preventivi, fatture, abbonamenti, pagamenti, tasse, sconti, commissioni.
  • Marketing — eventi_di_marketing, moduli, invio_di_moduli, invio_di_feedback.
  • Liste e automazione — liste, flussi di lavoro.
  • Definizioni — proprietà, schemi, associazioni.

Dove si trovano effettivamente le tue proprietà personalizzate

È importante essere precisi su questo punto, perché è l'unica cosa che spesso viene fraintesa. Ogni tabella degli oggetti contiene un set fisso di colonne denominate (i campi standard), mentre tutto il resto dei dati restituiti da HubSpot, incluse le proprietà personalizzate, viene memorizzato in una colonna JSON denominata raw_data sulla stessa riga.

  • Nulla viene scartato. Una proprietà personalizzata è interrogabile, ma tramite la colonna JSON anziché come colonna a sé stante.
  • Il file hubspot.properties elenca tutte le definizioni di proprietà relative a quindici tipi di oggetto. — nome, etichetta, tipo, tipo di campo — così puoi cercare cosa esiste e come si chiama.
  • Il file hubspot.schemas contiene le definizioni degli oggetti personalizzati. I record degli oggetti personalizzati non vengono sincronizzati come tabelle separate.
  • Se si desidera che una proprietà personalizzata venga letta come una colonna di primo livello in un foglio di calcolo, è sufficiente estrarla dalla query salvata. In questo modo, l'espressione viene eseguita una sola volta e ogni elemento che utilizza quella query visualizzerà una colonna corretta.

Condiviso da ogni connettore API

Come funziona ogni connettore API

  • Il tuo account diventa tabelle — gli endpoint sono mappati a tabelle SQL tipizzate con chiavi primarie e indici, quindi si scrivono SELECT, JOIN e GROUP BY invece di scorrere il JSON.
  • Sei tu a scegliere cosa sincronizzare e con quale frequenza. — ogni tabella ha il proprio intervallo, oppure non ne ha alcuno. Laddove l'API del fornitore lo supporti, vengono recuperati solo i record modificati dall'ultima esecuzione.
  • La copia è tua — risiede in un file DuckDB crittografato con AES-256-GCM accanto all'agente, sul tuo computer. Non nel nostro cloud.
  • Il venditore riceve solo tue notizie — l'agente chiama l'API direttamente dalla tua rete, quindi Query Streams non ha bisogno del tuo token per rispondere a una query.

Buono a sapersi

  • Si tratta di una copia sincronizzata, non di un proxy in tempo reale. — una query legge i dati già recuperati, quindi restituisce i risultati alla velocità di SQL e non supera mai il limite di richieste API. Le tabelle selezionate possono inoltre aggiornare una riga obsoleta durante la lettura.
  • I limiti tariffari vengono rispettati per te — ogni connettore rispetta ampiamente i limiti pubblicati dal fornitore, quindi una segnalazione non può causare la limitazione della velocità del tuo account per tutto il resto che lo utilizza.
  • Nulla viene buttato via — i campi non denominati dalla tabella vengono conservati in una colonna JSON raw_data che è comunque possibile interrogare.
  • Aggiungilo ai tuoi database — una tabella API e una tabella SQL Server nella stessa istruzione costituiscono una normale query, non un progetto di integrazione.

SQL tra sorgenti diverse

Integra HubSpot con il resto dei tuoi dati

Un CRM sa a chi appartiene il conto; un sistema di elaborazione dei pagamenti sa cosa è stato pagato. Nessuno dei due conosce entrambi i dati, e il numero richiesto a fine trimestre necessita di entrambi nella stessa riga. Ciascuna fonte elabora solo la parte di dati che può gestire, trasmette il risultato e l'unione avviene centralmente: le fonti non comunicano mai tra loro e nulla viene copiato da nessuna parte.

3 connessioni · 3 agenti

HubSpot CRM e marketing
PostgreSQL Motore relazionale
Striscia Pagamenti e fatturazione

Una dichiarazione

-- l'account di HubSpot, la tua riga cliente, la fattura di Stripe
SELEZIONARE   h.industry, COUNT(DISTINCT h.id) AS accounts, SUM(i.amount_due) / 100 AS invoiced
DA     CRM.hubspot.companies1   h
CONGIUNGERE     pg_crm.clienti pubblici2 c ON c.domain = h.domain
CONGIUNGERE     fatturazione.stripe.invoices3 i ON i.customer = c.stripe_id
GRUPPO PER h.industria
ORDINATO DA fatturata DESCRIZIONE;

Le tre parti sono connessione, schema e tabella, e il nome della connessione è quello che le hai assegnato. Le colonne sono a scopo illustrativo; le tue tabelle saranno le tue tabelle. Il join viene eseguito sul dominio aziendale perché un'opportunità di HubSpot non ha un proprio riferimento cliente: il collegamento tra gli oggetti è una riga nella tabella delle associazioni, che è anche interrogabile quando si desidera l'opportunità anziché l'account. Stripe riporta il denaro nell'unità di valuta più piccola, da qui la suddivisione. La modalità di sola lettura si applica a ogni elemento: solo SELECT, WITH ed EXPLAIN, con un limite massimo alla quantità di dati che una singola fonte può fornire per una singola query. Come funzionano le query federate

Dettagli di connessione

Di cosa ha bisogno HubSpot

Autenticazione
Un token di accesso privato all'app, memorizzato sull'agente. Non si tratta di un round trip OAuth che devi mantenere attivo
Si è allungato oltre
HTTPS dalla tua rete a HubSpot. Nessun traffico in entrata.
Schema
hubspot — quindi hubspot.deals, hubspot.contacts, hubspot.associations
Tavoli
31, di cui sette sono attivi per impostazione predefinita: contatti, aziende, accordi, proprietari, pipeline, fasi della pipeline e proprietà
Proprietà personalizzate
Vengono conservati in una colonna JSON chiamata raw_data nella riga dell'oggetto, con le relative definizioni elencate in hubspot.properties. Non vengono aggiunti come colonne.
Incrementale
Attraverso la ricerca CRM di HubSpot sulla data di ultima modifica, vengono rilevate le modifiche ai record esistenti
Rinfrescare
Disponibile su 20 delle tabelle degli oggetti CRM: una query basata su un record lo verifica rispetto a HubSpot prima di rispondere
Limiti di tariffa
Il ritmo è regolato in base ai limiti pubblicati da HubSpot, quindi una segnalazione non può limitare l'accesso al portale per tutti gli altri.
Copia locale
Un file DuckDB crittografato con AES-256-GCM accanto all'agente, sulla tua macchina

La modalità di sola lettura è strutturale. Il connettore non implementa alcuna chiamata di scrittura di HubSpot: ogni richiesta che effettua è una lettura, una ricerca o una lettura batch, quindi una query non può modificare la fase di una trattativa o interagire con un contatto, indipendentemente dallo scopo del token. Tuttavia, impostare l'app privata in modalità di sola lettura è comunque consigliabile.

La sincronizzazione delle associazioni analizza ogni oggetto di ciascun tipo e legge i collegamenti in batch, quindi è la tabella più dispendiosa in termini di risorse. Imposta un intervallo più lungo rispetto alle tabelle degli oggetti, a meno che tu non abbia effettivamente bisogno di collegamenti aggiornati in tempo reale.

Documentazione del fornitore: www.hubspot.com

FAQ

Domande su HubSpot

Quali strumenti sono in grado di leggere i dati di HubSpot tramite Query Streams?

Tutto questo, da un'unica connessione: Excel, Fogli Google, MCP, API REST, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, avvisi e report programmati. Collega l'account una sola volta e ogni strumento leggerà la stessa connessione di sola lettura: non è necessaria alcuna configurazione per ogni strumento e non ci sono seconde copie dei dati.

Devo aprire una porta del firewall per il mio account HubSpot?

No. L'agente di rete Query Streams viene eseguito all'interno della rete locale e apre una singola connessione crittografata in uscita. Nessun altro sistema intercetta il traffico in entrata, non è necessaria una VPN e l'account mantiene le regole del firewall esistenti.

È possibile modificare i dati in HubSpot tramite Query Streams?

No. L'agente impone la sola lettura nel punto di esecuzione: un'istruzione alla volta, solo SELECT e simili. Le credenziali rimangono sull'agente e non vengono mai inviate a Query Streams.

Di cosa ha bisogno Query Streams per connettersi a HubSpot?

Un host raggiungibile, un ruolo e la relativa password: l'agente ospita il driver, quindi non viene installato nulla sull'account. Autenticazione: un token di accesso privato all'app, memorizzato sull'agente. Non si tratta di un round trip OAuth che devi mantenere attivo. Accesso tramite: HTTPS dalla tua rete a HubSpot. Nessuna connessione in entrata. Schema: hubspot, quindi hubspot.deals, hubspot.contacts, hubspot.associations. Tabelle: 31, di cui sette attive per impostazione predefinita: contacts, companies, deals, owners, pipelines, pipeline_stages e properties.

Posso collegare HubSpot a un altro database nella stessa query?

Sì, si tratta di una query federata. Un'unica istruzione può fare riferimento a HubSpot e alle altre connessioni contemporaneamente, come indicato in `connection.schema.table`. Ogni origine esegue solo la parte di cui è competente e restituisce il risultato; l'unione avviene centralmente, quindi le origini non si connettono mai tra loro e nulla viene copiato o pianificato. La modalità di sola lettura si applica a ogni parte (solo SELECT, WITH ed EXPLAIN) e esiste un limite massimo alla quantità di dati che una singola origine può cedere per una singola query. Le query federate sono una funzionalità a pagamento; la pagina delle query federate riporta i limiti attuali relativi alle origini e alle dimensioni.

Metti HubSpot dove si svolge il lavoro

Installa l'agente, configuralo per connettersi al tuo account e scegli una destinazione.

Sola lettura Solo in uscita Le credenziali rimangono sull'agente