Visualizza le categorie

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

7 minuti di lettura

Query Streams trasforma il tuo HubSpot CRM in tabelle interrogabili tramite SQL, consentendoti di importare contatti, aziende, trattative, ticket e dati della pipeline in tempo reale direttamente in Google Sheets. Nessuna codifica API, nessuna esportazione manuale: basta scrivere SQL e ottenere analisi CRM in tempo reale nel proprio foglio di calcolo. Iscriviti gratuitamente su QueryStreams.com e inizia a interrogare il tuo account HubSpot in pochi minuti.

Oltre 25 tabelle HubSpot

Interroga contatti, offerte, ticket, aziende e tutta la cronologia delle interazioni

Sincronizzazione in 5 minuti

Le offerte e i biglietti vengono aggiornati ogni 5 minuti: il flusso è sempre aggiornato.

Crittografato con AES-256

Cache API e credenziali archiviate con crittografia di livello militare

Condivisione sicura

Condividi i risultati delle query senza rivelare le tue credenziali HubSpot

A quali dati HubSpot puoi accedere?

Query Streams sincronizza i dati API di HubSpot con una cache locale crittografata, rendendoli disponibili come tabelle interrogabili tramite SQL. Ogni tabella include un dati_grezzi Colonna JSON con la risposta API completa, comprese tutte le proprietà personalizzate.

CRM di base

  • contatti
  • aziende
  • offerte
  • biglietti
  • proprietari
  • condotte e tappe

Impegni

  • chiamate
  • e-mail
  • riunioni
  • note
  • compiti
  • comunicazioni

Commercio

  • citazioni
  • fatture
  • abbonamenti
  • pagamenti
  • prodotti
  • voci di riga

Marketing

  • moduli e invii
  • marketing_eventi
  • invio_feedback
  • elenchi
  • flussi di lavoro
  • associazioni

Prerequisiti

1

Conto flussi di query

Account gratuito — non è richiesta alcuna carta di credito.

Crea un account gratuito →
2

Agente di rete per i flussi di query

Installato come servizio Windows sulla rete. Crea una connessione sicura solo in uscita.

Installa l'agente →
3

Account HubSpot

Qualsiasi piano HubSpot: Free, Starter, Professional o Enterprise.

4

Token privato dell'app HubSpot

A pat-xxx token di accesso da un'app privata HubSpot. Non sono necessari OAuth o reindirizzamenti del browser.

Documentazione sulle app private HubSpot →
5

Componente aggiuntivo di Fogli Google

Componente aggiuntivo Query Streams installato da Google Workspace Marketplace.

Ottieni il componente aggiuntivo Google Sheets →

Guida all'installazione

1
2
3
4
5

Passaggio 1: installare Query Streams Network Agent

  1. Accedi a my.querystreams.com e vai a Agenti di rete
  2. Cliccare Scarica agente ed eseguire il programma di installazione
  3. L'agente si installa come servizio Windows e si connette automaticamente.
  4. Il tuo agente appare come Online nel portale entro 30 secondi
Connessione solo in uscita: Network Agent effettua solo connessioni HTTPS in uscita. Nessuna porta in entrata, nessuna modifica al firewall, nessuna VPN richiesta. I tuoi dati HubSpot non passano mai attraverso i server Query Streams.
2
3
4
5

Passaggio 2: crea un'app privata HubSpot

Le app private ti forniscono un semplice token di accesso: nessun flusso OAuth, nessun reindirizzamento del browser, nessuna rotazione del token di aggiornamento.

  1. Accedi al tuo Account HubSpot
  2. Fare clic sul pulsante icona dell'ingranaggioIntegrazioniApp private
  3. Cliccare Crea un'app privata e assegnagli un nome (ad esempio, "Query Streams")
  4. Vai al Ambito di applicazione scheda e abilita: crm.oggetti.contatti.leggi, crm.oggetti.aziende.lettura, crm.oggetti.offerte.lettura, crm.oggetti.proprietari.lettura, biglietti, commercio elettronico
  5. Cliccare Crea app, quindi Mostra token e copia il pat-xxx gettone
