Ver categorias

Como conectar o HubSpot ao Google Sheets - Consultar dados de CRM com SQL

7 minutos de leitura

O Query Streams transforma seu HubSpot CRM em tabelas consultáveis por SQL, permitindo que você importe contatos, empresas, negócios, tickets e dados de pipeline em tempo real diretamente para o Google Sheets. Sem codificação de API, sem exportações manuais — basta escrever SQL e obter análises de CRM em tempo real na sua planilha. Inscreva-se gratuitamente em QueryStreams.com e comece a consultar sua conta HubSpot em poucos minutos.

Mais de 25 tabelas do HubSpot

Consulte contatos, negócios, tickets, empresas e todo o histórico de interações.

Sincronização em 5 minutos

Ofertas e ingressos são atualizados a cada 5 minutos — pipeline sempre atualizado

Criptografado com AES-256

Cache da API e credenciais armazenadas com criptografia de nível militar

Compartilhamento seguro

Compartilhe os resultados da consulta sem expor suas credenciais da HubSpot

A quais dados da HubSpot você pode acessar?

O Query Streams sincroniza seus dados da API da HubSpot com um cache local criptografado, expondo-os como tabelas consultáveis por SQL. Cada tabela inclui um dados brutos Coluna JSON com a resposta completa da API — incluindo todas as propriedades personalizadas.

CRM central

  • contatos
  • empresas
  • negócios
  • bilhetes
  • proprietários
  • tubulações e etapas

Compromissos

  • chamadas
  • e-mails
  • reuniões
  • notas
  • tarefas
  • comunicações

Comércio

  • citações
  • faturas
  • assinaturas
  • pagamentos
  • produtos
  • itens da linha

Marketing

  • formulários e envios
  • eventos_de_marketing
  • envio de comentários
  • listas
  • fluxos de trabalho
  • associações

Pré-requisitos

1

Conta de fluxos de consulta

Conta gratuita — não é necessário cartão de crédito.

Criar conta gratuita →
2

Agente de rede de fluxos de consulta

Instalado como um serviço do Windows na sua rede. Cria uma conexão segura somente de saída.

Instale o agente →
3

Conta HubSpot

Qualquer plano da HubSpot — Gratuito, Inicial, Profissional ou Empresarial.

4

Token de aplicativo privado da HubSpot

A pat-xxx token de acesso de um aplicativo privado da HubSpot. Não é necessário OAuth ou redirecionamentos do navegador.

Documentação do HubSpot Private Apps →
5

Complemento do Google Sheets

Complemento Query Streams instalado a partir do Google Workspace Marketplace.

Obtenha o complemento do Google Sheets →

Guia de configuração

1
2
3
4
5

Etapa 1: Instalar o Query Streams Network Agent

  1. Faça login em my.querystreams.com e vá para Agentes de rede
  2. Clique em Baixar Agente e execute o instalador
  3. O agente é instalado como um serviço do Windows e se conecta automaticamente.
  4. Seu agente aparece como Online no portal em 30 segundos
Conexão somente de saída: O Network Agent faz apenas conexões HTTPS de saída. Sem portas de entrada, sem alterações no firewall, sem necessidade de VPN. Seus dados da HubSpot nunca passam pelos servidores do Query Streams.
2
3
4
5

Etapa 2: crie um aplicativo privado da HubSpot

Os aplicativos privados fornecem um token de acesso simples — sem fluxo OAuth, sem redirecionamentos do navegador, sem rotação de tokens de atualização.

  1. Faça login na sua conta Conta HubSpot
  2. Clique no botão ícone de engrenagemIntegraçõesAplicativos privados
  3. Clique em Crie um aplicativo privado e atribua um nome (por exemplo, “Fluxos de consulta”)
  4. Vá para o Âmbitos guia e ative: crm.objetos.contatos.ler, crm.objetos.empresas.ler, crm.objetos.negociações.ler, crm.objetos.proprietários.ler, bilhetes, comércio eletrônico
  5. Clique em Criar aplicativo, então Mostrar token e copie o pat-xxx ficha
Acesso somente leitura: O Query Streams solicita apenas escopos de leitura. Nunca criamos, atualizamos ou excluímos quaisquer registros da HubSpot. Seus dados de CRM estão seguros.
3
4
5

Etapa 3: Adicione o conector HubSpot

  1. Abra a interface do Agente de Rede em http://localhost:1823
  2. Clique em Adicionar conexão → selecionar HubSpot
  3. Cole seu Token de acesso ao aplicativo privado (pat-xxx)
  4. Clique em Conexão de teste — O Query Streams valida seu token e exibe seu ID do portal HubSpot.
  5. Clique em Próximo — quando solicitado, mantenha Instalar consultas da biblioteca de consultas habilitado para obter 20–50 consultas pré-criadas do HubSpot
  6. Clique em Salvar — a sincronização inicial começa imediatamente
4
5

Etapa 4: Configure sua programação de sincronização

