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

Conecte o HubSpot ao Excel

Obtenha dados de HubSpot em Excel

Importe linhas em tempo real da sua conta HubSpot para o Excel e atualize-as quando quiser. Sem driver ODBC, sem exportações, sem macros. Leva cerca de dez minutos na primeira vez, e o plano gratuito cobre isso.

Cerca de 10 minutos Não é necessário programar As credenciais permanecem com você. Excel em qualquer lugar, até mesmo na web.

O resultado final será o que você obterá.

Uma planilha que exibe os resultados em tempo real de uma consulta SQL em sua conta do HubSpot, com um botão que busca as linhas mais recentes sempre que os dados forem alterados. Assim:

Vendas.xlsx — Excel

InícioInserirDadosFluxos de consulta

	A	B	C	D	E
1	ID do cliente	primeiro nome	sobrenome	país	total
2	1042	Maria	Álvarez	EUA	1,284.50
3	1043	Daniel	Okafor	EUA	612.00
4	1047	Priya	Nair	EUA	2,090.75
5	1051	Thomas	Berg	EUA	338.20
6	1056	Lúcia	Ferreira	EUA	1,455.00
7	1060	Kenji	Sato	EUA	874.10
8

Folha1 Direto da HubSpot

O HubSpot armazena seus dados por trás de sua API. Para importá-los para o Excel, geralmente é necessário exportar um arquivo CSV do painel do HubSpot sempre que precisar de novos números. O Query Streams elimina essa necessidade: um pequeno programa auxiliar, chamado Agente, executa a consulta no local onde seus dados estão armazenados, e um suplemento do Excel solicita as linhas desejadas. Somente os resultados são transmitidos por meio de uma conexão criptografada, e o Excel pode ser acessado de qualquer lugar: seu laptop em casa, o computador de um colega em outra cidade ou o Excel na web.

O que você vai precisar

Uma conta do Query Streams

O plano gratuito é suficiente para este guia. Cadastre-se em my.querystreams.com.

O Agente em qualquer computador sempre ligado

Um pequeno programa que roda em segundo plano e acessa o HubSpot quando o Excel solicita. Ele só precisa de acesso à internet.

Seu login do HubSpot

Você fará login no HubSpot uma única vez e concederá acesso de leitura. Nenhuma senha é digitada nos Fluxos de Consulta.

Conecte-o em cinco etapas

1. Crie sua conta

   Vá para my.querystreams.com e inscreva-se. Escolha o Gratuito É um plano real, não uma versão de teste, e inclui a conexão da sua conta HubSpot e a execução de consultas a partir do Excel.

2. Instale o Agente em qualquer computador que esteja sempre ligado.

   Faça login e abra DownloadInstale o Agente em qualquer computador ou servidor que esteja sempre ligado e com acesso à internet. Leva apenas um minuto e, a partir daí, ele inicia automaticamente.

   Por que um programa pequeno em vez de um driver? O Agente é um único instalador para Windows, Mac ou Linux (cerca de 85 MB no Windows, um pouco mais de 100 MB no Mac e Linux) que funciona silenciosamente em segundo plano. Ele estabelece uma única conexão de saída criptografada com o Query Streams, da mesma forma que um navegador, portanto, você não precisa abrir nenhuma porta de firewall nem configurar uma VPN. Suas chaves permanecem nessa máquina e as linhas são enviadas para onde você estiver, pela internet, se necessário. A única coisa do seu lado é o complemento.

   A página de download mostra Sua chave de acessoCole o código no Agente quando solicitado e aguarde até que o crachá exiba a mensagem. Conectado a fluxos de consultaEssa é a única coisa que você faz no próprio Agente.

   Guias completos, se você quiser: Janelas, Mac, Linux.

