# Integração HubSpot CRM

> Conecte o HubSpot ao GS Engage por OAuth e envie automaticamente empresas, contatos, negócios e atividades das suas cadências.

- URL canônica: https://docs.growthstation.app/docs/integracoes/hubspot
- Idioma: pt-BR
- Última atualização: 2026-09-20T08:21:20.467Z
- Produto: GS Engage
- Mantido por: Produto GS Engage
- Revisão editorial: 2026-09-02



<PageHero emoji="🔌" title="Integração HubSpot + GS Engage" description="Conecte o HubSpot ao GS Engage em poucos cliques, sem chave de API, e leve empresas, contatos, negócios e atividades da cadência direto para o seu CRM." gradient="brand" />

Esta integração liga o **HubSpot** ao **GS Engage**. Diferente de outros CRMs, a conexão é feita por **login (OAuth)**: você não precisa copiar chave de API, token ou subdomínio — basta autorizar o GS Engage dentro do próprio HubSpot.

Depois de conectada, cada lead trabalhado em uma cadência integrada vira automaticamente uma **empresa**, um **contato** e um **negócio (deal)** no HubSpot, e as ações da cadência (ligações, e-mails, reuniões e tarefas) ficam registradas no histórico do CRM.

Para entender onde essa integração se encaixa na plataforma, veja também [O que é o GS Engage](/docs/o-que-e-o-gs-engage) e o [Gerenciamento de Leads](/docs/gerenciamento/leads).

<Callout type="info" title="Antes de começar">
  Se você não enxergar a área de <TextHighlight>Integrações</TextHighlight> ou a opção <TextHighlight>HubSpot</TextHighlight>, pode ser falta de permissão de acesso.

  Peça ajuda para um usuário administrador da sua conta e, se necessário, revise as configurações em <TextHighlight>Ajustes e Permissões</TextHighlight>. Para autorizar no HubSpot, você também precisa de um usuário HubSpot com permissão para instalar aplicativos.
</Callout>

