Ir para o conteúdo principal
Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa. O texto oficial é a versão em inglês e sempre será o texto mais atualizado. Para ver a versão em inglês, clique aqui.

Gerencie as chamadas e erros de sincronização da API do Salesforce

Ultima atualização: Junho 28, 2023

Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:

Marketing Hub Professional, Enterprise
Vendas Hub Professional, Enterprise
Service Hub Professional, Enterprise
CMS Hub Professional, Enterprise

A integração do HubSpot-Salesforce pode encontrar erros de sincronização que impedem a sincronização dos dados. Você pode identificar e resolver esses erros de sincronização nas configurações de integração do Salesforce.

Ajustar limite de chamadas de API

  • Na sua conta da HubSpot, clique no ícone do Marketplace marketplace na barra de navegação principal. Em Gerenciar, selecione Aplicativos conectados.
  • Na lista de aplicativos conectados, clique em Salesforce
  • Clique na guia Integridade da sincronização.
  • Na seção de uso de chamadas de API, você verá quantas chamadas de API usou nas últimas 24 horas. O número Limitado pelo Salesforce é a quantidade de chamadas de API que você pode fazer com base nas configurações do Salesforce. Para ajustar quantas chamadas podem ser alocadas ao HubSpot, edite o campo Alocar para o HubSpot

sync-health-api-call-use

Resolver erros de sincronização

  • Na sua conta da HubSpot, clique no ícone do Marketplace marketplace na barra de navegação principal. Em Gerenciar, selecione Aplicativos conectados.
  • Na lista de aplicativos conectados, clique em Salesforce
  • Clique na guia Integridade da sincronização.
  • Em Erros de sincronização, você verá os cartões de cada tipo de erro, com o número atual de erros e os registros afetados por cada um deles. Clique em um cartão de tipo de erro para ver detalhes dos erros no painel direito. Veja abaixo para obter mais informações e as etapas de resolução para cada tipo de erro. 

sync-health-sync-errors

Associações

Os registros não estão sendo sincronizados porque estão associados a registros que ainda não foram sincronizados com o HubSpot, ou porque estão associados a registros que atingiram o limite de associações de registro no HubSpot. Na coluna Registros afetados, você encontrará todos os registros com falha de sincronização devido à associação com o registro na coluna Registro à esquerda.

  • Para ver os detalhes e as etapas de resolução de um erro, clique no ícone de informações info na coluna Tipo de erro.
  • Para realizar a ação em registros individuais, clique em [nº] registros na coluna Registros afetados e clique em Criar exibição para criar uma exibição filtrada dos registros afetados. 
  • Depois de resolver os erros, retorne à lista de erros de Associações. Marque a caixa de seleção à esquerda de quaisquer erros resolvidos e clique em Ressincronizar.
  • Para exportar os erros, clique em Exportar erros no canto superior direito.

Código personalizado

Os registros não estão sendo sincronizados devido a um problema causado pela automação, pelos fluxos ou pelas regras de validação na sua conta do Salesforce. Informações sobre a causa do erro aparecerão na coluna Detalhes do erro

  • Para ver os detalhes e as etapas de resolução de um erro, clique no ícone de informações info na coluna Tipo de erro.
  • Dependendo dos detalhes do erro, você pode precisar atualizar os registros afetados ou fazer alterações nas configurações do Salesforce. Para realizar a ação em registros individuais no HubSpot, clique em [nº] registros na coluna Registros afetados e clique em Criar exibição para criar uma exibição filtrada dos registros afetados.
  • Depois de resolver os erros, retorne à lista de erros de Código personalizado. Marque a caixa de seleção à esquerda de quaisquer erros resolvidos e clique em Ressincronizar.
  • Para exportar os erros, clique em Exportar erros no canto superior direito.

Duplicados

Os registros não podem ser criados porque um registro ou valor duplicado já existe. Você verá os registros do HubSpot e do Salesforce afetados pelo erro, juntamente com o valor duplicado.

  • Para ver os detalhes e as etapas de resolução de um erro, clique no ícone de informações info na coluna Tipo de erro.
  • Clique em HubSpot ou em Salesforce na coluna Exibir registro em para acessar o registro e fazer alterações.
  • Depois de resolver os erros, retorne à lista de erros de Duplicados. Marque a caixa de seleção à esquerda de quaisquer erros resolvidos e clique em Ressincronizar.
  • Para exportar os erros, clique em Exportar erros no canto superior direito.

Permissões

