1. [Ajuda](https://nuvia.ai/docs) 2. [Integrações](https://nuvia.ai/docs/colecoes/19378002-integracoes) 3. [Hubspot](https://nuvia.ai/docs/colecoes/19431232-hubspot) # Como mapear campos entre a Nuvia e o HubSpot Como criar mapeamentos de campo, organizar a lista em bases grandes e evitar a falha silenciosa de listas suspensas e múltipla escolha. Disponível em Plataforma > Integrações > HubSpot > Campos Quem pode fazer Administrador Módulo: Plataforma Atualizado em 9 de setembro de 2026 [Hubspot](https://nuvia.ai/docs/colecoes/19431232-hubspot) 1. [Como configurar integração com HubSpot](https://nuvia.ai/docs/artigos/14501908-como-configurar-integracao-com-hubspot) 2. [Como sincronizar contatos e deals entre Nuvia e HubSpot](https://nuvia.ai/docs/artigos/14590403-como-sincronizar-contatos-e-deals-entre-nuvia-e-hubspot) 3. [O que a Nuvia sincroniza com o HubSpot e quando](https://nuvia.ai/docs/artigos/16473526-o-que-a-nuvia-sincroniza-com-o-hubspot-e-quando) 4. [Como mapear campos entre a Nuvia e o HubSpot](https://nuvia.ai/docs/artigos/16474177-como-mapear-campos-entre-a-nuvia-e-o-hubspot) 5. [Solução de problemas da integração com HubSpot](https://nuvia.ai/docs/artigos/16474434-solucao-de-problemas-da-integracao-com-hubspot) 6. [Como disparar templates WhatsApp na Nuvia direto de um workflow do HubSpot](https://nuvia.ai/docs/artigos/15879535-como-disparar-templates-whatsapp-na-nuvia-direto-de-um-workflow-do-hubspot) 7. [Como inscrever leads/contatos em campanhas da Nuvia direto de um workflow do Hubspot](https://nuvia.ai/docs/artigos/15879734-como-inscrever-leads-contatos-em-campanhas-da-nuvia-direto-de-um-workflow-do-hubspot) Nesta página 1. Criar um mapeamento 2. Como os campos são organizados na tela 3. Etiquetas que aparecem nas linhas 4. Listas suspensas e múltipla escolha 5. Atualizar a lista de propriedades **Nesta página5 seções** 1. Criar um mapeamento 2. Como os campos são organizados na tela 3. Etiquetas que aparecem nas linhas 4. Listas suspensas e múltipla escolha 5. Atualizar a lista de propriedades 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** Nota propriedades customizadas do HubSpot são totalmente suportadas. Qualquer propriedade de **Contato**, **Deal** ou **Lead** pode ser mapeada. Propriedades de **empresa** não entram no mapeamento, porque a Nuvia não escreve empresas no HubSpot. ## Como os campos são organizados na tela A lista é dividida em dois lados, cada um com sua própria organização. LadoComo está organizado **Campo do HubSpot** Agrupado por objeto: **Contato**, **Deal** e **Lead**. Propriedades de uso mais comum aparecem primeiro; o restante segue em ordem alfabética **Campo Inteligente** (Nuvia) Agrupado por contexto: **Contato**, **Conversa**, **Qualificação** e **Empresa** 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. Nota não existe limite de quantidade de mapeamentos, você pode manter dezenas de linhas sem impacto na sincronização. Não é possível, hoje, criar seus próprios agrupamentos ou subcampos para organizar a lista: os grupos são fixos (por objeto no lado HubSpot, por contexto no lado Nuvia). Em bases grandes, a busca é o caminho mais rápido. ## 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 Importante é possível salvar um mapeamento para uma propriedade **somente leitura**, mas o envio vai falhar toda vez. O erro aparece no **Histórico** com a mensagem de que a propriedade não aceita escrita. Remova esse mapeamento em vez de deixá-lo ativo. ## 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. Opção na NuviaOpção no HubSpotResultado Quente Quente Sincroniza quente Quente **Rejeitado**, a diferença de maiúscula invalida o valor Qualificado Qualificado com espaço no fim **Rejeitado** Sem interesse Sem Interesse **Rejeitado** Crítico quando um valor de seleção é recusado, o HubSpot **reprova o registro inteiro** e não apenas aquele campo. Todos os demais campos daquele contato (ou daquele deal, ou daquele lead) naquele envio deixam de ser gravados. 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**. Dica rode **Sincronizar campos** sempre que a operação do HubSpot mexer na estrutura de propriedades. É a forma mais rápida de eliminar mapeamentos órfãos, que falham silenciosamente a cada envio. ## Perguntas frequentes **Os campos pararam de ir para o HubSpot e não apareceu erro nenhum. O que houve?** Na maioria dos casos é um campo de seleção com valor fora do padrão. O HubSpot recusa o registro inteiro quando uma opção não bate exatamente com as opções da propriedade, inclusive por diferença de maiúscula ou acento. Abra a aba **Histórico**, filtre por **Falha** e confira a mensagem do evento. **Tenho mais de 40 campos mapeados. Dá para agrupar em subcategorias?** Hoje não. Os grupos são fixos: por objeto (Contato, Deal, Lead) do lado HubSpot e por contexto (Contato, Conversa, Qualificação, Empresa) do lado Nuvia. Não há limite de quantidade de mapeamentos, e a busca **Buscar campo…** dentro do seletor é o caminho mais rápido para localizar uma propriedade específica. **Posso mapear um campo só para receber dados, sem enviar?** Não. Não existe configuração de direção por campo, o mapeamento vale nos dois sentidos. A exceção são as propriedades que o HubSpot marca como **Somente leitura**, que só podem ser lidas. A escolha de direção existe apenas no mapeamento de etapas, na aba **Funis**. **Criei uma propriedade nova no HubSpot e ela não aparece na lista.** Vá em **Avançado > Atualizar campos** e clique em **Sincronizar campos**. A Nuvia recarrega a lista de propriedades do HubSpot na hora. **O que acontece se eu apagar uma propriedade no HubSpot que estava mapeada?** Os envios para aquela propriedade passam a falhar. Ao rodar **Sincronizar campos**, a Nuvia remove automaticamente o mapeamento órfão. [AnteriorO que a Nuvia sincroniza com o HubSpot e quando](https://nuvia.ai/docs/artigos/16473526-o-que-a-nuvia-sincroniza-com-o-hubspot-e-quando) [PróximoSolução de problemas da integração com HubSpot](https://nuvia.ai/docs/artigos/16474434-solucao-de-problemas-da-integracao-com-hubspot) Este artigo ajudou? ## Artigos relacionados - [Como configurar integração com HubSpot](https://nuvia.ai/docs/artigos/14501908-como-configurar-integracao-com-hubspot) - [Como sincronizar contatos e deals entre Nuvia e HubSpot](https://nuvia.ai/docs/artigos/14590403-como-sincronizar-contatos-e-deals-entre-nuvia-e-hubspot) - [Como criar e editar Funis Inteligentes pelo MCP (Agent Builder)](https://nuvia.ai/docs/artigos/16074655-como-criar-e-editar-funis-inteligentes-pelo-mcp-agent-builder) [Hubspot](https://nuvia.ai/docs/colecoes/19431232-hubspot) 1. [Como configurar integração com HubSpot](https://nuvia.ai/docs/artigos/14501908-como-configurar-integracao-com-hubspot) 2. [Como sincronizar contatos e deals entre Nuvia e HubSpot](https://nuvia.ai/docs/artigos/14590403-como-sincronizar-contatos-e-deals-entre-nuvia-e-hubspot) 3. [O que a Nuvia sincroniza com o HubSpot e quando](https://nuvia.ai/docs/artigos/16473526-o-que-a-nuvia-sincroniza-com-o-hubspot-e-quando) 4. [Como mapear campos entre a Nuvia e o HubSpot](https://nuvia.ai/docs/artigos/16474177-como-mapear-campos-entre-a-nuvia-e-o-hubspot) 5. [Solução de problemas da integração com HubSpot](https://nuvia.ai/docs/artigos/16474434-solucao-de-problemas-da-integracao-com-hubspot) 6. [Como disparar templates WhatsApp na Nuvia direto de um workflow do HubSpot](https://nuvia.ai/docs/artigos/15879535-como-disparar-templates-whatsapp-na-nuvia-direto-de-um-workflow-do-hubspot) 7. [Como inscrever leads/contatos em campanhas da Nuvia direto de um workflow do Hubspot](https://nuvia.ai/docs/artigos/15879734-como-inscrever-leads-contatos-em-campanhas-da-nuvia-direto-de-um-workflow-do-hubspot) ## Ainda precisa de ajuda? Clientes falam com o suporte pelo chat dentro da plataforma. Ainda não é cliente? Fale com o nosso time. [Falar com o suporte na plataforma](https://app.nuvia.ai) [Ainda não sou cliente](https://nuvia.ai/contact) --- Source: https://nuvia.ai/docs/artigos/16474177-como-mapear-campos-entre-a-nuvia-e-o-hubspot