Central de conhecimento HubSpot

Entenda seus mapeamentos de campos de sincronização de dados

Written by HubSpot Support | 14/dez/2022 8:07:24

Todos aplicativos de sincronização de dados tenha um conjunto de mapeamentos de campo que mantêm os dados sincronizados entre o HubSpot e seu aplicativo de terceiros. Para visualizar quais mapeamentos padrão estão disponíveis para um aplicativo, consulte o arquivo do aplicativo página de listagem do mercado.

Se você tem um pago Centro de Operações inscrição , você pode criar e personalizar mapeamentos de campos de sincronização de dados. 

Revise como as propriedades do HubSpot são sincronizadas com campos de aplicativos de terceiros e vice-versa abaixo: 

Propriedades do HubSpot Campos de aplicativos de terceiros
Texto Texto
Número Número
Seletor de data Seletor de data
Datetime Datetime
Seletor de data Datetime
Datetime Seletor de data
Caixa de seleção única Booleano
Seleção de botões de opção Seleção de botões de opção
Seleção de menu suspenso Lista de escolhas

Além disso, os seguintes campos no aplicativo de terceiros pode ser mapeado de uma maneira para qualquer Campo de texto HubSpot:

  • Número
  • Seletor de data
  • Datetime
  • Caixa de seleção única
  • Na maioria dos aplicativos, isso também se aplica aos campos do proprietário.

A seguir Tipos de propriedade do HubSpot pode ser mapeado de uma maneira como texto para o seu aplicativos de terceiros campos de texto (alguns deles podem ser mapeados bidirecionalmente para diferentes tipos de campos em seu aplicativo de terceiros)

  • Número
  • Seletor de data
  • Datetime
  • Caixa de seleção única
  • Várias caixas de seleção
  • Cálculo (número)
  • Pontuação (número)

Observe: nem todas as propriedades de seleção suspensa podem ser sincronizadas bidirecionalmente entre o HubSpot e seu aplicativo de terceiros. Neste caso, a propriedade de seleção suspensa só pode ser mapeada uma maneira como texto ao campo de texto do seu aplicativo de terceiros. 

Para alguns aplicativos de terceiros, a HubSpot não consegue modificar os campos pelos seguintes motivos:

  • Limitações de API do aplicativo de terceiros. 
  • Campos somente leitura no aplicativo de terceiros. 

Nesse caso, esses campos serão mapeados de uma maneira do HubSpot para seu aplicativo de terceiros. 

Revise os mapeamentos de campos de sincronização de dados padrão

Alguns tipos de propriedade têm regras e considerações adicionais. Revise os requisitos específicos para alguns mapeamentos de campo padrão abaixo.

Propriedades de nome

O HubSpot tem propriedades de contato separadas para Primeiro nomeSobrenome. Se o seu aplicativo de terceiros tiver apenas um propriedade de contato para o nome do contato, a sincronização de dados considerará o primeira palavra do nome completo como Primeiro nome no HubSpot, e tudo o que vier depois do primeiro espaço será sincronizado com o Sobrenome propriedade.

Aplicativo de terceiros HubSpot
Nome completo: John Jacob Jingleheimer Schmidt Primeiro Nome: João
Sobrenome: Jacob Jingleheimer Schmidt

Observe: mapeamentos de campo para ambos os Primeiro nomeSobrenome As propriedades devem estar ativadas para que o nome do contato seja sincronizado corretamente entre o HubSpot e seu aplicativo de terceiros. 

Propriedades do proprietário

Os proprietários de registros de objeto são sincronizados usando o Endereço de email propriedade. Se não houver endereço de e-mail, a HubSpot usará o Nome campo para esses proprietários. Os proprietários de registros devem ser configurados como usuários em ambos HubSpot e seu aplicativo de terceiros para que a sincronização de dados funcione. Se um usuário existir em um aplicativo e não em outro, os dados não serão sincronizados. 

Se você tiver um pagamento Centro de Operações assinatura, você pode mapear o Proprietário campo em seu aplicativo de terceiros para qualquer propriedade de usuário personalizada do HubSpot.

