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: 27 de Março de 2026

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

Depois de instalar a integração HubSpot-Salesforce, mapeie as propriedades do HubSpot aos campos do Salesforce para garantir que os dados permaneçam consistentes nos dois sistemas. Quando os campos são mapeados, as atualizações feitas em um sistema podem ser sincronizadas com o outro, dependendo das configurações de sincronização.

Por exemplo, você pode mapear uma propriedade de propriedade do contato do HubSpot, como Cargo , para um campo de lead ou contato do Salesforce para manter os registros alinhados entre as duas plataformas.

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.

  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.

 

  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.

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. 

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

Sincronização do Proprietário

O HubSpot identifica o Salesforce Standard, o PowerPartner, o Salesforce, e o Salesforce proprietários quando:

  • Elas são importadas para o HubSpot a partir do Salesforce.
  • O usuário do Salesforce possui um registro de lead, contato, conta ou Oportunidade que é sincronizado com o HubSpot.

Por padrão, o campo ID do Proprietário em um registro de lead, contato, conta ou Oportunidade do Salesforce será sincronizado com a negócio de Contato/empresa/proprietário do HubSpot .

Como funciona a sincronização do Proprietário

Qualquer proprietário do Salesforce pode sincronizar com o HubSpot, mas somente os proprietários no HubSpot que correspondam ao nome e endereço de email de um usuário ativo do Salesforce serão sincronizados com o Salesforce. Se o HubSpot tentar sincronizar um proprietário que não existe no Salesforce, o campo ID do Proprietário será redefinido para o último valor do Salesforce.

As regras de atribuição de proprietário do Salesforce diferem para contatos, empresas e negócios. Dependendo da regra, o HubSpot pode criar um novo objeto no Salesforce ou sincronizar com um objeto do Salesforce existente. Se você estiver usando a sincronização de linha do tempo, saiba mais sobre como os proprietários são sincronizados para as atividades.

Contato proprietário comportamento de atribuição

Se um contato HubSpot criar um novo lead do Salesforce e for atribuído a um proprietário HubSpot que corresponda ao nome e endereço de e-mail de um usuário ativo do Salesforce antes de sincronizar pela primeira vez com o Salesforce, esse proprietário será atribuído no Salesforce. Caso contrário, as regras de atribuição de leads do Salesforce serão aplicadas.

Após a atribuição inicial de proprietário no HubSpot ou no Salesforce, as alterações no propriedade Contato proprietário no HubSpot ou Proprietário campo ID no Salesforce serão sincronizadas com o outro sistema.

Se um contato do HubSpot sincronizar com um lead existente do Salesforce com um proprietário ativo do Salesforce, as regras de atribuição de leads do Salesforce não serão aplicadas e o proprietário existente do Salesforce será mantido na primeira sincronização. Nas sincronizações subsequentes, o valor de proprietário mais recente atualizará o valor no outro sistema.

Observação: O Salesforce exige que os registros tenham valores de Proprietário . Quando um registro do HubSpot não atribuído é sincronizado com o Salesforce e um novo registro é criado, seu Proprietário é definido como o usuário do Salesforce que o criou, ou seja, o usuário da integração na conta da HubSpot.

Mapear campos de referência do Salesforce para o HubSpot

Os valores dos campos de referência do Salesforce são sincronizados com o HubSpot como IDs de registro de 18 dígitos, não como rótulos. Embora o HubSpot não possa recuperar automaticamente esses rótulos, você pode mapear campos de referência do Salesforce a uma propriedade suspensa do HubSpot para tornar os valores utilizáveis para segmentação e relatórios no HubSpot. 

  1. Na sua conta da HubSpot, crie uma propriedade personalizada da HubSpot com um tipo de campo de seleção no menu suspenso.
  2. Mapeie o campo de referência do Salesforce para a recém-criada propriedade personalizada do HubSpot.
  3. Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.
  4. No menu da barra lateral esquerda, vá para Propriedades.
  5. Clique no nome da propriedade personalizada usada no mapeamento de campo.
  6. No menu da barra lateral esquerda, clique em Tipo de campo
  7. Na seção Opções do menu suspenso , a coluna Nome interno exibirá a ID do registro de 18 dígitos para cada valor de campo de referência do Salesforce. Insira os rótulos de valor de campo correspondentes do Salesforce nos campos Rótulo .
  8. No canto superior direito, clique em Salvar.

Agora você poderá segmentar o campo de referência com base nos rótulos de valor de campo, em vez das IDs de registro de valor de campo.

Observe que este método requer manutenção contínua. Se um novo valor for adicionado ao campo de referência do Salesforce, o rótulo da opção correspondente na propriedade do HubSpot deverá ser editado manualmente seguindo as etapas acima.

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.

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.