Ir para o conteúdo principal
Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa. O texto oficial é a versão em inglês e sempre será o texto mais atualizado. Para ver a versão em inglês, clique aqui.

Mapear propriedades da HubSpot para campos do Salesforce

Ultima atualização: 15 de Outubro de 2025

Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:

Após instalar a integração HubSpot-Salesforce, você pode configurar e gerenciar a sincronização entre as propriedades do HubSpot e os campos do Salesforce para contatos, empresas e negócios.

Criar ou editar mapeamentos de campo

Adicionar um novo mapeamento de campo

  1. Na sua conta HubSpot, clique no ícone de <configurações< <settings icon< na barra de navegação superior. No menu da barra lateral esquerda, acesse <Integrações< > <Apps conectados<.
  2. Na lista de aplicativos conectados, clique em Salesforce.
  3. Clique na guia do objeto que você deseja mapear: Contatos, Empresas ou Atalhos.
  4. Clique na guia [Objeto] Mapeamentos de propriedade

Observação: a sincronização de objeto deve estar ativada para Empresas ou Negóciospara configurar mapeamentos de campo de empresa ou negócio entre HubSpot e Salesforce.

Captura de tela mostrando a guia para criar mapeamentos de propriedades do contato para a integração do Salesforce no HubSpot.
  1. Para adicionar uma nova reunião de campo, clique em Adicionar novo mapeamento de campo
  2. No painel direito, use os menus suspensos para selecionar o campo propriedade e Salesforce HubSpot que deseja mapear. Você deve selecionar propriedades e mapas de campo compatíveis para criar um mapeamento. A tabela a seguir mostra os tipos de campo de propriedades HubSpot que podem ser sincronizados com o Salesforce, os nomes de API correspondentes e os tipos de campo correspondentes do Salesforce.
Tipo de campo de propriedade HubSpot Tipo de campo do Salesforce
Seleção suspensa/Seleção por rádio

lista de seleção, referência

Várias caixas de seleção lista de seleção múltipla
Caixa de seleção única booleano
Número duplo/int
Texto de linha única cadeia de caracteres, área de texto
Texto com várias linhas textarea
Selecionador de data data, data e hora

Observe o seguinte:

  • Se houver uma incompatibilidade de tipos ou se uma das propriedades ou campos selecionados já estiver mapeada, uma mensagem será exibida acima dos menus suspensos. Clique na mensagem para saber mais.
  • Quaisquer propriedades personalizadas com o tipo de campo de usuário HubSpot não podem ser mapeadas para campos do Salesforce.

 

Captura de tela mostrando uma mensagem de erro no HubSpot quando a propriedade selecionada já está mapeada ou se há uma incompatibilidade de tipos.

  1. Clique em Avançar.

Selecionar uma regra de sincronização

  1. A regra de sincronização para seu mapeamento determina como os dados serão sincronizados entre o HubSpot e o Salesforce. Selecione uma regra de sincronização nas seguintes opções:
    • Preferir Salesforce, a menos que em branco
      • O HubSpot só passará um valor para o Salesforce se não houver valor no momento no Salesforce.
      • Se houver um valor no Salesforce, esse valor sempre substituirá o valor existente no HubSpot.
      • Se você excluir o valor no Salesforce, o valor também será excluído no HubSpot.
    • Sempre usar o Salesforce
      • O HubSpot nunca transmitirá dados para o Salesforce, mesmo que não haja valor no Salesforce.
      • Se houver um valor no Salesforce, o valor sempre substituirá o valor existente no HubSpot.
      • Se você excluir o valor no Salesforce, o valor também será excluído no HubSpot.
    • Bidirecional
      • O valor mais recente sempre substituirá os valores existentes. 
      • Se o valor for excluído no HubSpot, ele também será excluído no Salesforce e vice-versa.
    • Não sincronizar
      • Os dados nunca passarão entre o HubSpot e a Salesforce.
      • Se o valor for excluído no HubSpot, ele não será excluído no Salesforce e vice-versa.

Captura de tela mostrando como selecionar a regra de sincronização para um novo mapeamento de propriedade no HubSpot.


