Como configurar integração com HubSpot

A integração com HubSpot sincroniza automaticamente contatos, empresas, deals (oportunidades) e pipelines entre a Nuvia e sua conta de HubSpot. Isso garante que seus dados permaneçam sempre atualizados em ambas as plataformas, eliminando a necessidade de sincronização manual e criando um ciclo de feedback contínuo entre inbound e outbound.

Disponível em: Plataforma > Integrações > HubSpot (rota: /integrations)

Quem pode fazer: Proprietário ou Administrador

Módulo: Plataforma

💡 Dica: Se você é Gestor ou Atendente, você não conseguirá conectar integrações. Solicite a um Proprietário ou Administrador que faça essa configuração.

Antes de começar, é importante entender os conceitos-chave da integração:

Ao configurar a integração, você pode escolher entre os seguintes códigos de país:

⚠️ Importante: A conexão requer permissões de propriedade ou administração na sua conta HubSpot. Se você não conseguir conectar, peça a um administrador HubSpot para fazer a autorização.

O mapeamento de campos determina quais informações serão sincronizadas entre Nuvia e HubSpot. Um campo da Nuvia é "mapeado" a uma propriedade do HubSpot.

A Nuvia já vem com mapeamentos pré-configurados para os campos mais comuns:

⚠️ VERIFICAR COM PRODUTO: Qual é a lista completa de mapeamentos pré-configurados? Existem campos customizados suportados?

💡 Dica: Se você adicionar um campo customizado na Nuvia, crie o campo correspondente no HubSpot antes de mapeá-lo. Caso contrário, o HubSpot não saberá onde armazenar o dado.

Se você adicionou propriedades novas no HubSpot após conectar a integração, você pode sincronizá-las:

O mapeamento de etapas (ou "deal stage mapping") alinha os estágios de vendas da Nuvia com os stages de deals do HubSpot. Isso garante que quando você move um lead através do seu funil na Nuvia, o deal correspondente no HubSpot seja automaticamente atualizado.

Exemplo:

⚠️ Importante: Se uma etapa Nuvia não tiver um mapeamento, o lead continuará a sincronizar, mas a etapa não será refletida no HubSpot.

💡 Dica: Antes de criar etapas customizadas, crie os stages correspondentes no HubSpot (em HubSpot, vá para Vendas > Deals > Estágios de Deal e adicione um novo stage).

O DDI padrão (Discagem Direta a Distância) é o código de país automaticamente atribuído a contatos que têm apenas o número de telefone, sem o indicativo.

💡 Dica: Se você trabalha com múltiplos países, escolha o que tem a maior quantidade de contatos como padrão. Você ainda conseguirá sincronizar números internacionais — eles manterão seus indicativos originais.

A integração sincroniza números de telefone bidirecionalmente:

⚠️ Importante: Se há conflito (número diferente em ambos os lados), a Nuvia priorizará o valor mais recente ou seguirá a regra definida em Configurações de Sincronização.

As regras de sincronização definem o comportamento automático da integração: qual direção os dados fluem, com que frequência, quais dados sincronizar e como lidar com conflitos.

⚠️ VERIFICAR COM PRODUTO: Qual é o padrão de frequência? É configurável por módulo (contatos vs. deals)?

💡 Dica: Para evitar conflitos, defina direções claras. Por exemplo:

Contatos: Bidirecional (criados em ambos os lados)

Deals: Nuvia → HubSpot (você gerencia o funil apenas na Nuvia)

Campanhas: Nuvia → HubSpot (rastreamento de envios)

O histórico de sincronização mostra um registro completo de todas as sincronizações, atualizações, erros e conflitos entre Nuvia e HubSpot.

Ao clicar em um erro, você verá:

Próximos passos:

💡 Dica: Erros frequentes geralmente indicam problemas com mapeamento. Revise a aba Mapeamento de Campos e Sincronizar Propriedades para garantir que tudo está atualizado.

Se você precisar desconectar sua conta HubSpot da Nuvia, o processo é simples — mas importante entender as consequências.

⚠️ Importante: Desconectar não deleta dados. Apenas para a sincronização futura. Se precisar retomar a integração, os dados existentes continuarão visíveis em ambas as plataformas.

R: Por padrão, a sincronização ocorre a cada [⚠️ VERIFICAR COM PRODUTO: qual é o intervalo padrão?]. Você consegue configurar a frequência em Configurações de Sincronização (desde que não comprometa performance). Para casos críticos, você pode forçar uma sincronização manual clicando em "Sincronizar Agora" na aba de Configurações.

R: ⚠️ VERIFICAR COM PRODUTO: Isso depende da configuração. Geralmente, não — a Nuvia respeita dados existentes no HubSpot por segurança. Recomendamos inativar em vez de deletar. Verifique a documentação HubSpot ou solicite clareza ao time de Suporte Nuvia sobre o comportamento de delete.

R: Sim. Na aba Mapeamento de Campos, você escolhe exatamente quais campos deseja sincronizar. Campos não mapeados não serão sincronizados.

R: ⚠️ VERIFICAR COM PRODUTO: Atualmente, a Nuvia suporta uma integração HubSpot por workspace. Se você precisa de múltiplas contas HubSpot, considere criar múltiplos workspaces Nuvia. Consulte seu Proprietário ou o time de CS.

R: Bidirecional significa que mudanças em ambos os lados (Nuvia e HubSpot) são sincronizadas. Unidirecional significa que apenas um lado envia dados. Exemplo: Se "E-mail" é bidirecional, alterar o e-mail no HubSpot atualiza na Nuvia. Se for unidirecional (Nuvia → HubSpot), apenas mudanças na Nuvia refletem no HubSpot.

R: ⚠️ VERIFICAR COM PRODUTO: Sim/Não? A Nuvia sincroniza automaticamente o envio de campanhas e respostas para o HubSpot para tracking de atribuição? Solicite detalhes ao time de Produto.

R: Não. A integração HubSpot da Nuvia é gerenciada integralmente pela plataforma. Você não precisa configurar webhooks ou APIs — tudo é automático após conectar a conta.

R: ⚠️ VERIFICAR COM PRODUTO: Qual é a política aqui? Suporta múltiplas integrações de CRM simultâneas? Isso pode gerar conflitos de sincronização.

R: Consulte regularmente o Histórico de Sincronização para verificar se há erros. Use os mapeamentos claros para evitar conflitos. Se necessário, force uma sincronização manual com o botão "Sincronizar Agora" (se disponível).

R: ⚠️ VERIFICAR COM PRODUTO: Existe opção de exportar logs de sincronização em CSV ou PDF para conformidade com LGPD/compliance?

R: Depende da frequência de sincronização configurada e do volume. Para [⚠️ VERIFICAR COM PRODUTO: número de contatos], o sistema geralmente sincroniza em [estimativa de tempo]. Se você tem uma importação massiva, pode levar mais tempo.