Logotipo da HubSpot

CRM e marketing

Conectar HubSpot para Excel, Planilhas Google, IA e REST

Dados de CRM como tabelas virtuais: contatos, empresas, negócios, pipelines. O mesmo SQL somente leitura do seu data warehouse.

Comece gratuitamente 13 destinos

Uma conexão, todas as superfícies

Para onde seus dados do HubSpot podem ir

HubSpot dados de API em tempo real como tabelas SQL
Consultas federadas + qualquer outro conector · um SQL de todas as fontes · todos os planos
Agente de rede
  • 1 conexão de saída
  • 0 portas de entrada
  • Somente leitura · credenciais permanecem inalteradas

funciona em

O Query Streams transforma um portal do HubSpot em 31 tabelas SQL — contatos, empresas, negócios, tickets, engajamentos, orçamentos, faturas, listas e as definições de pipeline por trás delas — legíveis no Microsoft Excel, Google Sheets, Power BI, assistentes de IA via MCP e um endpoint REST. As associações são importadas como tabelas separadas, portanto, os vínculos entre contato e empresa e entre negócio e item de linha são feitos por meio de um JOIN comum, em vez de uma exportação que você precisa remontar manualmente.

  1. Para sua equipe, fornecedores e parceiros.

  2. HubSpot para Excel Microsoft Excel · Suplemento do Excel

    Importe resultados do HubSpot em tempo real diretamente para uma planilha e atualize-os sob demanda — Excel para desktop, Excel Online, Microsoft 365.

    Guia do HubSpot

  3. HubSpot para Google Sheets Suplemento de planilhas

    Execute uma consulta salva do HubSpot na barra lateral e arraste as linhas para a planilha. Os colaboradores que compartilharam a planilha podem atualizá-la por conta própria.

    Guia do HubSpot

  4. Pergunte à Nova sobre o HubSpot. Nova AI · texto para SQL

    Faça uma pergunta em linguagem simples. O Nova já conhece suas tabelas do HubSpot, escreve e executa o SQL, explica a resposta e a exibe em um gráfico — sem necessidade de escrever consultas ou fornecer credenciais.

    Como funciona o Nova

  5. HubSpot para Visualizador de Dados Compartilhamento de resultados · equipe, fornecedores, parceiros · celular, tablet, computador

    Compartilhe um resultado do HubSpot em tempo real com qualquer pessoa — um colega, um fornecedor, um parceiro — como uma tabela que pode ser adicionada aos favoritos e que é atualizada automaticamente ao ser aberta em um celular, tablet ou computador. Eles veem os resultados, nunca o SQL ou as credenciais.

    Como funciona o Visualizador de Dados
  6. Para aplicativos e sistemas

  7. API REST do HubSpot endpoint HTTP

    Publique uma consulta do HubSpot como um endpoint JSON autenticado que qualquer aplicativo pode chamar, com uma especificação OpenAPI 3.1 e coleções prontas para Postman, Insomnia e Hoppscotch. Nenhuma porta de banco de dados é aberta.

    Como funciona a API REST

  8. Do HubSpot para o Power BI Power Query M

    Cole o arquivo M do Power Query gerado no Editor Avançado do Power BI e o relatório exibirá os resultados do HubSpot em tempo real via HTTPS — sem driver ODBC, sem necessidade de abrir nenhuma porta de banco de dados.

    Como funciona o Power BI

  9. Do HubSpot para o Airtable Plataforma de automação

    Sincronize linhas do HubSpot com uma base do Airtable de acordo com uma programação ou busque-as dentro de um script de automação do Airtable.

    Guia do HubSpot

  10. HubSpot para Baserow Plataforma de automação

    Alimente uma tabela do Baserow a partir do HubSpot através do endpoint REST — hospedado localmente ou na nuvem do Baserow.

    Guia do HubSpot

  11. HubSpot para SeaTable Plataforma de automação

    Mantenha uma base de dados do SeaTable atualizada com dados do HubSpot sem exportar um arquivo ou expor o banco de dados.

    Guia do HubSpot

  12. Do HubSpot para o Smartsheet Plataforma de automação

    Integre os resultados do HubSpot a uma planilha do Smartsheet para que os planos e relatórios sejam lidos do sistema de origem, e não da exportação da semana passada.

    Guia do HubSpot

  13. Da HubSpot para a Anvil Anvil Works · Plataforma de aplicativos

    Faça backup de um aplicativo Anvil Python com o HubSpot por meio do endpoint REST, em vez de incorporar as credenciais do banco de dados no aplicativo.

    Guia do HubSpot
  14. Para ferramentas de IA

  15. Servidor HubSpot MCP Clientes Claude, Cursor e MCP

    Conceda ao assistente de IA acesso somente leitura ao HubSpot com o esquema necessário para escrever SQL corretamente — sem credenciais no chat.

    Guia do HubSpot
  16. Entregue às pessoas

  17. Alertas e relatórios do HubSpot Slack · Discord · E-mail · Webhook

    Programe uma consulta no HubSpot para que os resultados sejam entregues no Slack, Discord, por e-mail ou por um webhook assinado — ou retenha a mensagem até que a contagem de linhas, um limite ou uma variação percentual ultrapasse o valor definido.

    Como funcionam os alertas e relatórios

