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) # O que a Nuvia sincroniza com o HubSpot e quando Mapa do que sai da Nuvia para o HubSpot, do que entra, o que dispara cada envio e em quanto tempo o dado aparece do outro lado. Disponível em Plataforma > Integrações > HubSpot Quem pode fazer Administrador Atualizado em 2 de outubro 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. O que vai e o que vem 2. Os dois gatilhos de sincronização 3. Em quanto tempo o dado chega 4. Não existe carga inicial ao conectar 5. A Nuvia não devolve ao HubSpot o que veio de lá 6. Regras que protegem o seu funil no HubSpot 7. Transcrição da conversa **Nesta página7 seções** 1. O que vai e o que vem 2. Os dois gatilhos de sincronização 3. Em quanto tempo o dado chega 4. Não existe carga inicial ao conectar 5. A Nuvia não devolve ao HubSpot o que veio de lá 6. Regras que protegem o seu funil no HubSpot 7. Transcrição da conversa Mapa completo do que sai da Nuvia para o HubSpot, do que entra do HubSpot para a Nuvia, o que dispara cada envio e em quanto tempo o dado aparece do outro lado. ## O que vai e o que vem ObjetoNuvia → HubSpotHubSpot → Nuvia **Contato** Cria ou vincula o contato e grava os campos mapeados Cria ou atualiza o contato na Nuvia com os campos mapeados **Deal (negócio)** Cria o deal e move a etapa conforme o mapeamento de funil Move a conversa vinculada, quando a etapa está marcada como bidirecional **Lead** Cria o lead e grava o rótulo da etapa Vincula o lead à conversa aberta e move a etapa, quando marcada como bidirecional **Empresa** Não é criada nem alterada pela Nuvia Enriquece o registro de empresa da Nuvia pelo domínio **Transcrição da conversa** Enviada como registro de comunicação ao contato e/ou ao deal, quando a conversa é finalizada ou automaticamente (cerca de 1h após a última mensagem) Não se aplica **Owner (responsável)** Gravado quando um atendente é atribuído manualmente na Nuvia Atualiza o atendente da conversa aberta, conforme o mapeamento de usuários Importante: a Nuvia nunca cria nem edita empresas no HubSpot. Os dados de empresa fluem apenas na direção HubSpot → Nuvia. Exclusões também não são propagadas em nenhum sentido: apagar um contato de um lado não apaga do outro. ## Os dois gatilhos de sincronização A Nuvia tem **dois mecanismos independentes**, configurados em abas diferentes, que não se substituem. **Por campoPor etapa do funilOnde configura** Aba **Campos** Aba **FunisO que dispara** Um campo mapeado muda no contato ou na conversa A conversa muda de etapa no funil **O que acontece** As propriedades mapeadas são gravadas no contato, no deal e no lead Contato, deal e lead são criados ou vinculados, e a etapa do deal é atualizada **Depende do outro?** Não Não Em outras palavras: mapear um campo **não** move etapa nenhuma, e mapear uma etapa **não** sincroniza campo nenhum. Se você quer as duas coisas, precisa configurar as duas abas. Exemplo prático: você quer que o campo Temperatura chegue ao HubSpot e que o deal avance para “Reunião agendada” quando a conversa chega nessa etapa. Mapeie Temperatura na aba Campos e crie a linha da etapa na aba Funis. Só a aba Funis não leva a temperatura; só a aba Campos não move o deal. ## Em quanto tempo o dado chega Não existe intervalo agendado nem sincronização de hora em hora. Tudo é disparado por evento, no momento em que acontece. - **HubSpot → Nuvia:** o HubSpot avisa a Nuvia assim que o registro muda. - **Nuvia → HubSpot:** o envio ocorre assim que a alteração é feita. Nota: se a falha for de validação (um valor que o HubSpot não aceita, por exemplo) as tentativas falham igual, porque o dado enviado é o mesmo. ## Não existe carga inicial ao conectar Conectar a conta **não** importa a base que já existe no HubSpot. A partir da conexão, a Nuvia passa a sincronizar apenas o que muda daqui para frente. Para trazer contatos que já estão no HubSpot, use a **importação de listas**: na integração, acesse **Listas**, busque a lista desejada e clique em **Importar membros**. O mesmo vale no sentido inverso: um contato antigo da Nuvia só é enviado ao HubSpot quando sofre alguma alteração ou quando a conversa dele avança para uma etapa mapeada. ## A Nuvia não devolve ao HubSpot o que veio de lá Quando uma mudança de etapa chega do HubSpot e move a conversa na Nuvia, a Nuvia **não** reenvia essa mesma mudança de volta. Isso evita o efeito de eco entre os dois sistemas. ## Regras que protegem o seu funil no HubSpot Ao mover um **deal**, a Nuvia verifica a situação atual dele antes de escrever: - **Deal já fechado** (ganho ou perdido) no HubSpot não é movido. - **Etapa anterior à atual** não é aplicada, o deal não anda para trás. Nos dois casos o deal permanece como está e o evento fica registrado no Histórico, sem erro. Essas travas valem **apenas para deals**. Etapas de **contato** (Lifecycle Stage e Lead Status) e de **lead** são gravadas direto, mesmo que representem um retrocesso. A verificação depende de a Nuvia conseguir ler o funil no HubSpot. Se a leitura falhar, ou se a etapa atual do deal não for encontrada no funil, a Nuvia grava assim mesmo, a trava não bloqueia por precaução. Importante se um deal parou de acompanhar a conversa, confira antes de tudo se ele não está fechado no HubSpot ou em uma etapa mais adiantada que a da conversa. Nesses casos o comportamento é intencional, não é falha. ## Transcrição da conversa Na aba **Avançado**, a chave **Enviar transcrição da conversa ao HubSpot** registra as conversas da Nuvia na timeline de atividades do HubSpot, como registro de comunicação. A chave vem desligada por padrão. Ao ligar, você escolhe **para onde** a transcrição vai e **quando**. **Para onde:** - **Contato:** a transcrição fica na timeline do contato. - **Negócio (deal):** a transcrição fica na timeline do deal vinculado à conversa. Se a conversa não tem deal vinculado, nada é enviado ao negócio. Você pode marcar os dois destinos ao mesmo tempo, e cada um tem a sua própria regra de envio. O último destino marcado não pode ser desmarcado: para parar de enviar, desligue a chave. **Quando (por destino):** - **Quando a conversa for finalizada:** a transcrição completa é enviada uma vez, ao finalizar a conversa. - **Automático:** a Nuvia envia a conversa em trechos, cerca de 1h depois da última mensagem, e pelo menos 1 vez ao dia se a conversa não parar. É útil quando as conversas demoram a ser finalizadas. Quando a conversa é finalizada, o envio do que ainda estava pendente é antecipado. Ao ligar a chave pela primeira vez, a Nuvia já marca **Contato** com **Quando a conversa for finalizada**, que é o comportamento de antes. Quem já usava a transcrição continua com esse mesmo comportamento. - Vale para conversas de **WhatsApp** e **LinkedIn**. Conversas de outros canais não geram envio. - Transcrições muito longas são divididas em partes sequenciais no HubSpot. - No modo **Automático**, quando um trecho atravessa mais de um dia, a primeira mensagem de cada dia aparece com data e hora (por exemplo, 30/09 09:21). Assim você não confunde mensagens de dias diferentes. ## Perguntas frequentes **Alterei um campo na Nuvia. Em quanto tempo aparece no HubSpot?** Em segundos. O envio entra na fila no momento da alteração, sem intervalo agendado. Se não apareceu, abra a aba **Histórico** e procure o evento: ele vai mostrar se o envio foi feito, se falhou e por quê. **Conectei a integração e nada foi sincronizado. Está quebrado?** Não. A conexão não faz carga inicial da base. Só passa a sincronizar o que muda a partir dali. Para trazer contatos que já existem no HubSpot, use **Listas > Importar membros**. **Preciso configurar as duas abas, Campos e Funis?** Depende do que você quer. A aba **Campos** cuida do conteúdo dos registros (propriedades). A aba **Funis** cuida da criação de contato, deal e lead e da movimentação de etapa. São independentes, configure a que atende o seu caso, ou as duas. **Mudei a etapa do deal na Nuvia e o HubSpot não mudou. Por quê?** As causas mais comuns são as travas de proteção: o deal está fechado no HubSpot, ou a etapa de destino é anterior à etapa em que o deal já está. A Nuvia não move o deal nesses casos. Confira também se existe uma linha de mapeamento para aquela etapa na aba **Funis**. **Posso escolher que um campo só entre, sem sair?** Não. O mapeamento de campos vale nos dois sentidos, não existe configuração de direção por campo. A exceção são as propriedades que o HubSpot marca como somente leitura. A direção configurável por linha existe apenas no mapeamento de etapas, na aba **Funis**. **Onde vejo se a sincronização aconteceu?** Na aba **Histórico**, dentro da integração. Os registros ficam disponíveis por **7 dias** e podem ser filtrados por tipo de evento, direção, status e objeto. [AnteriorComo sincronizar contatos e deals entre Nuvia e HubSpot](https://nuvia.ai/docs/artigos/14590403-como-sincronizar-contatos-e-deals-entre-nuvia-e-hubspot) [PróximoComo mapear campos entre a Nuvia e o HubSpot](https://nuvia.ai/docs/artigos/16474177-como-mapear-campos-entre-a-nuvia-e-o-hubspot) Este artigo ajudou? ## Artigos relacionados - [Como configurar integração com HubSpot](https://nuvia.ai/docs/artigos/14501908-como-configurar-integracao-com-hubspot) - [Glossário de termos da Nuvia](https://nuvia.ai/docs/artigos/14580494-glossario-de-termos-da-nuvia) - [Solução de problemas da integração com HubSpot](https://nuvia.ai/docs/artigos/16474434-solucao-de-problemas-da-integracao-com-hubspot) [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/16473526-o-que-a-nuvia-sincroniza-com-o-hubspot-e-quando