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

Nesta página7 seções

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

Os dois gatilhos de sincronização

A Nuvia tem dois mecanismos independentes, configurados em abas diferentes, que não se substituem.

Por campo

Por etapa do funil
Onde configura Aba Campos Aba Funis
O 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.

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.

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.

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.

Este artigo ajudou?