Como funciona

5 etapas, sem alteração no firewall de entrada

01

Crie um aplicativo privado no seu portal do HubSpot e atribua a ele permissões de leitura para os objetos que lhe interessam.

02

Instale o Agente de Rede e cole o token de acesso. Ele ficará armazenado lá; o HubSpot só recebe dados da sua própria rede.

03

Escolha quais das 31 tabelas sincronizar e com que frequência. Contatos, empresas, negócios, proprietários, pipelines, estágios do pipeline e propriedades estão ativados por padrão.

04

Escreva consultas SQL comuns para hubspot.deals, hubspot.companies e os demais — ou deixe que o Nova as escreva.

05

Leia os dados do Excel, Planilhas Google, Power BI, MCP ou REST e junte-os ao seu próprio banco de dados na mesma instrução.

Análise detalhada do recurso

O que a HubSpot oferece a você

Associações são uma tabela, não um quebra-cabeça

O que torna as exportações do HubSpot problemáticas é que as informações interessantes estão nos links entre os objetos, e um arquivo CSV de contatos não os inclui. Aqui, eles formam uma tabela separada, com ambos os lados em cada linha.

  • O hubspot.associations contém o objeto de origem, o objeto de destino, o tipo de associação e o rótulo; portanto, os contatos de um negócio ou a empresa de um ingresso são simplesmente um JOIN.
  • Tudo isso está incluído: contatos com empresas, contatos com negócios, empresas com negócios, negócios com itens de linha, tickets com contatos e tickets com empresas.
  • Os pipelines e os estágios do pipeline também são tabelas separadas, portanto, o estágio de um negócio é resolvido para um nome e uma ordem, em vez de um ID opaco.

As 31 mesas

  • Objetos de CRM — contatos, empresas, negócios, ingressos, proprietários, pipelines, estágios_do_pipeline, produtos, itens_de_linha.
  • Compromissos — ligações, e-mails, reuniões, anotações, tarefas, comunicações.
  • Comércio — orçamentos, faturas, assinaturas, pagamentos, impostos, descontos, taxas.
  • Marketing — eventos_de_marketing, formulários, envios_de_formulários, envios_de_feedback.
  • Listas e automação — listas, fluxos de trabalho.
  • Definições — propriedades, esquemas, associações.

Onde suas propriedades personalizadas estão de fato localizadas.

Vale a pena ser preciso quanto a isso, pois é o único aspecto que as pessoas presumem funcionar de forma diferente. Cada tabela de objetos contém um conjunto fixo de colunas nomeadas — os campos padrão — e tudo o mais que o HubSpot retornou, incluindo propriedades personalizadas, é armazenado em uma coluna JSON `raw_data` na mesma linha.

  • Nada é descartado. Uma propriedade personalizada pode ser consultada, mas através da coluna JSON, e não como uma coluna própria.
  • O hubspot.properties lista todas as definições de propriedades em quinze tipos de objetos. — nome, rótulo, tipo, tipo de campo — para que você possa pesquisar o que existe e como se chama.
  • O arquivo hubspot.schemas contém definições de objetos personalizados. Os registros de objetos personalizados não são sincronizados como tabelas próprias.
  • Se você deseja que uma propriedade personalizada seja lida como uma coluna de primeira classe em uma planilha, extraia-a na consulta salva. Isso significa que a expressão é criada uma única vez e, a partir daí, todos os usuários dessa consulta verão a coluna corretamente.