Propriedades de seleção suspensa

Quando uma sincronização é criada pela primeira vez entre o HubSpot e seu aplicativo de terceiros, o HubSpot sincronizará todos os valores e opções da propriedade suspensa no momento. O HubSpot não atualizará automaticamente as propriedades suspensas quando novas opções forem adicionadas. Para atualizar as propriedades suspensas, você deve salvar e iniciar a sincronização entre o HubSpot e seu aplicativo de terceiros novamente.

Quando uma sincronização é criada pela primeira vez entre o HubSpot e seu aplicativo de terceiros, o HubSpot sincronizará todos os valores e opções da propriedade de caixa de seleção múltipla/seleção suspensa no momento. O HubSpot não atualizará automaticamente as propriedades quando novas opções forem adicionadas. Para atualizar as propriedades do menu suspenso/várias caixas de seleção, você deve salvar e iniciar a sincronização entre o HubSpot e seu aplicativo de terceiros novamente.

Propriedades de endereço, país e região

O HubSpot estrutura o Endereço da Rua propriedade como uma propriedade de texto de linha única, e o País/Região propriedade como uma propriedade de seleção suspensa. Devido a discrepâncias na forma como outros aplicativos aceitam a formatação dessas propriedades, as propriedades de endereço podem ser sincronizadas como mapeamentos unidirecionais do aplicativo de terceiros para o HubSpot.

Mapeamentos de associação

Ativar mapeamentos de associação sincronizará todas as associações de registros do HubSpot com seu aplicativo de terceiros e vice-versa. Por exemplo, os contatos serão associados aos respectivos registros de empresa ou negócio. Para evitar que associações sejam feitas, desative o mapeamento de associação. Os mapeamentos de associação não podem ser editados ou excluídos. Saiba como configurar mapeamentos de associação com mais detalhes.

Nome

Alguns aplicativos armazenam vários valores para uma propriedade com rótulos diferentes. Por exemplo, um único Telefone propriedade terá vários rótulos para "Trabalho", "Casa" e "Celular". Por outro lado, o HubSpot tem as três propriedades de contato padrão a seguir: Número de telefone , Número de celular , e Número de fax

Se um registro for criado no HubSpot pelo aplicativo de terceiros, o número de telefone listado primeiro no aplicativo de terceiros será sincronizado com o Número de telefone propriedade no HubSpot. Quaisquer números de telefone adicionais não serão sincronizados, a menos que sejam rotulados como Móvel ou Fax. Nesse caso, eles serão sincronizados com o Número de celular e Número de fax propriedades respectivamente. 

Contanto que haja um número de telefone correspondente no HubSpot e no outro aplicativo, o número de telefone desse registro será considerado sincronizado entre o HubSpot e o aplicativo de terceiros. 

Se nenhum dos números de telefone corresponder, o HubSpot seguirá a lógica de configurações de conflito de sincronização. Se a sincronização estiver definida como padrão para HubSpot, o número de telefone será adicionado à lista de números de telefone no aplicativo de terceiros. Se o padrão de sincronização for o aplicativo de terceiros, o número de telefone no HubSpot será substituído pelo número listado primeiro em seu aplicativo de terceiros. 

Quando o HubSpot cria um novo registro em seu aplicativo de terceiros, o Trabalhar o rótulo será aplicado por padrão. 

Unidades de negócios

Se você tiver o Complemento de unidades de negócios , você pode configurar um mapeamento de campo bidirecional entre a propriedade Unidades de negócios no HubSpot e qualquer caixa de seleção múltipla ou campo de texto personalizado no aplicativo de terceiros. 

Estágios da negociação, status do ticket ou status do pedido

Para sincronizar as propriedades do estágio do negócio, do status do ticket ou do status do pedido, o campo correspondente no campo de terceiros deve corresponder ao Rótulo da propriedade HubSpot. Por exemplo, se o estágio do seu negócio no HubSpot for Fechado e ganho (pipeline de vendas) , o campo do seu aplicativo de terceiros deverá refletir o mesmo rótulo. 

Saiba mais sobre sincronização de dados.