🔗 Conectar o HubSpot ao GS Engage [#-conectar-o-hubspot-ao-gs-engage]

A conexão é feita uma única vez. Você autoriza o GS Engage no HubSpot e, a partir daí, a integração fica ativa para todo o projeto.

<Steps>
  <Step num={1} title="Abra os Ajustes de Integrações">
    No GS Engage, acesse <TextHighlight>Ajustes e Permissões</TextHighlight> e vá até a seção de <TextHighlight>Integrações</TextHighlight>.

    Localize o cartão <TextHighlight>HubSpot</TextHighlight>. Enquanto a conexão não existir, ele aparece com o status <TextHighlight>Desconectado</TextHighlight>.
  </Step>

  <Step num={2} title="Clique em Conectar com HubSpot">
    No cartão do HubSpot, clique no botão laranja <TextHighlight>Conectar com HubSpot</TextHighlight>.

    Uma nova janela do HubSpot será aberta para você fazer login e autorizar o acesso.
  </Step>

  <Step num={3} title="Faça login e escolha a conta">
    Na janela do HubSpot, entre com o seu usuário e selecione a **conta (portal)** que deseja integrar.

    Se você administra mais de uma conta HubSpot, confira com atenção qual está selecionada antes de continuar.
  </Step>

  <Step num={4} title="Autorize o acesso">
    Revise as permissões solicitadas e confirme a autorização.

    O HubSpot devolve você ao GS Engage automaticamente e a janela pode se fechar sozinha.
  </Step>

  <Step num={5} title="Confirme o status Conectado">
    De volta ao cartão do HubSpot, o status deve mudar para <TextHighlight>Conectado</TextHighlight> (exibido em verde).

    A partir daí, a integração já pode ser usada nas suas cadências.
  </Step>
</Steps>

<Callout type="tip" title="Sem chave, token ou subdomínio">
  Diferente de integrações como Pipedrive ou Kommo, o HubSpot **não pede chave de API nem subdomínio**. Toda a autorização acontece pelo login no próprio HubSpot (OAuth), e o GS Engage renova o acesso sozinho enquanto a integração estiver ativa.
</Callout>

ℹ️ O que a autorização concede [#ℹ️-o-que-a-autorização-concede]

Ao autorizar, o HubSpot pede sua confirmação para que o GS Engage possa **criar e atualizar registros** no seu CRM. Em termos práticos, a integração passa a poder:

<FieldInfoGroup>
  <FieldInfo title="Empresas, contatos e negócios">
    Ler e criar **empresas**, **contatos** e **negócios (deals)**, além de associá-los entre si.
  </FieldInfo>

  <FieldInfo title="Atividades">
    Registrar **ligações, e-mails, reuniões, tarefas e notas** no histórico dos registros.
  </FieldInfo>

  <FieldInfo title="Funis e usuários">
    Ler os **funis (pipelines)** e **estágios** disponíveis, e a lista de **usuários (owners)** para atribuir o dono do negócio.
  </FieldInfo>
</FieldInfoGroup>

<Callout type="info" title="Acesso limitado ao necessário">
  A autorização serve apenas para enviar e registrar as informações da prospecção. Você pode revogar esse acesso a qualquer momento, tanto pelo GS Engage (Desconectar) quanto pelas configurações de aplicativos conectados do próprio HubSpot.
</Callout>

🔄 O que é sincronizado [#-o-que-é-sincronizado]

Quando um lead de uma cadência integrada avança, o GS Engage cria (ou reaproveita) os registros correspondentes no HubSpot e mantém tudo associado.

<FieldInfoGroup>
  <FieldInfo title="Empresa do lead → Empresa (Company)">
    A empresa do lead vira uma **Empresa** no HubSpot. Se já existir uma empresa com o mesmo domínio, ela é reaproveitada em vez de duplicada.
  </FieldInfo>

  <FieldInfo title="Lead → Contato (Contact)">
    O lead vira um **Contato**, com nome, e-mail e telefone, associado à empresa. Contatos existentes são identificados por e-mail ou telefone para evitar duplicidade.
  </FieldInfo>

  <FieldInfo title="Oportunidade → Negócio (Deal)">
    É criado um **Negócio** associado à empresa e ao contato, no funil e estágio que você definir na cadência. O nome do negócio segue o padrão <TextHighlight>Nome do lead \[Empresa]</TextHighlight>.
  </FieldInfo>
</FieldInfoGroup>

Dados padrão como nome, e-mail, telefone e empresa são mapeados automaticamente para os campos correspondentes do HubSpot — você não precisa configurar esse mapeamento manualmente.

🏷️ Como as atividades da cadência aparecem no HubSpot [#️-como-as-atividades-da-cadência-aparecem-no-hubspot]

Cada ação registrada no GS Engage é convertida no tipo de atividade equivalente do HubSpot e associada ao contato, à empresa e ao negócio:

| Ação no GS Engage               | Vira no HubSpot                                                                 |
| ------------------------------- | ------------------------------------------------------------------------------- |
| Ligação                         | **Ligação (Call)** — com duração, direção, resultado e, quando houver, gravação |
| E-mail                          | **E-mail** registrado com assunto e conteúdo                                    |
| Reunião agendada                | **Reunião (Meeting)** — com título, horário e link, quando disponível           |
| Mensagem de WhatsApp / LinkedIn | **Tarefa** concluída, identificada pelo canal                                   |
| Pesquisa e demais ações         | **Tarefa** concluída no histórico                                               |
| Observações / anotações         | **Nota** vinculada ao registro                                                  |

<Callout type="info" title="Histórico centralizado">
  O objetivo é manter o HubSpot como fonte única do histórico: quem viu o negócio no CRM enxerga as ligações, e-mails e reuniões feitas pela cadência, sem precisar abrir o GS Engage. Para consultar o mesmo histórico dentro da plataforma, veja a [Página do Lead](/docs/gerenciamento/pagina-do-lead).
</Callout>

🎯 Integrar uma cadência com o HubSpot [#-integrar-uma-cadência-com-o-hubspot]

Com a conexão ativa, você define **por cadência** para qual funil, estágio e usuários os leads serão enviados. Assim, cadências diferentes podem alimentar funis diferentes.

Se você ainda não criou sua cadência, siga o passo a passo em [Como criar uma cadência](/docs/gerenciamento/cadencias).

<FieldInfoGroup>
  <FieldInfo title="Enviar Leads desta Cadência para o Hubspot">
    Liga ou desliga a integração do HubSpot para esta cadência. Quando ligado, os campos abaixo ficam disponíveis.
  </FieldInfo>

  <FieldInfo title="Funil do Hubspot">
    Escolhe em qual funil (pipeline) o negócio vai entrar. A lista vem direto do seu HubSpot.
  </FieldInfo>

  <FieldInfo title="Estágio do Funil do Hubspot">
    Escolhe em qual etapa do funil o negócio será criado. As opções dependem do funil selecionado.
  </FieldInfo>

  <FieldInfo title="Usuários que poderão receber o Lead Ganho">
    Define quais usuários do HubSpot podem ser donos do negócio quando o lead for ganho. Você pode selecionar mais de um.
  </FieldInfo>

  <FieldInfo title="Enviar Leads Ganhos de maneira">
    Define se a atribuição do dono será <TextHighlight>Manual</TextHighlight> ou <TextHighlight>Automática</TextHighlight>.
  </FieldInfo>
</FieldInfoGroup>

<Steps>
  <Step num={1} title="Edite a cadência e abra Integrações">
    No <TextHighlight>Banco de Cadências</TextHighlight>, edite a cadência desejada e acesse a seção <TextHighlight>Integrações</TextHighlight>.
  </Step>

  <Step num={2} title="Ative o envio para o HubSpot">
    Abra o bloco <TextHighlight>Integração da Cadência com o Hubspot</TextHighlight> e ligue o switch <TextHighlight>Enviar Leads desta Cadência para o Hubspot</TextHighlight>.
  </Step>

  <Step num={3} title="Escolha Funil e Estágio">
    Selecione o <TextHighlight>Funil do Hubspot</TextHighlight> e, em seguida, o <TextHighlight>Estágio do Funil do Hubspot</TextHighlight> para onde os negócios devem ir.
  </Step>

  <Step num={4} title="Defina os usuários e o modo de envio">
    Em <TextHighlight>Usuários que poderão receber o Lead Ganho</TextHighlight>, selecione os donos elegíveis. Depois, escolha <TextHighlight>Manual</TextHighlight> ou <TextHighlight>Automática</TextHighlight> em <TextHighlight>Enviar Leads Ganhos de maneira</TextHighlight>.
  </Step>

  <Step num={5} title="Salve a cadência">
    Confira as escolhas e salve a cadência. A partir de agora, os leads dessa cadência passam a alimentar o funil escolhido no HubSpot.
  </Step>
</Steps>

<Callout type="warning" title="Atenção ao Funil e Estágio">
  Revise bem o <TextHighlight>Funil do Hubspot</TextHighlight> e o <TextHighlight>Estágio do Funil do Hubspot</TextHighlight> antes de salvar, principalmente no modo <TextHighlight>Automática</TextHighlight>, em que os negócios são atribuídos sem confirmação manual.
</Callout>

👥 Como o dono do negócio é escolhido [#-como-o-dono-do-negócio-é-escolhido]

A atribuição do dono considera os **Usuários que poderão receber o Lead Ganho** que você selecionou na cadência.

<FieldInfoGroup>
  <FieldInfo title="Modo Manual">
    Você escolhe, no momento do envio, qual dos usuários configurados receberá o negócio.
  </FieldInfo>

  <FieldInfo title="Modo Automática">
    O sistema distribui os negócios automaticamente entre os usuários configurados, em rodízio.
  </FieldInfo>
</FieldInfoGroup>

<Callout type="info" title="Reserva de segurança">
  Se o usuário preferido estiver indisponível no HubSpot (por exemplo, desativado), o GS Engage atribui o negócio a outro usuário ativo entre os configurados, para que a criação não falhe.
</Callout>

⛔ Desconectar ou reconectar o HubSpot [#-desconectar-ou-reconectar-o-hubspot]

Como a conexão é por OAuth, não existe "trocar a chave": para reconectar, basta desconectar e conectar de novo.

<Steps>
  <Step num={1} title="Clique em Desconectar">
    No cartão do HubSpot em <TextHighlight>Integrações</TextHighlight>, clique em <TextHighlight>Desconectar</TextHighlight>.
  </Step>

  <Step num={2} title="Confirme a ação">
    Confirme a desconexão na janela que aparece. O status volta para <TextHighlight>Desconectado</TextHighlight>.
  </Step>

  <Step num={3} title="Conecte novamente, se precisar">
    Para reconectar (ou trocar de conta HubSpot), clique de novo em <TextHighlight>Conectar com HubSpot</TextHighlight> e refaça a autorização.
  </Step>
</Steps>

<Callout type="warning" title="Impacto de desconectar">
  Ao desconectar, as cadências integradas deixam de enviar leads para o HubSpot. Ao reconectar, revise as configurações de <TextHighlight>Funil</TextHighlight>, <TextHighlight>Estágio</TextHighlight> e <TextHighlight>Usuários</TextHighlight> nas suas cadências.
</Callout>

💬 Dúvidas comuns [#-dúvidas-comuns]

<FAQ>
  <FAQItem question="Preciso de chave de API ou token para conectar o HubSpot?">
    Não. A conexão do HubSpot é feita por login (OAuth): você apenas autoriza o GS Engage dentro do HubSpot. Não é necessário informar chave de API, token nem subdomínio.
  </FAQItem>

  <FAQItem question="Por que o botão Conectar abre uma nova janela?">
    A autorização acontece no site do HubSpot. A janela serve para você fazer login com segurança e escolher a conta que será integrada. Ao concluir, você volta para o GS Engage.
  </FAQItem>

  <FAQItem question="O lead vira o quê no HubSpot?">
    A empresa do lead vira uma **Empresa**, o lead vira um **Contato** e é criado um **Negócio** associado a ambos, no funil e estágio definidos na cadência. As ações da cadência ficam registradas como ligações, e-mails, reuniões, tarefas e notas.
  </FAQItem>

  <FAQItem question="Preciso mapear os campos manualmente?">
    Não para os dados padrão (nome, e-mail, telefone, empresa): eles são enviados automaticamente para os campos correspondentes do HubSpot.
  </FAQItem>

  <FAQItem question="Como escolho o funil e o estágio de destino?">
    Isso é definido em cada cadência, na seção <TextHighlight>Integrações</TextHighlight>, dentro do bloco <TextHighlight>Integração da Cadência com o Hubspot</TextHighlight>. Cadências diferentes podem enviar para funis diferentes.
  </FAQItem>

  <FAQItem question="O que acontece se eu desconectar?">
    As cadências integradas param de enviar leads para o HubSpot. Ao reconectar, confira novamente o funil, o estágio e os usuários configurados em cada cadência.
  </FAQItem>
</FAQ>

📚 Artigos relacionados [#-artigos-relacionados]

<RelatedArticles>
  <RelatedArticle href="/docs/o-que-e-o-gs-engage" title="O que é o GS Engage" description="Entenda a plataforma de prospecção onde a integração com o HubSpot é configurada." />

  <RelatedArticle href="/docs/gerenciamento/leads" title="Gerenciamento de Leads" description="Organize e trabalhe seus leads antes de enviá-los para o CRM." />

  <RelatedArticle href="/docs/gerenciamento/cadencias" title="Como criar uma cadência" description="Crie a cadência que vai alimentar seu funil no HubSpot." />

  <RelatedArticle href="/docs/gerenciamento/pagina-do-lead" title="Página do Lead" description="Veja histórico e informações do lead dentro do GS Engage." />

  <RelatedArticle href="/docs/integracoes/pipedrive" title="Integração Pipedrive CRM" description="Referência de integração de CRM com lógica semelhante de envio de leads." />

  <RelatedArticle href="/docs/integracoes/kommo" title="Integração Kommo CRM" description="Conecte o Kommo e compare o fluxo de mapeamento e envio de leads." />
</RelatedArticles>

<Callout type="info" title="Ainda precisa de ajuda?">
  Se você continuar com dúvidas, abra uma solicitação para o time:\
  [Central de Solicitações](/docs/configuracoes/tickets-de-suporte)
</Callout>