Compartilhado por todos os conectores de API.

Como funciona cada conector de API

  • Sua conta se transforma em mesas — Os endpoints são mapeados para tabelas SQL tipadas com chaves primárias e índices, então você escreve SELECT, JOIN e GROUP BY em vez de percorrer o JSON.
  • Você escolhe o que será sincronizado e com que frequência. — Cada tabela tem seu próprio intervalo, ou nenhum. Quando a API do fornecedor oferece suporte, somente os registros que foram alterados desde a última execução são recuperados.
  • A cópia é sua. — Ele reside em um arquivo DuckDB criptografado com AES-256-GCM, localizado ao lado do agente, em sua máquina. Não está em nossa nuvem.
  • O fornecedor só recebe notícias suas. — o agente chama a API diretamente da sua própria rede, portanto, o Query Streams não precisa do seu token para responder a uma consulta.

Bom saber

  • É uma cópia sincronizada, não um proxy em tempo real. — Uma consulta lê o que já foi buscado, portanto, retorna na velocidade do SQL e nunca consome seu limite de taxa da API. Tabelas selecionadas também podem atualizar uma linha desatualizada à medida que você a lê.
  • Os limites de tarifa são respeitados para você. — cada conector opera bem dentro dos limites publicados pelo fornecedor, portanto, um relatório não pode fazer com que sua conta seja limitada para todos os outros usuários que o utilizam.
  • Nada é desperdiçado. — Os campos que a tabela não nomeia são mantidos em uma coluna JSON raw_data que você ainda pode consultar.
  • Integre-o aos seus bancos de dados. — Uma tabela de API e uma tabela do SQL Server na mesma instrução é uma consulta comum aqui, não um projeto de integração.

SQL entre fontes diferentes

Integre o HubSpot ao restante dos seus dados.

Um CRM sabe quem é o titular da conta; um processador de pagamentos sabe quanto foi pago. Nenhum dos dois sabe ambas as informações, e o número solicitado no final do trimestre exige que ambas estejam na mesma linha. Cada fonte executa apenas a parte que consegue, transmite o resultado de volta e a junção ocorre de forma centralizada — as fontes nunca se comunicam entre si e nada é copiado para lugar nenhum.

3 conexões · 3 agentes

HubSpot CRM e marketing
PostgreSQL Motor relacional
Listrado Pagamentos e faturamento

Uma declaração

-- a conta do HubSpot, sua própria linha de cliente, a fatura do Stripe
SELECIONAR   h.industry, COUNT(DISTINCT h.id) AS accounts, SUM(i.amount_due) / 100 AS invoiced
DE     CRM.hubspot.companies1   h
JUNTAR     pg_crm.clientes.públicos2 c LIGADO c.domínio = h.domínio
JUNTAR     cobrança.stripe.faturas3 i LIGADO i.cliente = c.stripe_id
GRUPO POR h.indústria
ORDER BY faturado DESC;

As três partes são conexão, esquema e tabela — e o nome da conexão é o que você definiu. Colunas ilustrativas; suas tabelas serão suas tabelas. A junção é feita no domínio da empresa porque um negócio do HubSpot não possui uma referência de cliente própria — o vínculo entre os objetos é uma linha na tabela de associações, que também pode ser consultada quando o negócio, e não a conta, é o que você deseja. O Stripe reporta valores monetários na menor unidade de moeda, daí a divisão. O acesso somente leitura se aplica a todas as partes: apenas SELECT, WITH e EXPLAIN, com um limite máximo de dados que uma única fonte pode fornecer para uma consulta. Como funcionam as consultas federadas

Detalhes da conexão

O que a HubSpot precisa