As alterações feitas no HubSpot não podem ser sincronizadas com o Salesforce porque o usuário conectado não tem acesso a um campo ou objeto necessário no Salesforce.

  • Para ver os detalhes específicos e as etapas de resolução de um erro, clique no ícone de informações info na coluna Tipo de erro.
  • Revise e atualize as permissões para o usuário conectado nas configurações do Salesforce.
  • Depois de resolver os erros, retorne à lista de erros de Permissões. Marque a caixa de seleção à esquerda de quaisquer erros resolvidos e clique em Ressincronizar.
  • Para exportar os erros, clique em Exportar erros no canto superior direito.

Listas de opções

Os registros não estão sendo sincronizados devido a uma discrepância entre os valores de campo da lista de seleção no HubSpot e no Salesforce. Isso poderá ocorrer quando um valor de lista de seleção em um sistema não corresponder a nenhum valor atual no outro sistema, se a lista de seleção tiver atingido um limite de valores ou se o valor passado não for válido. Você verá a propriedade do HubSpot e o campo do Salesforce que causaram o erro, juntamente com o número de registros afetados por cada erro. 

  • Para ver os detalhes e as etapas de resolução de um erro, clique no ícone de informações info na coluna Tipo de erro.
  • Dependendo dos detalhes do erro, você pode precisar atualizar os valores dos registros afetados ou fazer alterações na propriedade ou no campo. Para realizar a ação em registros individuais no HubSpot, clique em [nº] registros na coluna Registros afetados e clique em Criar exibição para criar uma exibição filtrada dos registros afetados.
  • Depois de resolver os erros, retorne à lista de erros de Listas de seleção. Marque a caixa de seleção à esquerda de quaisquer erros resolvidos e clique em Ressincronizar
  • Para exportar os erros, clique em Exportar erros no canto superior direito.

Mapeamentos de propriedades

Os registros não estão sendo sincronizados devido a uma discrepância no mapeamento entre a propriedade do HubSpot e o campo do Salesforce. Isso pode significar que a propriedade e os tipos de campo não são compatíveis, que a propriedade ou o campo não existe mais ou que um mapeamento de campo de referência do Salesforce precisa ser criado.

  • Para ver os detalhes e as etapas de resolução de um erro, clique no ícone de informações info na coluna Tipo de erro.
  • Atualize seus mapeamentos de propriedades
  • Depois de resolver os erros, retorne à lista de erros de Mapeamentos de propriedade. Marque a caixa de seleção à esquerda de quaisquer erros resolvidos e clique em Ressincronizar
  • Para exportar os erros, clique em Exportar erros no canto superior direito.

Valores de propriedade

Os registros não estão sendo sincronizados entre o HubSpot e o Salesforce, pois incluem valores de propriedade que não são válidos. Esses erros geralmente exigem que os registros afetados individuais sejam atualizados para corrigir o erro.

  • Para ver informações adicionais e as etapas de resolução, clique no ícone de informações info na coluna Tipo de erro.
  • Atualize os valores inválidos no registro no HubSpot ou no Salesforce. Para ver uma lista dos registros afetados no HubSpot, clique em [nº] registros na coluna Registros afetados e clique em Criar exibição para criar uma exibição filtrada. 
  • Depois de resolver os erros, retorne à lista de erros de Valores de propriedade. Marque a caixa de seleção à esquerda de quaisquer erros resolvidos e clique em Ressincronizar
  • Para exportar os erros, clique em Exportar erros no canto superior direito.

Outro

Os registros não estão sendo sincronizados devido a um erro desconhecido. Entre em contato com o suporte da HubSpot para obter assistência com esses erros.

Observação: é possível sincronizar erros do Salesforce 100 em massa de cada vez. Para sincronizar mais de 100 erros, importe os registros do Salesforce ou atualize uma propriedade mapeada

Configurar notificações de erro de sincronização

  • Na sua conta da HubSpot, clique no ícone do Marketplace marketplace na barra de navegação principal. Em Gerenciar, selecione Aplicativos conectados.
  • Na lista de aplicativos conectados, clique em Salesforce
  • Clique na guia Integridade da sincronização.
  • Em Erros de sincronização, clique em Gerenciar notificações
  • Na caixa de diálogo, clique para ativar o botão Ativar notificações
  • Selecione o botão de opção ao lado de Imediatamente, Diariamente ou Semanalmente para definir a frequência das suas notificações. 
  • Clique em Salvar

sync-health-error-notifications

Esse artigo foi útil?
Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot.