Como mapear campos entre a Nuvia e o HubSpot

O mapeamento de campos define quais informações viajam entre os dois sistemas. Nada é sincronizado por padrão, cada par de campo é criado manualmente por você.

Módulo: Plataforma

---

Criar um mapeamento

1. Em Plataforma > Integrações > HubSpot, localize a conta e clique em Configurar

2. Abra a aba Campos

3. Clique em Adicionar mapeamento

4. Em Campo do HubSpot, escolha a propriedade de destino — use Buscar campo… para filtrar pelo nome

5. Em Campo Inteligente, escolha o campo correspondente da Nuvia

6. Clique em Salvar mapeamentos

Como os campos são organizados na tela

A lista é dividida em dois lados, cada um com sua própria organização.

Para encontrar uma propriedade específica em contas com muitos campos, use a busca Buscar campo… dentro do seletor. Ela filtra pelo nome enquanto você digita.

Etiquetas que aparecem nas linhas

• Sync bidirecional (Contato, Deal e Lead) → o mapeamento vale nos dois sentidos. Não existe configuração de direção por campo (a escolha de direção existe apenas na aba Funis, por etapa)

• Somente leitura → a propriedade é calculada pelo HubSpot e não aceita escrita pela API

Listas suspensas e múltipla escolha

Quando o campo da Nuvia é de seleção ou múltipla escolha, a Nuvia envia ao HubSpot o texto da opção, exatamente como está cadastrado no campo da Nuvia. O HubSpot só aceita esse valor se ele for idêntico a uma das opções da propriedade, incluindo maiúsculas, minúsculas, acentos e espaços.

A falha fica registrada na aba Histórico, com status Falha ou Parcial e a mensagem: “O valor enviado não é uma das opções aceitas pela propriedade X no HubSpot. Revise o vínculo desse campo na integração.” Como o histórico é mantido por 7 dias, vale conferi-lo com regularidade depois de mexer em campos de seleção.

Como evitar

• Copie e cole o texto das opções direto do HubSpot ao cadastrar as opções do campo na Nuvia, não digite de novo

• Padronize antes de mapear: se o HubSpot tem Quente, Morno, Frio, o campo da Nuvia precisa ter exatamente esses três textos

• Depois de criar o mapeamento, altere um contato de teste e confira o resultado no Histórico

Múltipla escolha

Valores de múltipla escolha viajam separados por ponto e vírgula (;), que é o separador usado pelo HubSpot. Por isso, se qualquer opção selecionada tiver ; no texto, o campo inteiro deixa de ser enviado, o ponto e vírgula quebraria o valor do outro lado. O restante dos campos daquele registro segue normalmente.

Evite usar ; no texto das opções dos campos de seleção da Nuvia.

No sentido inverso

Quando um valor de lista suspensa chega do HubSpot, ele é gravado na Nuvia com o código interno da opção, não com o rótulo que você vê no HubSpot. No painel do Histórico o rótulo é exibido normalmente, a diferença aparece no valor armazenado no contato.

Atualizar a lista de propriedades

Quando alguém cria, renomeia ou apaga uma propriedade no HubSpot:

1. Abra a aba Avançado

2. Em Atualizar campos, clique em Sincronizar campos

A Nuvia busca as propriedades mais recentes do HubSpot, disponibiliza as novas para mapeamento e remove os mapeamentos de propriedades que não existem mais.