Todas as tabelas do HubSpot são sincronizadas automaticamente. Ajuste as frequências por tabela com base na urgência dos dados:

5 min
Ofertas e ingressos
Fila de espera e suporte
15 min
Contatos e empresas
Registros ativos do CRM
15 min
Itens da linha
Produtos em promoção
Por hora
Produtos
Atualizações do catálogo
6 horas
Proprietários e tubulações
Mude raramente
5

Etapa 5: Instale o complemento do Google Sheets e execute consultas

  1. Aberto Planilhas GoogleExtensõesComplementosObter complementos
  2. Pesquisar por “Fluxos de consultas” e clique em Instalar
  3. Conceda as permissões necessárias
  4. Clique em ExtensõesFluxos de consultaAberto para abrir a barra lateral
  5. Faça login com sua conta do Query Streams
  6. Clique em Consultas salvas → abra o HubSpot pasta — as consultas pré-criadas são organizadas por Pipeline, Contatos, Empresas, Vendas e Suporte
  7. Selecione uma consulta, ajuste os filtros e clique em Executar — os dados em tempo real da HubSpot preenchem a planilha

Você está conectado!

Seus dados do HubSpot estão disponíveis no Google Sheets. Execute qualquer consulta salva sob demanda — ou execute várias consultas em paralelo em guias separadas da planilha simultaneamente.

Exemplos de consultas SQL da HubSpot

Escreva consultas personalizadas no Query Builder em my.querystreams.com e executá-los diretamente do Google Sheets.

Resumo do pipeline de negócios — previsão para 90 dias 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 dias'
GROUP BY p.label, ps.label, ps.display_order
ORDER BY ps.display_order;
Taxa de vitórias por representante de vendas — últimos 90 dias 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;
Funil do ciclo de vida do contato SQL
SELECT
    fase_do_ciclo_de_vida,
    COUNT(*)                                                    AS contato_contagem,
    ROUND(COUNT(*)::DECIMAL / SUM(COUNT(*)) OVER () * 100, 1)  AS pct
FROM hubspot.contatos
WHERE fase_do_ciclo_de_vida IS NOT NULL
GROUP BY fase_do_ciclo_de_vida
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;

Compartilhe relatórios do HubSpot sem compartilhar credenciais

Compartilhamento seguro de consultas: Abra qualquer consulta salva → Compartilhamento guia → insira e-mails → CompartilharOs destinatários veem a consulta nos complementos do Excel e do Google Sheets e podem executá-la sob demanda para obter dados em tempo real. Eles nunca veem seu código SQL, token de aplicativo privado ou conta HubSpot — sem necessidade de configuração técnica da parte deles.

Perguntas frequentes

Qual plano da HubSpot eu preciso? +
Qualquer plano da HubSpot funciona — Gratuito, Inicial, Profissional ou Empresarial. Os limites de taxa variam de acordo com o plano (100–200 solicitações por 10 segundos), mas o Query Streams lida com a limitação automaticamente para que você nunca encontre um erro.
🔒 Os meus dados do HubSpot estão seguros? +
Sim. O cache da API local é criptografado com AES-256 em repouso. Seu token de aplicativo privado é armazenado criptografado em sua máquina. O agente de rede usa conexões HTTPS somente de saída — sem portas de entrada, sem alterações no firewall, sem passagem de dados pelos servidores do Query Streams.
⚙️ Posso acessar propriedades personalizadas do HubSpot? +
Sim. Cada tabela armazena a resposta completa da API da HubSpot em um dados brutos Coluna JSON. Acesse qualquer propriedade personalizada usando: json_extract_string(dados_brutos, '$.properties.seu_campo_personalizado')
✏️ O Query Streams pode modificar meus dados do HubSpot? +
Não. O Query Streams é estritamente somente leitura. Nunca criamos, atualizamos ou excluímos nenhum contato, negócio ou registro da HubSpot. Os escopos de aplicativos privados que solicitamos são todos .ler permissões.
⏱️ Quão atualizados são os dados no Google Sheets? +
A atualização dos dados depende da sua programação de sincronização. As negociações e os tickets podem ser atualizados a cada 5 minutos. Ao clicar em Executar No complemento do Google Sheets, você sempre obtém os dados sincronizados mais recentes — o Query Streams usa sincronizações incrementais com o HubSpot. data da última modificação filtro para buscar apenas registros alterados.

Guias relacionados

Categoria: Conectores de API

Tags: HubSpot, Google Sheets, complemento do Google Sheets, dados de CRM, API do HubSpot, consultas SQL, dados em tempo real, contatos, empresas, negócios, tickets, pipeline, análise de vendas, fluxos de consultas

Meta Descrição: Conecte o HubSpot ao Google Sheets com o Query Streams. Importe contatos, empresas, negócios e dados do pipeline em tempo real usando consultas SQL. Não é necessário codificação de API.

Atualizado em 3 de junho de 2026

Desenvolvido por BetterDocs