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.
Integração HubSpot + GS Engage
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.
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 e o Gerenciamento de Leads.
Antes de começar
Se você não enxergar a área de Integrações ou a opção HubSpot, 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 Ajustes e Permissões. Para autorizar no HubSpot, você também precisa de um usuário HubSpot com permissão para instalar aplicativos.
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.
Abra os Ajustes de Integrações
No GS Engage, acesse Ajustes e Permissões e vá até a seção de Integrações.
Localize o cartão HubSpot. Enquanto a conexão não existir, ele aparece com o status Desconectado.
Clique em Conectar com HubSpot
No cartão do HubSpot, clique no botão laranja Conectar com HubSpot.
Uma nova janela do HubSpot será aberta para você fazer login e autorizar o acesso.
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.
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.
Confirme o status Conectado
De volta ao cartão do HubSpot, o status deve mudar para Conectado (exibido em verde).
A partir daí, a integração já pode ser usada nas suas cadências.
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.
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:
Ler e criar empresas, contatos e negócios (deals), além de associá-los entre si.
Registrar ligações, e-mails, reuniões, tarefas e notas no histórico dos registros.
Ler os funis (pipelines) e estágios disponíveis, e a lista de usuários (owners) para atribuir o dono do negócio.
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.
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.
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.
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.
É 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 Nome do lead [Empresa].
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
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 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 |
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.
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.
Liga ou desliga a integração do HubSpot para esta cadência. Quando ligado, os campos abaixo ficam disponíveis.
Escolhe em qual funil (pipeline) o negócio vai entrar. A lista vem direto do seu HubSpot.
Escolhe em qual etapa do funil o negócio será criado. As opções dependem do funil selecionado.
Define quais usuários do HubSpot podem ser donos do negócio quando o lead for ganho. Você pode selecionar mais de um.
Define se a atribuição do dono será Manual ou Automática.
Edite a cadência e abra Integrações
No Banco de Cadências, edite a cadência desejada e acesse a seção Integrações.
Ative o envio para o HubSpot
Abra o bloco Integração da Cadência com o Hubspot e ligue o switch Enviar Leads desta Cadência para o Hubspot.
Escolha Funil e Estágio
Selecione o Funil do Hubspot e, em seguida, o Estágio do Funil do Hubspot para onde os negócios devem ir.
Defina os usuários e o modo de envio
Em Usuários que poderão receber o Lead Ganho, selecione os donos elegíveis. Depois, escolha Manual ou Automática em Enviar Leads Ganhos de maneira.
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.
Atenção ao Funil e Estágio
Revise bem o Funil do Hubspot e o Estágio do Funil do Hubspot antes de salvar, principalmente no modo Automática, em que os negócios são atribuídos sem confirmação manual.
A atribuição do dono considera os Usuários que poderão receber o Lead Ganho que você selecionou na cadência.
Você escolhe, no momento do envio, qual dos usuários configurados receberá o negócio.
O sistema distribui os negócios automaticamente entre os usuários configurados, em rodízio.
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.
Como a conexão é por OAuth, não existe "trocar a chave": para reconectar, basta desconectar e conectar de novo.
Clique em Desconectar
No cartão do HubSpot em Integrações, clique em Desconectar.
Confirme a ação
Confirme a desconexão na janela que aparece. O status volta para Desconectado.
Conecte novamente, se precisar
Para reconectar (ou trocar de conta HubSpot), clique de novo em Conectar com HubSpot e refaça a autorização.
Impacto de desconectar
Ao desconectar, as cadências integradas deixam de enviar leads para o HubSpot. Ao reconectar, revise as configurações de Funil, Estágio e Usuários nas suas cadências.
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.
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.
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.
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.
Como escolho o funil e o estágio de destino?
Isso é definido em cada cadência, na seção Integrações, dentro do bloco Integração da Cadência com o Hubspot. Cadências diferentes podem enviar para funis diferentes.
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.
Ainda precisa de ajuda?
Se você continuar com dúvidas, abra uma solicitação para o time:
Central de Solicitações
Este artigo foi útil?
Como integrar o GS Engage ao RD Station CRM?
Conecte o GS Engage ao RD Station CRM para enviar automaticamente leads ganhos como oportunidades no funil de vendas.
Integração Salesforce CRM
Conecte o Salesforce ao GS Engage via login OAuth, mapeie os campos para Conta, Contato e Oportunidade e envie leads da cadência para o funil certo.