Instalar a integração do HubSpot-Salesforce
Ultima atualização: 25 de Agosto de 2025
Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:
|
|
|
|
|
A integração do HubSpot-Salesforce oferece uma transferência fácil de dados entre o HubSpot e o Salesforce, além de manter a consistência entre suas equipes de marketing e vendas.
- a integração do HubSpot-Salesforce não é afetada pela descontinuação das versões legadas da Salesforce Platform API.
- O pacote gerenciado antigo do HubSpot no Salesforce que contém o módulo antigo do Visualforce do HubSpot está sendo descontinuado. Se você ainda estiver usando o módulo Visualforce antigo, recomendamos desinstalar o pacote no Salesforce e usar a HubSpot Embed daqui em diante.
Antes de começar
É possível desfazer a troca entre essas instruções e o Salesforce para parte da configuração de integração e do processo de instalação.
Você deve ter permissões de acesso à conta na sua conta da HubSpot, além das seguintes assinaturas, acessos e permissões na sua conta do Salesforce:
- Uma edição do Salesforce com acesso de API ou Salesforce Professional.
- A integração do HubSpot com o Salesforce também é compatível e pode se conectar à Salesforce Government Cloud. Ela não é compatível o Salesforce Group Edition.
- Ser umadministrador do sistema do Salesforce ou ser atribuído ao Conjunto de permissão de integração do HubSpot (na seção Conjuntos de permissão disponíveis, selecione Permissões de integração do HubSpot).
- Ter todas as seguintes permissões administrativas de perfil do usuário:
- API habilitada.
- Exibir Configuração e Configuração habilitada.
- Modificar tudo em qualquer objeto (contas, campanhas, contatos, leads ou oportunidades) que você gostaria de sincronizar com o HubSpot.
- Tenha a permissão Modificar Metadados (para exibir dados na janela da HubSpot Embed nos registros de lead ou contato do Salesforce). Isso só é necessário se você quiser usar a janela da HubSpot Embed e sincronizar os registros de negócio com a HubSpot.
- Tenha a permissão para Baixar pacotes do AppExchange.
- Tenha a permissão para personalizar perfil de aplicativo. Isso é necessário para instalar a janela da HubSpot Embed e para atualizações automáticas da janela da HubSpot Embed.
- Tenha o campo Tipo de tarefa definido como Visível no seu perfil de usuário.
Observação: se estiver configurando a Sincronização Remota do Salesforce, suas configurações específicas podem variar de acordo com os requisitos, configurações e comportamento padrão descritos abaixo.
Expectativas gerais da integração do HubSpot-Salesforce
- Há um limite de número de chamadas de API usadas pela integração por dia. Uma sincronização de contato simples pode assumir até quatro chamadas de API por registro, mas esse número pode variar.
- Para conectar várias contas do HubSpot a uma instância do Salesforce, você deverá configurar e instalar a integração em cada conta do HubSpot. Você pode conectar apenas uma instância do Salesforce por conta da HubSpot.
Observação: se você estiver integrando duas contas da HubSpot com um ambiente do Salesforce, para a configuração Criação de contatos no HubSpot, é recomendável selecionar Não criar automaticamente contatos do HubSpot. Se uma das outras opções for selecionada, os leads ou contatos do Salesforce criados por uma conta do HubSpot poderão criar contatos na outra conta do HubSpot.
- Os registros não serão sincronizados automaticamente após a instalação e configuração da integração do Salesforce. Você pode importar seus registros do Salesforce para o HubSpot ou permitir que eles sejam sincronizados gradualmente com base nos disparadores de sincronização automática.
Instalar a integração do HubSpot-Salesforce
- Na sua conta HubSpot, clique no ícone do Marketplace marketplace na barra de navegação superior e selecione App Marketplace.
- Use a barra de pesquisa para localizar e selecionar a Integração do Salesforce.
- No canto superior direito, clique em Instalar aplicativo.
- Se você estiver conectando o HubSpot a um sandbox do Salesforce, marque a caixa de seleção Sim, isso conectará a um sandbox.
- Clique em Fazer login no Salesforce.
- Na janela pop-up, insira suas credenciais do Salesforce e clique em Fazer login. Depois de fazer login, você será redirecionado de volta para o processo de instalação no HubSpot.
- A seguir, instale o HubSpot no Salesforce. Clique em Inicie a instalação do pacote do Salesforce para começar ou para acessar o pacote de produção diretamente, clique aqui.
- Você será redirecionado para o Salesforce a fim de instalar o pacote de integração do HubSpot. Selecione Instalar para todos os usuários e, em seguida, clique em Instalar.
- Na caixa de diálogo, marque a caixas de seleção Sim, conceder acesso a sites de terceiros e clique em Continuar.
- O Salesforce instalará o pacote de integração do HubSpot. Esta instalação pode levar até dez minutos.