Autenticação
Um token de acesso privado para o aplicativo, armazenado no agente. Não se trata de uma requisição OAuth que você precisa manter ativa.
Estendeu a mão por cima
HTTPS da sua rede para o HubSpot. Nada de entrada.
Esquema
HubSpot — ou seja, hubspot.deals, hubspot.contacts, hubspot.associations
Tabelas
31, dos quais sete estão ativados por padrão: contatos, empresas, negócios, proprietários, pipelines, estágios de pipeline e propriedades.
Propriedades personalizadas
Mantidas em uma coluna JSON `raw_data` na linha do objeto, com suas definições listadas em `hubspot.properties`. Elas não são adicionadas como colunas.
Incremental
Por meio da busca do CRM da HubSpot pela data da última modificação, as edições em registros existentes são detectadas.
Atualização ao vivo
Disponível em 20 das tabelas de objetos do CRM — uma consulta indexada em um registro o verifica no HubSpot antes de responder.
Limites de taxa
O ritmo de acesso foi limitado ao mínimo estabelecido pela HubSpot, portanto, um relatório não pode limitar o acesso ao portal para todos os outros usuários.
Cópia local
Um arquivo DuckDB criptografado com AES-256-GCM ao lado do agente, em sua máquina.

O modo somente leitura é estrutural. O conector não implementa nenhuma chamada de gravação do HubSpot — cada solicitação que ele faz é uma leitura, uma pesquisa ou uma leitura em lote — portanto, uma consulta não pode alterar o estágio de um negócio nem acessar um contato, independentemente do escopo do token. Mesmo assim, ainda vale a pena definir o escopo do aplicativo privado para leitura.

A sincronização de associações percorre cada objeto de cada tipo e, em seguida, lê os links em lotes, sendo, portanto, a tabela mais custosa. Defina um intervalo maior para ela do que o das tabelas de objetos, a menos que você realmente precise dos links atualizados a cada minuto.

Documentação do fornecedor: www.hubspot.com

Perguntas frequentes

Perguntas sobre o HubSpot

Quais ferramentas conseguem ler dados do HubSpot por meio de fluxos de consulta?

Tudo isso, a partir de uma única conexão: Excel, Planilhas Google, MCP, API REST, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, alertas e relatórios agendados. Conecte a conta uma única vez e todas as plataformas lerão a mesma conexão somente leitura — não há configuração por ferramenta nem necessidade de uma segunda cópia dos dados.

Preciso abrir uma porta no firewall para minha conta do HubSpot?

Não. O Agente de Rede do Query Streams é executado dentro da sua rede e abre uma única conexão criptografada de saída. Nada fica à escuta do tráfego de entrada, nenhuma VPN é necessária e a conta mantém suas regras de firewall existentes.

É possível alterar dados com o Query Streams no HubSpot?

Não. O agente impõe o modo somente leitura no ponto de execução — uma instrução por vez, apenas SELECT e similares. As credenciais permanecem no agente e nunca são enviadas para o Query Streams.

O que o Query Streams precisa para se conectar ao HubSpot?

Um host acessível, uma função e sua senha — o agente carrega o driver, portanto, nada é instalado na conta. Autenticação: um token de acesso privado do aplicativo, armazenado no agente. Não é uma comunicação OAuth de ida e volta que você precisa manter ativa. Acesso: HTTPS da sua rede para o HubSpot. Nada de entrada. Esquema: hubspot — portanto, hubspot.deals, hubspot.contacts, hubspot.associations. Tabelas: 31, das quais sete estão ativadas por padrão: contacts, companies, deals, owners, pipelines, pipeline_stages e properties.

Posso integrar o HubSpot a outro banco de dados na mesma consulta?

Sim, trata-se de uma consulta federada. Uma única instrução pode referenciar o HubSpot e suas outras conexões simultaneamente, escritas como conexão.esquema.tabela. Cada origem executa apenas a parte que consegue e transmite o resultado de volta; a junção ocorre centralmente, portanto, as origens nunca se conectam entre si e nada é copiado ou agendado. O modo somente leitura se aplica a cada parte — apenas SELECT, WITH e EXPLAIN — e há um limite para a quantidade de dados que uma origem pode fornecer em uma única consulta. Consultas federadas são um recurso do plano; a página de consultas federadas exibe os limites atuais de origem e tamanho.

Instale o HubSpot onde o trabalho acontece.

Instale o agente, aponte-o para sua conta e escolha um destino.

Comece gratuitamente Todos os conectores

Somente leitura Apenas envio As credenciais permanecem com o agente.