Central de conhecimento HubSpot

Compreender os seus mapeamentos de campo de sincronização de dados

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

Todas as aplicações de sincronização de dados têm um conjunto de mapeamentos de campo que mantêm os dados em sincronia entre o HubSpot e a sua aplicação de terceiros. Para ver que mapeamentos por defeito estão disponíveis para uma aplicação, consultar a página de listagem de mercadoda aplicação.

Se tiver uma subscrição paga do Centro de Operações, pode criar e personalizar mapeamentos de campo de sincronização de dados

Rever como as propriedades do HubSpot se sincronizam com os campos de aplicação 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 selecção

Além disso, os seguintes campos na aplicação de terceiros podem ser mapeados de uma forma para qualquer campo de texto do HubSpot:

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

Os seguintes tipos de propriedade HubSpot podem ser mapeados de uma forma como texto para os campos de texto dasua aplicação 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)

Observação: nem todas as propriedades de seleção suspensa podem ser sincronizadas de duas maneiras entre o HubSpot e seu aplicativo de terceiros. Neste caso, a propriedade de selecção do menu pendente só pode ser mapeada de uma forma como texto para o campo de texto da sua aplicação de terceiros.

Para algumas aplicações de terceiros, o HubSpot é incapaz de modificar os campos pelas seguintes razões

  • Limitações de API da aplicação de terceiros. 
  • Campos só de leitura na aplicação de terceiros. 

Neste caso, estes campos irão mapear um caminho desde HubSpot até à sua aplicação de terceiros. 

Rever mapeamentos de campos de sincronização de dados padrão

Alguns tipos de propriedade têm regras e considerações adicionais. Rever abaixo os requisitos específicos para alguns mapeamentos de campo por defeito.

Propriedades do nome

HubSpot tem propriedades de contacto separadas para o Primeiro Nome e Apelido. Se a sua aplicação de terceiros tiver apenas uma propriedade de contacto para o nome do contacto, a sincronização de dados considerará a primeira palavra do nome completo como o Primeiro Nome no HubSpot, e tudo o que vier depois do primeiro espaço será sincronizado com a propriedade do Último Nome.

Aplicação de terceiros HubSpot
Nome completo: John Jacob Jingleheimer Schmidt Nome próprio: John
Sobrenome: Jacob Jingleheimer Schmidt

Observação: os mapeamentos de campo para as propriedades First NameLast Name devem estar ativados 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 registos de objectos são sincronizados utilizando o endereço de correio electrónico propriedade. Se não houver endereço de correio electrónico, HubSpot utilizará o campo Nome para estes proprietários. Os proprietários de registos devem ser estabelecidos como utilizadores tanto no HubSpot como na sua aplicação de terceiros para que a sincronização de dados funcione. Se um utilizador existir numa aplicação e não na outra, os dados não serão sincronizados. 

Se tiver um Centro de Operações assinatura, pode mapear o campo Proprietário na sua aplicação de terceiros para qualquer propriedade personalizada do utilizador do HubSpot.

Propriedades de selecção do menu pendente

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 do menu suspenso quando novas opções forem adicionadas. Para atualizar as propriedades do menu suspenso, você deve salvar e iniciar a sincronização entre o HubSpot e seu aplicativo de terceiros novamente.

Endereço, País, e Propriedades da Região

HubSpot estrutura a propriedade Street Address como uma propriedade de texto de linha única, e a propriedade Country/Region como uma propriedade de selecção dropdown. Devido a discrepâncias na forma como outras aplicações aceitam a formatação destas propriedades, as propriedades de endereçamento podem sincronizar-se como mapeamentos unidireccionais da aplicação de terceiros para o HubSpot.

Mapeamentos de associação

Ao ligar os mapeamentos de associações sincronizará quaisquer associações de registos do HubSpot para a sua aplicação de terceiros, e vice-versa. Por exemplo, os contactos serão associados aos respectivos registos da sua empresa ou de negócios. Para evitar que se façam associações, desligue o mapeamento da associação. 

Nota: mapeamentos de associação não podem ser editados ou eliminados. 


Nome

Algumas aplicações armazenam múltiplos valores para uma propriedade sob diferentes etiquetas. Por exemplo, uma única propriedade telefónica terá múltiplas etiquetas para "Work", "Home", e "Mobile". Em contraste, o HubSpot tem as seguintes três propriedades de contacto por defeito: Número de telefone, número de telemóvel, e número de fax

Se for criado um registo no HubSpot pela aplicação de terceiros, o número de telefone que for listado primeiro na aplicação de terceiros será sincronizado com a propriedade Número de Telefone no HubSpot. Quaisquer números de telefone adicionais não serão sincronizados, a menos que sejam rotulados como Telemóvel ou Fax. Nesse caso, sincronizar-se-ão com as propriedades do Número de Telemóvel e do Número de Fax, respectivamente. 

Enquanto houver um número de telefone correspondente no HubSpot e na outra aplicação, o número de telefone para esse registo é considerado em sincronia entre o HubSpot e a aplicação de terceiros. 

Se nenhum dos números de telefone corresponder, o HubSpot seguirá a lógica de configuração de conflitos da sincronização. Se a sincronização for definida por defeito para HubSpot, o número de telefone será adicionado à lista de números de telefone na aplicação de terceiros. Se a sincronização for por defeito para a aplicação de terceiros, o número de telefone no HubSpot será substituído pelo número listado primeiro na sua aplicação de terceiros. 

Quando o HubSpot cria um novo registo na sua aplicação de terceiros, a etiqueta Work será aplicada por defeito. 

Saiba mais sobre a sincronização de dados.