Central de conhecimento HubSpot

Conectar e usar a sincronização de dados do HubSpot

Written by HubSpot Support | 18/mar/2021 16:05:47

Com asincronização de dados do HubSpot, você pode criar uma sincronização unidirecional ou bidirecional entre o HubSpot e seus outros aplicativos para unir todos os dados do cliente em uma única plataforma. Analise quais aplicativos usam a sincronização de dados aqui

Abaixo, saiba como a sincronização de dados funciona e como conectar um aplicativo, ativar a sincronização de dados, ressincronizar registros e muito mais.

Como funciona a sincronização de dados

Quando uma sincronização é ativada, a sincronização de dados cria um índice interno de todos os registros em um objeto. Em seguida, ele usa esse índice para comparar e monitorar as alterações de registro para ver como seu estado (sincronização, falha ou exclusão) deve ser alterado à medida que as propriedades do registro são atualizadas. Isso significa que o índice de sincronização de dados internos compara continuamente seu banco de dados (HubSpot ou o aplicativo conectado) e pode recuperar qualquer Chamada de api ou ponto de extremidade descartado ou com erro.

Quando um registro é atualizado, o mecanismo de sincronização examina todo o registro em relação à cópia que ele possui e atualiza sua cópia para corresponder ao registro real. Isso permite recuperar atualizações perdidas ou com falha. A sincronização de dados pode levar algum tempo para indexar todos os registros quando iniciada, mas garantirá uma experiência de sincronização mais suave e saudável. 

Princípios de sincronização

Uma sincronização de dados sempre será entre dois aplicativos, um sendo HubSpot. Cada sincronização tem duas fases principais, independentemente da sincronização de objetos:

  • A sincronização inicial: começa quando uma sincronização é ativada ou salva. Todos os registros existentes em ambos os aplicativos são passados pelo mecanismo de sincronização para indexá-los e, se aplicável, sincronizá-los.
  • A sincronização incremental: quando todos os registros são indexados, eles são verificados em busca de atualizações e novos registros. Os registros indexados que foram alterados desde a última vez em que foram verificados passam pelo mecanismo de sincronização.

Sincronização inicial

Para uma sincronização bidirecional, a sincronização inicial consiste em:

  • Index HubSpot: os registros de HubSpot são verificados e a ID do registro e seus identificadores correspondentes são armazenados (por padrão, este é o email para contatos e nome e/ou domínio para empresas). O índice é mantido atualizado durante todo o processo de sincronização. Leia mais sobre como a correspondência funciona
  • Indexe o outro aplicativo e sincronize: os registros do outro aplicativo são verificados e sincronizados. Para cada recurso obtido, é feita uma verificação para ver se há algum identificador correspondente (por exemplo, endereço de e-mail para contatos) na tabela de índice do HubSpot. Se houver, os registros serão correspondidos e ambos serão passados pelo mecanismo de sincronização juntos. Se não houver uma correspondência, o registro passará pelo mecanismo de sincronização sozinho. Quando o mecanismo de sincronização corresponde a registros, ele combina todas as informações que possui (os valores de campo dos registros, os filtros, mapeamentos de campo, histórico de sincronização etc.) e, com base nisso, ele constrói a próxima ação (solicitar alterações nos recursos, não fazer nada, registrar um erro etc.)

Observe: o primeiro registro retornado pela API do aplicativo será sincronizado, o próximo será considerado uma duplicata.

  • Sincronizar HubSpot: os registros de HubSpot são verificados novamente para verificar se precisam ser sincronizados. Esta etapa resultará na sincronização de registros existentes no HubSpot, não no outro aplicativo.

Observação:

  • As sincronizações iniciais de bancos de dados grandes podem levar algum tempo. Isso pode variar entre os aplicativos devido à velocidade da API do aplicativo conectado. A sincronização com milhões de registros pode levar vários dias para ser concluída.
  • Salvar a sincronização reiniciará a sincronização inicial.
  • O HubSpot enviará um e-mail quando a sincronização inicial for concluída.

Sincronização incremental

A sincronização incremental verifica constantemente as atualizações no HubSpot e no outro aplicativo (com base na direção da sincronização) e espera ser acionada. O HubSpot verifica se há alterações a cada cinco minutos. O outro aplicativo, ou sua API, usa webhooks para alertar sobre quaisquer alterações.

Conectar um aplicativo

Antes de começar

Conectando o aplicativo

Existem duas formas de pesquisar e conectar um aplicativo. Você pode fazer isso no Marketplace de aplicativos ou através da página de importações. 

  • Na barra de pesquisa, insira o nome do aplicativo e clique no resultado da pesquisa
  • No canto superior direito, clique em Instalar aplicativo.
  • Na caixa de diálogo, clique em Próximo e faça login na sua conta do aplicativo.
  • Analise as permissões de acesso solicitadas e clique em Permitir. Você será redirecionado para a página do aplicativo em suas configurações do HubSpot.

