Entenda seus mapeamentos de campos de sincronização de dados
Ultima atualização: Fevereiro 7, 2025
Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:
|
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ê tiver uma conta do Operations hub Starter, Professional ou Enterprise , poderá 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 podem ser mapeados 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.
Os seguintes tipos de propriedades HubSpot podem ser mapeados de uma maneira como texto para os campos de texto do seu aplicativo de terceiros (alguns deles podem ser mapeados de duas maneiras para diferentes tipos de campo no 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. 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.
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 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 |
Observe: mapeamentos de campo para as propriedades Nome e Sobrenome devem ser sincronizados 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, o HubSpot usará o campo Nome 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 uma conta de Operations hub , poderá mapear o campoProprietário∙ em seu aplicativo de terceiros para qualquer propriedade de usuário HubSpot personalizada.
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.
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.
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 Business Units, poderá configurar um mapeamento de campo bidirecional entre a propriedade Business Units no HubSpot e qualquer caixa de seleção múltipla personalizada 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.