Como conectar Hubspot

Assim como nas demais integrações, conectar sua conta do Hubspot é essencial para liberar os dashboards dentro do V4MOS.AI. A integração permite importar dados de empresas, contatos, deals e produtos do seu CRM, com atualizações diárias e visualizações no Painel e em Análises. Este guia explica todo o processo passo a passo.


1. Acessando a área de conexões

Entre na organização em que deseja ver os dados. Em seguida:

  • No menu lateral esquerdo, abra a seção Gestão dos dados

  • Clique em Contas conectadas

Essa página mostra todas as integrações já existentes na sua organização.


2. Iniciando a conexão com o Hubspot

Em Contas conectadas, clique em + Nova conexão.

Você será direcionado à página "Conecte com suas ferramentas", onde é possível filtrar por categoria (Todas, Mídia, Analytics, CRM, E-commerce, Landing Page).

Localize o card Hubspot e clique em Conectar para começar o processo.


3. Informando o ID da conta

No passo 1 de 6, o título da etapa é Informe seu ID da conta. A plataforma orienta a acessar sua conta, abrir o menu no canto superior direito e copiar o ID exibido abaixo de "Conta".

  • Acesse sua conta no Hubspot

  • Abra o menu no canto superior direito

  • Copie o ID mostrado na área da Conta

  • Cole no campo ID da conta no V4MOS.AI

💡 Clique em Onde encontrar o ID da conta para ver um guia visual de onde localizar essa informação.

Após preencher, clique em Avançar.


4. Criando um aplicativo no Hubspot

Antes de avançar, você precisa criar um aplicativo privado diretamente na sua conta Hubspot:

  • No menu lateral esquerdo, acesse Desenvolvimento

  • No menu "Desenvolvimento", acesse Aplicativos antigos

  • Clique no botão Criar aplicativo antigo

  • Na janela "Criar aplicativos antigos", selecione o tipo Privado

  • Na seção "Informações básicas", preencha o campo Nome com: V4MOS.AI

💡 Clique em Ver demonstração para acompanhar um vídeo guiado do processo.

Após concluir, clique em Avançar no V4MOS.AI.


5. Configurando os escopos

Com o aplicativo criado, agora você precisa configurar as permissões de leitura:

  • Na seção "Escopos", clique em Adicionar novo escopo

  • Na barra de busca, procure pelos itens abaixo e selecione cada um deles:

    • crm.objects.companies.read

    • crm.objects.contacts.read

    • crm.objects.deals.read

    • crm.objects.products.read

  • Clique no botão Atualizar para adicionar os escopos selecionados

  • Clique em Criar aplicativo no canto superior direito

  • Na janela "Criar um novo aplicativo privado", clique em Continuar criando

ℹ️ Uso dos dados: O V4MOS.AI não realizará modificações na sua conta — apenas realizamos leitura de dados para melhores insights na plataforma.

💡 Clique em Ver demonstração para acompanhar um vídeo guiado do processo.

Após concluir, clique em Avançar no V4MOS.AI.


6. Informando o token de acesso

Com o aplicativo configurado, agora você precisa copiar o token de acesso:

  • Na página do aplicativo criado, acesse a aba de Autenticação

  • Na seção "Token de acesso", clique em Exibir token

  • Copie o token exibido e cole-o no campo Token de acesso no V4MOS.AI

💡 Clique em Ver demonstração para acompanhar um vídeo guiado do processo.

Após preencher, clique em Avançar.


7. Período de importação de dados

Agora você definirá a partir de quando os dados serão importados:

  • Selecione a data ou período a partir do qual você deseja coletar os dados da sua conta

  • O sistema trará todos os dados do período escolhido até hoje

  • A partir da conexão, os dados serão atualizados diariamente

Após configurar, clique em Avançar.


8. Resumo e conclusão

Na tela de resumo, revise os dados da sua conta antes de concluir a conexão:

  • Conta: ID da conta Hubspot conectada

  • Data de início da importação: data selecionada no passo anterior

A partir dessa data, o V4MOS.AI começará a importar os dados da sua conta Hubspot. As atualizações ocorrem diariamente entre 02h e 10h.

Confira tudo e clique em Concluir.


9. Acompanhando o status da integração

Após concluir, você será direcionado de volta para Contas conectadas, onde poderá acompanhar o status da importação.

  • A conexão inicial pode levar entre 15 e 60 minutos (ou alguns minutos, conforme o volume)

  • O status aparecerá na própria listagem

  • Você receberá uma notificação por e-mail quando a integração estiver pronta

  • Após isso, os dados passam a aparecer no Painel e em Análises


Conclusão

Conectar sua conta do Hubspot envolve a criação de um aplicativo privado, a configuração dos escopos de leitura e a cópia do token de acesso — iniciando por Gestão dos dados → Contas conectadas → + Nova conexão e o assistente de conexão com o Hubspot em 6 passos.

O processo garante que o V4MOS.AI acesse apenas os dados necessários, sem realizar modificações na sua conta Hubspot.