-
- Você pode ver a mensagem: A instalação desse arquivo está demorando demais. Você receberá um e-mail após a conclusão da instalação.
- Clique em Concluído e aguarde um e-mail da Salesforce com o assunto Instalação da integração do pacote do HubSpot concluída com sucesso.
- Após a instalação do pacote no Salesforce, volte para o assistente do conector do HubSpot e clique em Próximo.
- Em seguida, adicione a janela da HubSpot Embed ao Salesforce.
-
- A janela da HubSpot Embed no Salesforce exibirá um sumário das interações e atividades da HubSpot que o registro do Salesforce tinha, além das associações de registro de objeto e histórico de propriedades.
- Você também pode inscrever registros do Salesforce no fluxos de trabalho do HubSpot e nas sequências diretamente no Salesforce.
- Clique em Adicionar a HubSpot Embed ao Salesforce. Você pode optar por clicar em Ignorar esta etapa e instalar a janela da HubSpot Embed posteriormente.
- Siga as instruções passo a passo na página de instalação para adicionar a janela da HubSpot Embed ao Salesforce ou saiba mais sobre como adicionar a janela da HubSpot Embed aos layouts da página do Salesforce.
- Quando terminar, clique em Próximo.
- Em seguida, escolha como será a sincronização dos dados entre o HubSpot e o Salesforce.
-
- O HubSpot criará mapeamentos entre as propriedades do HubSpot e os campos do Salesforce, independentemente de qual configuração você escolher.
- Se o campo do Salesforce não tiver uma propriedade correspondente do HubSpot, uma nova propriedade será criada no HubSpot por usuário desconhecido.
- Se você selecionar a Configuração recomendada, clique em Analisar configurações.
- Se você selecionar Configurações avançadas, clique em Próximo.
-
- Na tela seguinte, defina as configurações de sincronização do contato:
- Clique no menu suspenso Escolher quais contatos serão sincronizados e selecione Todos os contatos para sincronizar todos os contatos com o Salesforce, ou selecione uma lista do HubSpot para usar como uma lista de inclusão para sincronizar apenas esses contatos com o Salesforce.
- Clique em Próximo.
- Na tela seguinte, defina as configurações de sincronização de atividade e tarefa:
- Clique para ativar a Chave de sincronização de tarefas do Salesforce para criar automaticamente uma tarefa no HubSpot quando ela é criada no Salesforce.
- Na tabela Sincronização da linha de tempo, marque a caixa de seleção Sincronizar ao lado dos eventos do HubSpot a serem sincronizados com o Salesforce como tarefas e clique no menu suspenso Tipo de tarefa do Salesforce para selecionar o tipo de tarefa, e ela será criada como aparece no Salesforce.
- Clique em Próximo.
- Na tela seguinte, defina as configurações de sincronização de objeto e propriedade:
- Clique na guia Contatos, Empresas ou Ofertas para configurar o tipo de sincronização das propriedades padrão desse objeto. Nas guias Empresas e Negócios, talvez seja necessário clicar para ativar ou desativar a opção Ativar sincronização de empresa/transação para poder criar mapeamentos de campos.
- A tabela exibe as propriedades do objeto HubSpot padrão e seus equivalentes dos campos do Salesforce. Para cada sincronização de propriedade, selecione o tipo de sincronização: Preferir Salesforce (padrão), Sempre usar o Salesforce ou Bidirecional. Saiba mais sobre os tipos de sincronização para mapeamentos de campo do Salesforce.
- Clique em Próximo.
- Na tela seguinte, defina as configurações de sincronização do contato:
- Por último, analise as configurações de sincronização de dados selecionadas. Para alterar as configurações para um tipo de sincronização de dados, clique em Alterar.
- Quando terminar, clique em Concluir configuração e comece a sincronizar. Você será redirecionado à sua configuração de integração da Salesforce e os dados entre o HubSpot e o Salesforce começarão a ser sincronizados.