Se estiver configurando uma sincronização a partir da página de importações:

  • Clique em Importar no canto superior direito de qualquer página inicial do objeto, ou acesse suas configurações de importação:
    • No menu da barra lateral esquerda, acesse Importar e exportar.
    • Clique em Ir para importação.
  • Clique em Configurar uma sincronização

  • No painel à direita, digite o nome do aplicativo e clique no resultado da pesquisa
  • Clique em Instalar aplicativo
  • Você será redirecionado para a página de listagem do aplicativo para continuar com as etapas de conexão. 

É possível conectar mais de uma instância do mesmo aplicativo de terceiros ao HubSpot. Por exemplo, se você estiver gerenciando duas contas do Microsoft Dynamics, poderá conectar e sincronizar dados de ambas as contas com um portal do HubSpot. Para conectar uma conta adicional:

  • Clique no nome do aplicativo
  • Clique em Ações > Gerenciar contas
  • No painel direito, clique em Conectar outra conta
  • Continue com as etapas para conectar o aplicativo ao HubSpot. 

Ativar a sincronização de dados

Depois de conectar o aplicativo, é necessário definir suas configurações e ativar a sincronização para começar a sincronizar os dados entre as duas integrações. 

  • Clique no aplicativo.
  • Clique em Configurar sincronização.
  • Na página Selecionar os dados que você deseja sincronizar , selecione o objeto para sincronização ou de sincronização no aplicativo e o objeto que você deseja sincronizar no HubSpot.
  • Clique no menu suspenso de setas e selecione se a sincronização é bidirecional ou unidirecional entre o aplicativo e o HubSpot, ou vice-versa. 

Saiba mais sobre como sincronizar contatos e leads para outros aplicativos.

Defina as configurações de sincronização

Na tela Configurar, escolha a direção da sincronização e mapeie os campos do aplicativo de terceiros às propriedades do HubSpot. 

Na seção Escolha a direção de sincronização, decida como quer que os dados sejam sincronizados do HubSpot para o aplicativo de terceiros, e vice-versa. Há três opções: 

  • Sincronizações de dados entre aplicativos: todas as informações novas e atualizadas dos objetos serão sincronizadas entre os dois aplicativos. As propriedades serão mescladas para registros que já existem em ambas as plataformas. 
  • Os dados são sincronizados apenas para o HubSpot a partir do aplicativo de terceiros.
  • Os dados são sincronizados apenas para o aplicativo de terceiros a partir do HubSpot.

Na seção Resolver conflitos de dados, clique no menu suspenso e selecione o aplicativo padrão que substituirá o outro quando houver discrepâncias de dados. Se não houver valor de campo no aplicativo padrão, nenhum dado será alterado no aplicativo de terceiros. Esta configuração não anula a direção de sincronização selecionada na seção Escolha a direção de sincronização.

Revise seus mapeamentos de campo

Na seção Mapeie seus campos, revise os mapeamentos de propriedades padrão e como as informações são sincronizadas entre o HubSpot e o aplicativo de terceiros. Se você tiver uma assinatura de Operations hub> paga, poderá configurar mapeamentos personalizados para propriedades. Se você não tiver uma assinatura de Operations hub paga, clique em Experimentar mapeamentos personalizados para testar a função. 

Os campos obrigatórios serão exibidos na tabela de mapeamentos de campos com um asterisco (*). 

Para desativar um mapeamento, clique para desativar a alternância de mapeamento

Para configurar um mapeamento de campo personalizado:

  • Clique em Adicionar um mapeamento
  • Use os menus suspensos para selecionar o aplicativo de terceiros e a propriedade do HubSpot que deseja mapear.
  • Clique em success Atualizar.
  • Para desativar os mapeamentos personalizados, clique para desativar o botão

Saiba mais sobre regras e considerações específicas para mapeamentos de campos de sincronização de dados

Configurar regras de sincronização

Na tela Limite, configure como pretende sincronizar os registros do HubSpot para o aplicativo de terceiros, e vice-versa.

Por padrão, a HubSpot sincronizará apenas contatos que têm um endereço de e-mail válido. Para sincronizar também contatos sem um endereço de e-mail, no Reduza a chance de duplicatas seção, limpe o Sincronizar apenas contatos com um endereço de e-mail caixa de seleção.

Saiba mais sobre registros correspondentes.

Observação: quando um aplicativo tiver um campo de nome de empresa e de domínio da empresa, o HubSpot corresponderá dois registros se eles tiverem o mesmo nome de empresa, mas um domínio diferente, e vice-versa.