Observe o seguinte:
  • Embora sua conta HubSpot possa mostrar Prefer Salesforce (Preferir Salesforce), a menos que esteja em branco para o mapeamento de Proprietário, o mapeamento de Proprietário só pode ser mapeado de duas maneiras entre HubSpot e Salesforce. O valor do campo Proprietário deve ser uma correspondência exata entre HubSpot e Salesforce. 
  • Os valores existentes em um mapeamento recém-criado não serão sincronizados retroativamente. Para sincronizar valores existentes, você pode ressincronizar manualmente o registro no HubSpot a partir da placa de sincronização do Salesforce, ressincronizar um segmento HubSpot para sincronizar valores em massa com o Salesforce ou executar uma importação do Salesforce para sincronizar valores em massa com o HubSpot.
  1. Clique em Salvar para salvar o mapeamento.

O novo mapeamento aparecerá agora na lista de mapeamentos para o objeto selecionado. Para editar um mapeamento existente, passe o mouse sobre ele e clique em Editar mapeamento.

Depois de adicionar seus mapeamentos, comece a sincronizar o objeto selecionado com o Salesforce clicando para ativar a opção Sincronizar [Objeto] . Para contatos, isso é ativado por padrão e não pode ser desativado. 

Captura de tela mostrando a alternância de sincronização para o objeto da Empresa.

Observe que há um limite de 500 mapeamentos de campo por objeto.

Resolver erros de mapeamento de campo

Quando um mapeamento de campo apresenta erros ou precisa ser atualizado, os dados podem não ser transmitidos entre o HubSpot e a Salesforce. Para corrigir ou atualizar mapeamentos de campo:

  1. Na sua conta HubSpot, clique no ícone de <configurações< <settings icon< na barra de navegação superior. No menu da barra lateral esquerda, acesse <Integrações< > <Apps conectados<.
  2. Clique em Salesforce.
  3. Clique na guia Integridade da sincronização .
  4. Se houver erros ou avisos de sincronização, eles aparecerão na seção Erros de sincronização . Clique no tipo de erro de sincronização para ver mais informações, os registros afetados e executar outras ações. 
  5. Se um mapeamento incluir um campo de lista de seleção do Salesforce, você poderá atualizar o campo para verificar se há novas opções de lista de seleção no Salesforce e adicionar as opções à propriedade de menu suspenso correspondente no HubSpot. Para fazer isso, passe o mouse sobre o mapeamento e clique em Atualizar

Observe: quando os mapeamentos de campo de empresas/contas são ressincronizados em massa, o HubSpot não pode sincronizar mais de 200.000 empresas ao mesmo tempo. Isso pode resultar em uma falha na sincronização de todas as suas atualizações para este erro de mapeamento .

Excluir mapeamentos de campo personalizado

Se não quiser mais sincronizar dados entre uma propriedade HubSpot e um campo do Salesforce em um mapeamento de campo personalizado, você pode excluir o mapeamento.

Observe: somente mapeamentos de campo personalizados podem ser excluídos no HubSpot. Embora os mapeamentos de campo padrão não possam ser excluídos, a sincronização de dados pode ser interrompida definindo a regra de atualização como Não Sincronizar. Isso não se aplica à propriedade do contato de e-mail Cancelado da . 

  1. Na sua conta HubSpot, clique no ícone de <configurações< <settings icon< na barra de navegação superior. No menu da barra lateral esquerda, acesse <Integrações< > <Apps conectados<.
  2. Clique em Salesforce.
  3. Clique na guia de objeto do seu mapeamento: Contatos, Empresas ou Negociações.
  4. Clique na guia [Objeto] Mapeamentos de propriedade
  5. Passe o mouse sobre o mapeamento e clique em Excluir mapeamento.

Captura de tela mostrando a opção para excluir um mapeamento.

Exportar mapeamentos de campo

Para exportar a lista de mapeamentos de campo:

  1. Na sua conta HubSpot, clique no ícone de <configurações< <settings icon< na barra de navegação superior. No menu da barra lateral esquerda, acesse <Integrações< > <Apps conectados<.
  2. Clique em Salesforce
  3. Clique na guia de objeto para os mapeamentos que deseja exportar: Contatos, Empresas ouNegociações.
  4. Clique na guia [Objeto] Mapeamentos de propriedade
  5. Clique em Exportar mapeamentos de campo (CSV)
Esse artigo foi útil?
Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot.