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

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, navegue até Gerenciamento de dados > Integrações.
• 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. 

Resolver erros de sincronização

• Na sua conta da HubSpot, navegue até Gerenciamento de dados > Integrações.
• 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. 

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, navegue até Gerenciamento de dados > Integrações.
• 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.