- Central de conhecimento
- Conta e configuração
- Integrações
- Entenda seus mapeamentos de campos de sincronização de dados
Entenda seus mapeamentos de campos de sincronização de dados
Ultima atualização: 21 de Janeiro de 2026
Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:
Todos os aplicativos de sincronização de dados têm um conjunto de mapeamentos de campo que controlam como as propriedades no HubSpot sincronizam com os campos em um aplicativo de terceiros conectado. Esses mapeamentos determinam quais dados são sincronizados, em que direção e como os conflitos são tratados, ajudando a manter os registros consistentes entre o HubSpot e outros aplicativos.
Para exibir os mapeamentos padrão disponíveis para um aplicativo, consulte o marketplace página de listagem do aplicativo.
Se você tiver uma conta do Data Hub Starter, Professional ou Enterprise, poderá criar e personalizar mapeamentos de campo de sincronização de dados.
Revise os mapeamentos de campos de sincronização de dados padrão
Revise como os tipos de campo de propriedade do HubSpot são sincronizados com os tipos de campo de aplicativos de terceiros.
| Tipos de propriedade do HubSpot | Tipos de 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 tipos de campos de aplicativos de terceiros podem ser mapeados de forma unidirecional para qualquer campo de texto do 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.
Os seguintes tipos de propriedade do HubSpot podem ser mapeados de forma unidirecional como texto para os campos de texto do seu aplicativo de terceiros (alguns deles podem ser mapeados bidirecionalmente para diferentes tipos de campo no 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 que nem todas as propriedades selecionadas do menu suspenso podem ser sincronizadas de duas maneiras entre o HubSpot e seu aplicativo de terceiros. Nesse caso, a propriedade de seleção suspensa só pode ser mapeada de uma maneira como texto para o campo de texto do 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.
Revisar requisitos para mapeamentos de campo específicos
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 nome e Sobrenome. 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 |
Observação: os mapeamentos de campo para as propriedades Nome e Sobrenome devem estar ativados para que o nome do contato seja sincronizado corretamente entre o HubSpot e o 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, o HubSpot usará o campo Nome para esses proprietários. Registro proprietários devem estar configurados como usuários no HubSpot e no 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 uma conta do Data Hub , poderá mapear o campo Proprietário no aplicativo de terceiros a 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 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 ou quando o tipo de campo for alterado. 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. Isso garantirá que os valores mais atualizados no HubSpot e em seu aplicativo de terceiros sejam sincronizados.
Propriedades de endereço, país e região
O HubSpot estrutura a propriedade Endereço de Rua como uma propriedade de texto de linha única, e a propriedade País/Região 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 mais sobre como configurar mapeamentos de associações .
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.
Observação: campos com vários valores, como emails, telefones e endereços, em que o campo pode ter vários valores que podem ter rótulos para distingui-los, não podem ser mapeados para campos personalizados.
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 a sincronização assumir como padrão o aplicativo de terceiros, o número de telefone no HubSpot será substituído pelo número listado no seu aplicativo de terceiros.
Marcas
Se você tiver o complemento Marcas, poderá configurar um mapeamento de campo bidirecional entre a propriedade Marcas no HubSpot e qualquer campo personalizado de várias caixas de seleção ou campo de texto 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.