Accesso in sola lettura: Query Streams richiede solo ambiti di lettura. Non creiamo, aggiorniamo o eliminiamo mai alcun record HubSpot. I tuoi dati CRM sono al sicuro.
3
4
5

Passaggio 3: aggiungi il connettore HubSpot

  1. Apri l'interfaccia dell'agente di rete all'indirizzo http://localhost:1823
  2. Cliccare Aggiungi connessione → seleziona HubSpot
  3. Incolla il tuo Token di accesso all'app privata (pat-xxx)
  4. Cliccare Collegamento di prova — Query Streams convalida il tuo token e visualizza il tuo ID del portale HubSpot.
  5. Cliccare Avanti — quando richiesto, conservare Installa le query della libreria Query consente di ottenere 20-50 query HubSpot predefinite
  6. Cliccare Risparmiare — la sincronizzazione iniziale inizia immediatamente
4
5

Passaggio 4: configurare la pianificazione della sincronizzazione

Tutte le tabelle HubSpot si sincronizzano automaticamente. Regola la frequenza di sincronizzazione di ciascuna tabella in base all'urgenza dei dati:

5 min
Offerte e biglietti
Pipeline e coda di supporto
15 min
Contatti e aziende
Record CRM attivi
15 min
Voci di linea
Prodotti in offerta
Ogni ora
Prodotti
Aggiornamenti del catalogo
6 ore
Proprietari e condotte
Cambia raramente
5

Passaggio 5: installa il componente aggiuntivo Google Sheets ed esegui le query

  1. Apri Fogli di GoogleEstensioniComponenti aggiuntiviOttieni componenti aggiuntivi
  2. Cerca "Flussi di query" e clicca Installare
  3. Concedi le autorizzazioni richieste
  4. Cliccare EstensioniFlussi di queryApri per aprire la barra laterale
  5. Accedi con il tuo account Query Streams
  6. Cliccare Query salvate → apri il HubSpot cartella — le query predefinite sono organizzate per Pipeline, Contatti, Aziende, Vendite e Assistenza
  7. Seleziona una query, regola eventuali filtri e clicca su Correre — i dati HubSpot in tempo reale popolano il foglio

Sei connesso!

I tuoi dati HubSpot sono disponibili in tempo reale su Google Sheets. Esegui qualsiasi query salvata su richiesta oppure esegui più query in parallelo in schede separate contemporaneamente.

Esempio di query SQL HubSpot

Scrivi query personalizzate nel Query Builder all'indirizzo my.querystreams.com ed eseguirli direttamente da Google Sheets.

Riepilogo delle trattative in corso — Previsioni a 90 giorni SQL
SELECT
    p.label            AS pipeline,
    ps.label           AS stage,
    COUNT(d.id)        AS deal_count,
    SUM(d.amount)      AS total_value,
    AVG(d.amount)      AS avg_deal_size
FROM hubspot.deals d
JOIN hubspot.pipelines p       ON d.pipeline  = p.id
JOIN hubspot.pipeline_stages ps ON d.dealstage = ps.id
WHERE d.closedate >= CURRENT_DATE
  AND d.closedate <= CURRENT_DATE + INTERVAL '90 giorni'
GROUP BY p.label, ps.label, ps.display_order
ORDER BY ps.display_order;
Tasso di successo per rappresentante commerciale — ultimi 90 giorni SQL
SELECT
    o.first_name || ' ' || o.last_name AS rep,
    COUNT(CASE WHEN json_extract_string(d.raw_data, '$.properties.hs_is_closed_won') = 'true' THEN 1 END) AS won,
    COUNT(CASE WHEN json_extract_string(d.raw_data, '$.properties.hs_is_closed') = 'true'
               AND json_extract_string(d.raw_data, '$.properties.hs_is_closed_won') = 'false' THEN 1 END) AS lost,
    ROUND(
        COUNT(CASE WHEN json_extract_string(d.raw_data, '$.properties.hs_is_closed_won') = 'true' THEN 1 END)::DECIMAL /
        NULLIF(COUNT(CASE WHEN json_extract_string(d.raw_data, '$.properties.hs_is_closed') = 'true' THEN 1 END), 0) * 100, 1
    ) AS win_rate_pct