Na seção Limitar quais registros devem ser sincronizados, escolha critérios para limitar os registros que serão sincronizados do HubSpot para o aplicativo de terceiros, e vice-versa:

  • Clique em Editar.
  • No painel direito, selecione a propriedade para limitar a sincronização de registros do HubSpot com o aplicativo de terceiros, e vice-versa.
  • Clique em Concluído

Observação: a seção Limitar quais registros devem ser sincronizados limita apenas os registros inicialmente sincronizados entre o HubSpot e o aplicativo de terceiros. Depois que os registros forem sincronizados, eles continuarão a sincronizar dados com base na configuração do mapeamento de propriedades.


Associar registros

O HubSpot tenta manter as mesmas associações entre os registros (por exemplo, empresas associadas a contatos ou negócios associados a empresas) ao sincronizar com o aplicativo original que você conectou, sempre que possível. Saiba mais sobre mapeamento de associação com sincronização de dados.

Observação: na maioria dos casos, a sincronização de dados só pode associar faturas automaticamente a contatos. As faturas devem ser associadas manualmente aos registros da empresa no HubSpot. 

Revisar as regras e iniciar a sincronização

Na tela Revisão, revise as regras que você configurou e clique em Salvar e sincronizar. A sincronização inicial começará a ser processada.

Após a sincronização inicial ser concluída, os registros serão sincronizados dentro de 10 minutos após uma alteração. 

Sincronizar novamente os registros excluídos

Se você excluiu registros no HubSpot ou no aplicativo de terceiros, poderá sincronizá-los novamente para os recriar em qualquer um dos aplicativos:

  • Clique no aplicativo.
  • Na guia Exibição de objeto, na coluna Falha, clique no número de registros com falha de sincronização. 
  • No painel direito, clique em Ações.
  • Selecione Sincronizar novamente registros excluídos no HubSpot ou Sincronizar novamente registros excluídos em [aplicativo de terceiros].
  • Clique em Sincronizar novamente tudo

Você também pode:

  • Na guia Exibição de registro clique em Mais Restaurar todos os registros excluídos
  • No painel lateral, clique no menu suspenso Tipo de registro e selecione o tipo de registro e clique no menu suspenso Aplicativo de destino para selecionar em qual aplicativo recriar os contatos. 
  • Clique em Revisar antes de restaurar
  • Revise todos os registros que serão restaurados e clique em Restaurar todos os [número]

Desativar a sincronização de dados

Você pode desativar a sincronização de dados para evitar que os registros do aplicativo sejam sincronizados com o HubSpot e vice-versa. 
  • Clique no aplicativo.
  • Clique no menu suspenso Ações e selecione Desativar sincronização.

  • Na caixa pop-up, clique em Desativar sincronização.

Depois que a sincronização for desativada, você poderá ativá-la novamente clicando em Editar configurações de sincronização ou excluir a sincronização. 

Revise suas integridades da sincronização

Depois de conectar um aplicativo, exiba uma visão geral dos registros sincronizados entre o HubSpot e seu aplicativo de terceiros. 

  • Clique no aplicativo.
  • Na guia Visão geral da sincronização, clique em Exibição de objeto para exibir o status da sincronização por objetos.
    • Os registros que estão sendo processados como parte de uma sincronização inicial terão círculos giratórios ao lado deles.
    • Um registro terá o status Na fila se outra sincronização estiver em andamento, para evitar que as atualizações ocorram nos mesmos dados, ao mesmo tempo. 

  • Na coluna Em sincronia, clique no número de registros para revisar todos os registros sincronizados entre o HubSpot e o aplicativo.
  • Na coluna Falha , clique no número de registros para exibir todos os registros que falham ao sincronizar entre o HubSpot e o aplicativo. 
    • Na coluna Categoria do erro, revise o motivo da falha.
    • Passe o mouse sobre a dica de ferramenta para revisar as etapas a serem resolvidas.
  • Na coluna Excluído , clique no número de registros para exibir todos os registros excluídos da sincronização. Isso pode ocorrer porque eles não correspondem a nenhum dos filtros nas configurações de sincronização ou não têm um identificador exclusivo atribuído a eles, o que pode ocorrer devido a uma chave correspondente definida
    • Clique para exibir todos os registros sincronizados entre o HubSpot e o aplicativo.
    • Use o menus suspensos para filtrar os registros por tipo de objeto, status de sincronização ou um intervalo de tempo específico.
    • Para editar a ordem das colunas, clique em MaisEditar colunas
    • Para exportar todos os registros, clique em MaisExportar
      • Na caixa de diálogo, selecione o formato do arquivo
      • Clique em Exportar. O arquivo exportado será enviado por e-mail para você.
    • Para restaurar todos os registros excluídos, clique em Mais Restaurar todos os registros excluídos.
      • No painel direito, selecione o Tipo de registro e o Aplicativo de destino. Todos os registros excluídos anteriormente serão restaurados no aplicativo de destino selecionado