> ## Documentation Index
> Fetch the complete documentation index at: https://strattumai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot CRM

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

<Note>
  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](/data-pipelines/quickstart).
</Note>

## 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

<CardGroup cols={2}>
  <Card title="Conta HubSpot ativa" icon="circle-check">
    Acesso a uma conta HubSpot com permissão para criar **Private Apps**.
  </Card>

  <Card title="Perfil Admin ou Super Admin" icon="shield-check">
    Apenas usuários com perfil **Admin** ou **Super Admin** podem criar Private Apps no HubSpot.
  </Card>
</CardGroup>

***

## Como criar o Access Token (Private App)

<Steps>
  <Step title="Acesse as configurações do HubSpot">
    No HubSpot, clique no ícone de engrenagem (⚙️) no canto superior direito para abrir **Settings**.
  </Step>

  <Step title="Vá para Integrations → Private Apps">
    No menu lateral de Settings, navegue até **Integrations → Private Apps** e clique em **Create a private app**.
  </Step>

  <Step title="Nomeie o app">
    Dê um nome descritivo, como `strattum-sync`, e adicione uma descrição opcional.
  </Step>

  <Step title="Configure os escopos">
    Na aba **Scopes**, habilite os seguintes escopos de leitura:

    ```
    crm.objects.contacts.read
    crm.objects.companies.read
    crm.objects.deals.read
    ```
  </Step>

  <Step title="Crie o app e copie o token">
    Clique em **Create app** e confirme. Na tela seguinte, copie o **Access Token** gerado.

    <Warning>
      O token é exibido **apenas uma vez**. Copie-o agora e salve em local seguro antes de fechar a janela.
    </Warning>
  </Step>
</Steps>

***

## Como adicionar o conector no Console

<Steps>
  <Step title="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.

    <img src="https://mintcdn.com/strattumai/i8cN28A9sj8ZyCbm/images/connectors/screenshots/hubspot-step1-connectors-list.png?fit=max&auto=format&n=i8cN28A9sj8ZyCbm&q=85&s=e4e276c0ae71483cb6b5db180790b421" alt="Lista de conectores ativos" width="1280" height="800" data-path="images/connectors/screenshots/hubspot-step1-connectors-list.png" />
  </Step>

  <Step title="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.

    <img src="https://mintcdn.com/strattumai/i8cN28A9sj8ZyCbm/images/connectors/screenshots/hubspot-step3-search-result.png?fit=max&auto=format&n=i8cN28A9sj8ZyCbm&q=85&s=03a8f6b0e263095325d336f013d51181" alt="Busca por HubSpot no catálogo de integrações" width="1280" height="800" data-path="images/connectors/screenshots/hubspot-step3-search-result.png" />
  </Step>

  <Step title="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

    <img src="https://mintcdn.com/strattumai/i8cN28A9sj8ZyCbm/images/connectors/screenshots/hubspot-step4-config-modal.png?fit=max&auto=format&n=i8cN28A9sj8ZyCbm&q=85&s=b8faa0ad0a2a5a795a9e112b34044cea" alt="Modal de configuração do conector HubSpot" width="1280" height="800" data-path="images/connectors/screenshots/hubspot-step4-config-modal.png" />

    Clique em **Testar Conexão** para validar o token antes de salvar. Em seguida, clique em **Salvar Conector**.
  </Step>
</Steps>

***

## 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       |

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

***

## Próximos passos

<CardGroup cols={2}>
  <Card title="Guia de desenvolvimento local" icon="terminal" href="/data-pipelines/local-development">
    Configure o ambiente local completo com Prefect, worker e Docker Compose.
  </Card>

  <Card title="Quickstart — Data Pipelines" icon="rocket" href="/data-pipelines/quickstart">
    Ative conectores via Console strattum.ai sem precisar de ambiente local.
  </Card>
</CardGroup>