FROM hubspot.deals d
JOIN hubspot.owners o ON d.hubspot_owner_id = o.id
WHERE d.updated_at >= CURRENT_DATE - INTERVAL '90 days'
GROUP BY o.id, o.first_name, o.last_name
ORDER BY win_rate_pct DESC;
Contatta il funnel del ciclo di vita SQL
SELECT
    lifecyclestage,
    COUNT(*)                                                    AS contact_count,
    ROUND(COUNT(*)::DECIMAL / SUM(COUNT(*)) OVER () * 100, 1)  AS pct
FROM hubspot.contacts
WHERE lifecyclestage IS NOT NULL
GROUP BY lifecyclestage
ORDER BY
    CASE lifecyclestage
        WHEN 'subscriber'              THEN 1
        WHEN 'lead'                    THEN 2
        WHEN 'marketingqualifiedlead'  THEN 3
        WHEN 'salesqualifiedlead'      THEN 4
        WHEN 'opportunity'             THEN 5
        WHEN 'customer'                THEN 6
        ELSE 99
    END;

Condividi i report HubSpot senza condividere le credenziali

Condivisione sicura delle query: Apri qualsiasi query salvata → Condivisione scheda → inserisci indirizzi e-mail → CondividiI destinatari vedono la query nei loro componenti aggiuntivi Excel e Google Sheets e possono eseguirla su richiesta per ottenere dati in tempo reale. Non vedranno mai il tuo codice SQL, il token dell'app privata o l'account HubSpot: non è richiesta alcuna configurazione tecnica da parte loro.

Domande frequenti

Di quale piano HubSpot ho bisogno? +
Qualsiasi piano HubSpot è compatibile: Free, Starter, Professional o Enterprise. I limiti di velocità variano a seconda del piano (100-200 richieste ogni 10 secondi), ma Query Streams gestisce automaticamente la limitazione della velocità, così non si verificano mai errori.
🔒 I miei dati HubSpot sono al sicuro? +
Sì. La cache API locale è crittografata con AES-256 quando è inattiva. Il token dell'app privata è memorizzato in forma crittografata sul computer dell'utente. L'agente di rete utilizza connessioni HTTPS solo in uscita: nessuna porta in entrata, nessuna modifica al firewall, nessun passaggio di dati attraverso i server Query Streams.
⚙️ Posso accedere alle proprietà personalizzate di HubSpot? +
Sì. Ogni tabella memorizza la risposta completa dell'API HubSpot in un dati_grezzi Colonna JSON. Accedi a qualsiasi proprietà personalizzata utilizzando: json_extract_string(dati_grezzi, '$.properties.il_tuo_campo_personalizzato')
✏️ Query Streams può modificare i miei dati HubSpot? +
No. Query Streams è rigorosamente di sola lettura. Non creiamo, aggiorniamo o eliminiamo mai contatti, trattative o record HubSpot. Gli ambiti delle app private che richiediamo sono tutti .leggi autorizzazioni.
⏱️ Quanto sono aggiornati i dati in Google Sheets? +
L'aggiornamento dei dati dipende dalla tua pianificazione di sincronizzazione. Le trattative e i ticket possono essere aggiornati ogni 5 minuti. Quando clicchi su Correre nell'add-on di Google Sheets, ottieni sempre i dati sincronizzati più recenti: Query Streams utilizza sincronizzazioni incrementali con HubSpot. data dell'ultima modifica filtro per recuperare solo i record modificati.

Guide correlate

Categoria: Connettori API

Tag: HubSpot, Fogli Google, Componente aggiuntivo Fogli Google, Dati CRM, API HubSpot, Query SQL, Dati in tempo reale, Contatti, Aziende, Offerte, Ticket, Pipeline, Analisi delle vendite, Flussi di query

Meta Descrizione: Collega HubSpot a Google Sheets con Query Streams. Importa contatti, aziende, trattative e dati della pipeline in tempo reale utilizzando query SQL. Non è richiesta alcuna codifica API.

Updated on 3 giugno 2026

Powered by BetterDocs