3. Aponte para sua conta do HubSpot.

   De volta ao seu navegador, abra Agentes de dados (sob Dados (no menu superior). Seu agente está listado lá. Clique Adicionar conector e escolha HubSpotPrecisa das suas credenciais do HubSpot primeiro? Abra o passo a passo e preencha o formulário:

   Crie suas credenciais do HubSpot (cerca de 5 minutos)

   Em seguida, abra o HubSpot em outra aba. O Query Streams armazena o que você cria aqui para que seu agente possa usar, e lê apenas do HubSpot.

   Quem pode fazer isso?

   Superadministrador ou um usuário com permissão de acesso às ferramentas de desenvolvedor (chaves de serviço). Aplicativos privados legados precisam de um superadministrador.

   Recomendado

   Chave de serviço com escopo somente leitura (Desenvolvimento → Chaves → Chaves de serviço). O HubSpot recomenda o uso de chaves de serviço para sincronizações de dados agendadas com ferramentas de BI e data warehouses, e está removendo a opção de criar novos aplicativos privados legados.

   Antes de começar

   • É necessário um login do HubSpot com privilégios de superadministrador ou permissão de acesso às ferramentas de desenvolvedor. Uma chave de serviço só pode ser atribuída aos escopos que seu usuário do HubSpot já possui.
   • Saiba qual conta do HubSpot você deseja consultar. Uma chave só lê a conta na qual foi criada, portanto, crie-a nessa conta, e não em uma conta de teste ou sandbox.
   • Decida quais tabelas do HubSpot você deseja. Contatos, Empresas, Negócios, Proprietários, Pipelines, Estágios do Pipeline e Propriedades estão ativadas por padrão; cada tabela adicional precisa de seu próprio escopo de leitura (consulte Permissões).
   • O agente do Query Streams está instalado e online em um computador sempre ligado, e o portal do Query Streams está aberto em outra guia: Agentes de dados → Adicionar conector → HubSpot.

   Passos

   1. Faça login no HubSpot

      Abra o HubSpot em uma nova aba e faça login como Superadministrador ou como um usuário com permissão de acesso às ferramentas de desenvolvedor.

      Se você possui mais de uma conta HubSpot, alterne para aquela cujos dados você deseja usar antes de continuar. A chave só funciona para a conta em que foi criada.

   2. Desenvolvimento Aberto

      Na barra de navegação principal à esquerda, perto da parte inferior, clique em Desenvolvimento (o ícone </>). A página Desenvolvimento será aberta com sua própria barra lateral: Visão geral, Projetos, Aplicativos legados, Monitoramento, Chaves e muito mais.

      Não encontrou o item de desenvolvimento? Seu usuário do HubSpot não é um superadministrador e não tem acesso às ferramentas de desenvolvedor. Peça a um superadministrador para criar a chave ou para conceder essa permissão a você.

   3. Chaves de serviço abertas

      Na barra lateral de Desenvolvimento, clique em Chaves para expandi-la e, em seguida, clique em Chaves de Serviço (com um selo Beta). A página Chaves de Serviço será aberta; se você ainda não tiver nenhuma, será exibida a mensagem Nenhuma chave de serviço criada.

      Não utilize a Chave de Acesso Pessoal ou a Chave de API do Desenvolvedor, que ficam logo acima das Chaves de Serviço no mesmo menu. Elas são chaves de ferramentas de desenvolvedor e não funcionarão. Algumas contas também acessam esta página através de Configurações (ícone de engrenagem) → Integrações → Chaves de Serviço.

   4. Clique em Criar chave de serviço

      Na parte superior direita da página Chaves de serviço, clique em Criar chave de serviço. A página Criar chave de serviço será aberta com uma caixa Nome e uma seção Escopos.

   5. Dê um nome à chave.

      No campo Nome, digite um nome que você reconhecerá mais tarde, por exemplo, "Fluxos de consulta somente leitura". O HubSpot exibe esse nome em seus registros.

      O nome deve ser único em sua conta HubSpot.

   6. Abra o seletor de escopo.

      Ao lado de Escopos selecionados, clique em + Adicionar novo escopo. Um painel será aberto à direita com uma caixa de pesquisa Encontrar um escopo e uma caixa de seleção para cada escopo.

   7. Selecione os quatro escopos obrigatórios.

      Digite cada nome em "Encontrar um escopo" e marque a caixa de seleção correspondente: crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read, crm.objects.owners.read. Esses quatro escopos abrangem todas as tabelas que o Query Streams sincroniza por padrão.

      Selecione apenas os escopos que terminam em .read. O Query Streams lê apenas do HubSpot; ele nunca precisa de um escopo .write.

   8. Marque os escopos para quaisquer tabelas extras.

      Para cada tabela adicional que desejar, selecione o escopo correspondente na lista de Permissões abaixo. Por exemplo: crm.objects.tickets.read para Tickets; crm.objects.line_items.read para Itens de Linha, Impostos, Descontos e Taxas; crm.lists.read para Listas. Ignore esta etapa se as tabelas padrão forem suficientes.

      Você pode adicionar escopos posteriormente sem criar uma nova chave (abra a chave e clique em Editar).

   9. Clique em Atualizar

      Clique em Atualizar no painel direito. O painel será fechado e seus escopos serão listados em Escopos selecionados.

   10. Confira a lista de escopo

       Leia os escopos selecionados. Se algo terminar em .write, clique em Excluir ao lado. Expanda Resumo dos escopos selecionados se quiser uma lista em linguagem simples do que a chave pode acessar.

   11. Crie a chave

       Clique em Criar no canto superior direito e, em seguida, confirme na caixa de diálogo que se abre.

   12. Abra sua nova chave

       Acesse Desenvolvimento → Chaves → Chaves de serviço e clique no nome da chave que você acabou de criar. A página de detalhes será aberta com uma caixa "Chave de serviço".

   13. Mostre e copie a chave

       Na caixa Chave de serviço, o valor está parcialmente oculto e começa com pat- (por exemplo, pat-na1-…). Clique em Mostrar abaixo dele e, em seguida, clique em Copiar.

       Use a opção Copiar em vez de selecionar o texto manualmente: um caractere ausente, um espaço em branco no final ou os pontos ocultos farão com que o teste falhe. O HubSpot não mostra a chave apenas uma vez; você pode voltar e clicar em Mostrar novamente. Trate-a como uma senha.

   14. Cole-o em Fluxos de Consulta e teste.

       No portal Query Streams, abra Agentes de Dados, clique em Adicionar conector e escolha HubSpot. Cole a chave em Token de Acesso do Aplicativo, digite um nome para a conexão e clique em Testar conexão. O resultado será "Conectado".

       O Query Streams armazena a chave do seu agente e lê apenas os seus dados do HubSpot.

   15. Combine as tabelas com seus escopos.

       Na etapa de sincronização seguinte, deixe ativadas apenas as tabelas do HubSpot cujos escopos você selecionou nas etapas 7 e 8 e, em seguida, conclua o assistente.

       Uma tabela ativada sem o escopo definido não sincroniza e apresenta um erro de "Proibido". Adicione o escopo à chave (passo 8) ou desative a tabela.

   Alternativas

   Use um token de aplicativo privado legado.

   Sua conta já possui um aplicativo privado legado que você deseja reutilizar. O HubSpot está removendo a opção de criar novos aplicativos: contas criadas a partir de 28 de setembro de 2026 já não podem mais ser reutilizadas, e contas mais antigas perderão essa opção em 26 de outubro de 2026. Os aplicativos privados existentes e seus tokens continuarão funcionando.

   Quem pode fazer isso: Superadministrador

   1. Aplicativos legados abertos

      No HubSpot, clique em Desenvolvimento na navegação principal à esquerda e, em seguida, em Aplicativos Legados na barra lateral Desenvolvimento.

      Na versão antiga do HubSpot, essa opção era chamada de Configurações → Integrações → Aplicativos Privados.

   2. Abra seu aplicativo privado ou inicie um novo.

      Se o aplicativo estiver listado, clique no nome dele e vá para a etapa 6 (ou etapa 5 para adicionar escopos). Caso contrário, e se o botão ainda estiver visível, clique em Criar aplicativo legado no canto superior direito e escolha Privado na caixa de diálogo.

      A ausência do botão "Criar aplicativo legado" significa que a criação já está desativada para sua conta. Em vez disso, use uma chave de serviço (etapas principais).

   3. Dê um nome ao novo aplicativo.

      Na guia Informações Básicas, insira um nome como "Fluxos de Consulta somente leitura". O logotipo e a descrição são opcionais.

   4. Adicione os escopos de leitura.

      Clique na guia Escopos, clique em Adicionar novo escopo, selecione os mesmos escopos das etapas principais 7 e 8 e clique em Atualizar. Em seguida, clique em Criar aplicativo no canto superior direito, leia a mensagem do token de acesso na caixa de diálogo e clique em Continuar criando.

   5. Adicionar escopos a um aplicativo existente (somente se necessário)

      Na página do aplicativo, clique em Editar aplicativo no canto superior direito, abra a guia Escopos, adicione os escopos de leitura ausentes e salve. A string do token não muda quando você altera os escopos.

   6. Exibir e copiar o token

      Na página do aplicativo, clique na guia Autenticação. Em Token de acesso, clique em Mostrar token e, em seguida, em Copiar. O token começa com pat-. Cole-o no campo Token de acesso do aplicativo, conforme descrito na etapa 14.

      Se o usuário do HubSpot que criou o aplicativo for removido do HubSpot, algumas chamadas falharão com o erro USER_DOES_NOT_HAVE_PERMISSIONS. Gire o token (clique em "Girar" ao lado) e cole o novo, ou mova-o para uma chave de serviço.

   Use o token de autenticação estático de um aplicativo da plataforma de desenvolvedores.

   Sua equipe já criou um aplicativo HubSpot na nova plataforma de desenvolvedores com a CLI do HubSpot, configurada com autenticação estática e distribuição privada. Para criar outro, é necessário ter a CLI; caso não a possua, utilize uma chave de serviço.

   Quem pode fazer isso: É necessário ser superadministrador ou um usuário com licença de desenvolvedor para visualizar o token; e ter permissão de acesso ao HubSpot Marketplace para instalar o aplicativo.

   1. Abra o projeto

      No HubSpot, clique em Desenvolvimento, depois em Projetos na barra lateral e, em seguida, no nome do projeto que contém seu aplicativo.

   2. Abra o aplicativo

      Na guia Visão geral do projeto, em Componentes do projeto, clique no nome do aplicativo.

   3. Abra a aba Distribuição.

      Clique na aba Distribuição.

   4. Instale o aplicativo, caso ainda não o tenha feito.

      Em Gerenciar distribuição, sua conta atual do HubSpot está listada. Clique em Instalar agora, verifique se o acesso solicitado corresponde aos escopos de leitura que você configurou e clique em Conectar aplicativo.

      Um aplicativo de token estático só pode ser instalado em uma conta padrão do HubSpot por vez.

   5. Exibir e copiar o token

      Após a instalação, a aba Distribuição exibe um token de acesso. Clique em Mostrar para revelá-lo, copie-o e cole-o no campo Token de Acesso do Aplicativo, conforme descrito na etapa 14.

      Se você alterar as permissões do aplicativo posteriormente, reinstale-o usando o URL de reinstalação na guia Distribuição; caso contrário, as novas permissões não serão aplicadas.

   Permissões a conceder

   Recurso	Acesso	Usado para
   crm.objetos.contatos.ler	Ler	Obrigatório. hubspot.contacts, além das tabelas de atividades hubspot.calls, hubspot.emails, hubspot.meetings, hubspot.notes, hubspot.tasks e hubspot.communications (as APIs de atividades do HubSpot usam este escopo), e campos de contato em hubspot.properties e hubspot.associations.
   crm.objetos.empresas.ler	Ler	Obrigatório. hubspot.companies e campos de empresa em hubspot.properties e hubspot.associations.
   crm.objetos.negociações.ler	Ler	Obrigatório. hubspot.deals, os pipelines de negócios em hubspot.pipelines e hubspot.pipeline_stages, e os campos de negócios em hubspot.properties e hubspot.associations.
   crm.objetos.proprietários.ler	Ler	Obrigatório. hubspot.owners, os usuários do HubSpot que possuem registros, para que negócios e contatos possam ser vinculados ao nome de um representante.
   crm.objects.tickets.read	Ler	Somente se você sincronizar os Tickets: hubspot.tickets e os pipelines de tickets em hubspot.pipelines e hubspot.pipeline_stages. Aplicativos mais antigos podem exibir o escopo de tickets legado, que também permite alterações.
   crm.objects.products.read	Ler	Somente se você sincronizar Produtos: hubspot.products. Pesquise produtos no seletor; a API de produtos do HubSpot aceita esse escopo, embora a página de referência de escopos do HubSpot ainda não o liste.
   crm.objects.line_items.read	Ler	Somente se você sincronizar Itens de Linha, Impostos, Descontos ou Taxas: hubspot.line_items, hubspot.taxes, hubspot.discounts, hubspot.fees.
   crm.objects.quotes.read	Ler	Somente se você sincronizar Cotações: hubspot.quotes.
   crm.objects.invoices.read	Ler	Somente se você sincronizar faturas: hubspot.invoices.
   crm.objects.subscriptions.read	Ler	Somente se você sincronizar Assinaturas: hubspot.subscriptions (assinaturas do HubSpot Commerce).
   crm.objects.commercepayments.read	Ler	Somente se você sincronizar Pagamentos: hubspot.payments (pagamentos do HubSpot Commerce).
   crm.objects.marketing_events.read	Ler	Somente se você sincronizar os Eventos de Marketing: hubspot.marketing_events.
   formulários	Leitura e gravação (o HubSpot não possui escopo de formulários somente leitura)	Somente se você sincronizar Formulários ou Envio de Formulários: hubspot.forms e hubspot.form_submissions. O Query Streams lê apenas esses arquivos.
   crm.objects.feedback_submissions.read	Ler	Somente se você sincronizar o Feedback: hubspot.feedback_submissions. Apenas para Service Hub Professional ou Enterprise. A referência de escopo do HubSpot indica crm.objects.feedback_submission.read, então procure por "feedback" no seletor.
   crm.lists.read	Ler	Somente se você sincronizar Listas: hubspot.lists.
   automação	Leitura e gravação (o HubSpot não possui escopo de fluxos de trabalho somente leitura)	Somente se você sincronizar fluxos de trabalho: hubspot.workflows. Apenas para contas Professional ou Enterprise. O recurso Consultar Fluxos lê apenas as definições de fluxo de trabalho.
   crm.schemas.custom.read	Ler	Somente se você sincronizar esquemas personalizados: hubspot.schemas (definições de objetos personalizados). Apenas para contas corporativas.

   Colar em Fluxos de Consulta

   Token de acesso ao aplicativo

   A chave de serviço que você copiou na etapa 13 (ela começa com pat-), ou um token de aplicativo privado legado, ou um token de autenticação estático de um aplicativo de plataforma de desenvolvedor.

   Problemas comuns

   O teste de conexão falha com a mensagem "Token de acesso inválido ou expirado", logo após você colar uma nova chave.

   Por que: O valor não é uma chave de aplicativo ou serviço. A confusão mais comum é com a Chave de Acesso Pessoal ou a Chave de API do Desenvolvedor, que ficam ao lado das Chaves de Serviço em Desenvolvimento → Chaves e são para as ferramentas de desenvolvedor do HubSpot.

   Consertar: Acesse Desenvolvimento → Chaves → Chaves de serviço, abra sua chave, clique em Mostrar, depois em Copiar e cole-a no campo Token de acesso do aplicativo. Teste a conexão novamente; ela deverá exibir "Conectado".

   O assistente exibe a mensagem "Token de aplicativo HubSpot inválido" antes mesmo de realizar o teste.

   Por que: Apenas parte da chave foi colada: o texto não começa com "pat-" e é muito curto ou contém um espaço.

   Consertar: De volta ao HubSpot, clique em Exibir, depois use o link Copiar (não selecione o texto manualmente) e cole novamente.

   Você não consegue ver a opção "Desenvolvimento" na navegação à esquerda do HubSpot, ou a opção "Chaves de serviço" está faltando em "Chaves".

   Por que: Seu usuário do HubSpot não é um superadministrador e não possui permissão de acesso às ferramentas de desenvolvedor.

   Consertar: Peça a um superadministrador da sua empresa para criar a chave (passos 2 a 13) e colá-la no assistente, ou para lhe conceder acesso às ferramentas de desenvolvedor.

   O teste de conexão indica "Conectado", mas uma das tabelas não sincroniza, apresentando um erro de "Proibido" ou permanecendo vazia.

   Por que: O problema principal é a falta de permissão de leitura para essa tabela, ou seu plano do HubSpot não inclui esse recurso (Workflows requer o plano Professional ou Enterprise; Custom Schemas requer o plano Enterprise; Feedback requer o plano Service Hub Professional ou Enterprise).

   Consertar: Abra a chave (Desenvolvimento → Chaves → Chaves de serviço → nome da chave), clique em Editar, adicione o escopo da lista Permissões e salve. Em seguida, sincronize novamente. Se o seu plano não incluir esse recurso, desative a tabela correspondente nas configurações de sincronização da conexão.

   Sincronizações que funcionavam normalmente começam a falhar com a mensagem "Token de acesso inválido ou expirado".

   Por que: Alguém rotacionou ou excluiu a chave. Rotacionar e expirar agora desativa a chave antiga imediatamente; Rotacionar e expirar depois a desativa após 7 dias.

   Consertar: Copie a chave atual em Desenvolvimento → Chaves → Chaves de serviço → nome da chave → Mostrar → Copiar. Em Agentes de dados, edite a conexão do HubSpot, cole-a em Token de acesso do aplicativo e execute Testar conexão.

   Com um token de aplicativo privado legado, algumas tabelas falham com o erro USER_DOES_NOT_HAVE_PERMISSIONS.

   Por que: O usuário do HubSpot que criou o aplicativo privado foi removido da conta.

   Consertar: Gire o token do aplicativo (Desenvolvimento → Aplicativos Legados → aplicativo → Girar) e cole o novo token na conexão ou crie uma chave de serviço.

   Você não consegue encontrar a opção "Criar aplicativo legado", ou a documentação do HubSpot se refere a aplicativos privados como legados.

   Por que: A HubSpot está descontinuando a criação de novos aplicativos privados legados (já desativada para contas criadas a partir de 28 de setembro de 2026; desativada para contas mais antigas a partir de 26 de outubro de 2026). Os aplicativos privados existentes continuarão funcionando.

   Consertar: Criar uma chave de serviço (etapas principais). Os tokens de aplicativo privados existentes podem permanecer.

   Os dados nos fluxos de consulta não correspondem ao que você vê no HubSpot.

   Por que: A chave foi criada em uma conta HubSpot diferente (por exemplo, uma conta de teste ou sandbox).

   Consertar: Acesse a conta correta do HubSpot, crie uma chave lá e cole-a na conexão.

   Limites do conhecimento

   • Os limites do HubSpot para chaves de serviço e aplicativos privados são: 100 solicitações a cada 10 segundos por chave nos planos Free e Starter, 190 nos planos Professional e Enterprise e 250 com o complemento API Limit Increase. O Agent ajusta seu ritmo para o menor desses limites, portanto, a primeira sincronização completa de um CRM grande pode demorar um pouco.
   • Limite diário por conta HubSpot: 250.000 solicitações nos planos Free e Starter, 625.000 no Professional e 1.000.000 no Enterprise. Esse limite é compartilhado por todos os aplicativos privados e chaves de serviço da conta, portanto, outras integrações utilizam o mesmo orçamento.
   • A ferramenta de busca do CRM da HubSpot, que o Agente utiliza para recuperar apenas os registros alterados, permite 5 solicitações por segundo por conta e, no máximo, 10.000 resultados por consulta.
   • Algumas tabelas dependem do seu plano do HubSpot: Fluxos de trabalho (Profissional ou Empresarial), Esquemas personalizados (Empresarial), Feedback (Service Hub Profissional ou Empresarial).
   • As chaves de serviço estão em versão beta pública (desde 10 de fevereiro de 2026), portanto, a HubSpot pode alterar os detalhes. A HubSpot recomenda a rotação das chaves a cada seis meses.
   • Não é possível criar novos aplicativos privados legados em contas criadas a partir de 28 de setembro de 2026, nem em contas mais antigas a partir de 26 de outubro de 2026. Os aplicativos e tokens existentes continuarão funcionando.

   Etapas verificadas em 8 de outubro de 2026. Fontes: 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/marketin…, developers.hubspot.com/docs/api-reference/legacy/account/…, docs.n8n.io/integrations/builtin/credentials/hubspot.

   Nome da conexão

   Qualquer nome que você reconheça mais tarde, como Banco de Dados de Vendas.

   Token de acesso ao aplicativo

   Um token de aplicativo privado do HubSpot (começa com pat-), encontrado em Configurações, Integrações, Aplicativos Privados, seu aplicativo, guia Autenticação.

   Clique em Teste de conexãoQuando lê Conectado, clique SalvarA conexão chega ao seu agente em poucos segundos.

   Agentes de Dados Abertos

   O teste falhou? Geralmente, trata-se de uma permissão ausente ou de uma credencial de uma conta HubSpot incorreta. O passo a passo acima lista as problemas comuns e suas correções.

4. See your data in Query Builder Opcional

   You can look at your HubSpot account before Excel is involved at all. Open Construtor de consultas in the portal and pick the connection you just made. The Esquema 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 Executar and the rows appear under Resultados. 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. Adicionar fluxos de consulta ao Excel

   No Excel, acesse Inserir → Obter suplementos, procurar Fluxos de consultae clique AdicionarOu abra-o diretamente de Consultar fluxos no Microsoft AppSourceUm botão "Consultar fluxos" aparece na faixa de opções. Faça login com a mesma conta.

   Funciona no Excel para Microsoft 365 no Windows e no Mac, e no Excel na Web.

6. Puxe sua primeira mesa.

   Clique no botão Consultar fluxos e escolha Transmita uma consultaE selecione a conexão que você acabou de fazer.

   Digite a consulta que deseja executar. Esta consulta extrai algumas colunas de uma tabela. hubspot.promoções mesa:

   Exemplo · SQL

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

   Sob Folha de Destino escolher Criar uma nova planilhaEm seguida, pressione o botão de reprodução (a seta ▶). As linhas serão exibidas no Excel em um ou dois segundos. Pressione-o novamente sempre que os dados forem alterados e a planilha será atualizada automaticamente.

   Não conhece SQL? Build it in Construtor de consultas first and paste it here, or pick it from Saved Queries if you saved it.

Boas próximas jogadas

• Salvar consulta no portal, para que você possa executá-lo novamente com um clique, a partir do Excel ou do Google Sheets.
• Adicionar um filtro como um intervalo de datas, para que a mesma consulta possa responder "este mês" sem precisar editar.
• Compartilhe os resultados Com um colega. Eles veem as fileiras, não suas credenciais.

Perguntas que as pessoas fazem

Guias relacionados

• HubSpot para Google Sheets
• Stripe para Microsoft Excel
• Do Shopify ao Microsoft Excel
• Google Analytics 4 para Microsoft Excel
• Executando SQL no Excel
• Todos os guias