HubSpot CRM

Configure o conector HubSpot para sincronizar contatos, empresas e negócios com a plataforma strattum.ai.

Este guia cobre a configuração do conector HubSpot via Console strattum.ai. Para configurar via código local, consulte o Quickstart de Data Pipelines.

Visão geral

O conector HubSpot extrai dados do HubSpot CRM e os sincroniza com a infraestrutura strattum.ai de forma incremental. A sincronização ocorre automaticamente a cada 15 minutos.

Recurso	Modo de carga	Campo de cursor
Contacts	Incremental	updatedAt
Companies	Incremental	updatedAt
Deals	Incremental	updatedAt

---

Pré-requisitos

Conta HubSpot ativa

Acesso a uma conta HubSpot com permissão para criar Private Apps.

Perfil Admin ou Super Admin

Apenas usuários com perfil Admin ou Super Admin podem criar Private Apps no HubSpot.

---

Como criar o Access Token (Private App)

1. Acesse as configurações do HubSpot

   No HubSpot, clique no ícone de engrenagem (⚙️) no canto superior direito para abrir Settings.

2. Vá para Integrations → Private Apps

   No menu lateral de Settings, navegue até Integrations → Private Apps e clique em Create a private app.

3. Nomeie o app

   Dê um nome descritivo, como strattum-sync, e adicione uma descrição opcional.

4. Configure os escopos

   Na aba Scopes, habilite os seguintes escopos de leitura:

   crm.objects.contacts.read
   crm.objects.companies.read
   crm.objects.deals.read
   
5. Crie o app e copie o token

   Clique em Create app e confirme. Na tela seguinte, copie o Access Token gerado.

   O token é exibido apenas uma vez. Copie-o agora e salve em local seguro antes de fechar a janela.

---

Como adicionar o conector no Console

1. Acesse a seção Conectores

   No menu lateral do Console strattum.ai, clique em Conectores. Você verá a lista de todos os conectores ativos na sua organização.

   
2. Clique em Nova Conexão e busque o HubSpot

   Clique no botão + Nova Conexão no canto superior direito. Na tela de catálogo de integrações, use a barra de busca e digite HubSpot para filtrar.

   
3. Configure o conector

   Clique em Conectar no card do HubSpot. No modal de configuração, preencha os campos:

   • Nome do Conector — ex: HubSpot CRM (usado para identificar o conector na lista)
   • Access Token (Private App) — cole o token gerado na etapa anterior

   

   Clique em Testar Conexão para validar o token antes de salvar. Em seguida, clique em Salvar Conector.

---

Dados sincronizados

Recurso	Incremental	Campo de cursor	Descrição
contacts	Sim	updatedAt	Contatos com propriedades padrão e customizadas
companies	Sim	updatedAt	Empresas e seus atributos
deals	Sim	updatedAt	Negócios com estágio, valor e associações

Os dados ingeridos ficam disponíveis no Data Catalog com linhagem registrada automaticamente — sem nenhuma configuração adicional.

---

Próximos passos

Guia de desenvolvimento local

Configure o ambiente local completo com Prefect, worker e Docker Compose.

Quickstart — Data Pipelines

Ative conectores via Console strattum.ai sem precisar de ambiente local.