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

A integração 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 Chamada de api

• Na sua conta HubSpot, clique no ícone de <configurações< <settings icon< na barra de navegação superior. No menu da barra lateral esquerda, acesse <Integrações< > <Apps conectados<.
• Na lista de aplicativos conectados, clique em Salesforce. 
• Na guia Integridades da sincronização , na seção Uso da chamada de API , exiba quantas chamadas de API você 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 para HubSpot, edite o campo Alocado para HubSpot . 

Exibir erros de sincronização do Salesforce

• Na sua conta HubSpot, clique no ícone de <configurações< <settings icon< na barra de navegação superior. No menu da barra lateral esquerda, acesse <Integrações< > <Apps conectados<.
• Na lista de aplicativos conectados, clique em Salesforce. 
• Na guia Integridade da sincronização , em Erros de sincronização, exiba cartões para cada tipo de erro, com o número de erros atuais e registros afetados. Clique em um cartão de tipo de erro para ver detalhes dos erros no painel direito. Saiba mais sobre cada tipo de erro e recomendações de resolução. 

• Para exibir mais detalhes de um erro, clique no info ícone info na coluna Tipo de erro.
• Para executar ações em registros individuais, clique em [#] registros na coluna Registros afetados e clique em Ações > Criar uma exibição temporária de registros HubSpot para criar uma exibição filtrada dos registros afetados. 
• Depois de resolver os erros, retorne à lista de erros. Marque a caixa de seleção à esquerda de quaisquer erros resolvidos e clique em Ressincronizar.
• Para exportar os erros, clique em Exportar erros (CSV) na parte superior esquerda da lista de erros.

Tipos de erro de sincronização do Salesforce

Associações

Exemplos de erros de associações 

• Limite de associações atingido
• Aguardando sincronização da conta

O que significam os erros

Os registros não estão sendo sincronizados porque estão associados a Contas do Salesforce que ainda não foram sincronizadas com as Empresas HubSpot, ou porque estão associados a registros que atingiram o limite de associações de registro do HubSpot. 

Como resolver os erros 

Para resolver o erro de limite de Associações atingido, você pode remover alguns dos registros associados ou associá-los a um registro diferente do Salesforce e continuar com a sincronização.

Para resolver o erro Aguardando a conta sincronizar, é recomendável executar uma importação das ContasdoSalesforce. 

Código personalizado

Exemplos de erros de código personalizado 

• Automação do Salesforce
• Falta a ID do contato
• Regra de validação de campo personalizado do Salesforce
• Fluxo de Salesforce

O que significam os erros

Os registros não estão sendo sincronizados devido a um problema causado por regras de automação, fluxos ou validação em sua conta do Salesforce.

Como resolver os erros

Duplicados

Exemplos de erros de duplicatas

• Email já em uso
• Regra de duplicação do Salesforce

O que significam os erros

Um lead ou contato do Salesforce não pode sincronizar com o HubSpot porque o endereço de email já existe em um registro do contato do HubSpot ou devido a uma regra de desduplicação no Salesforce. 

Como resolver os erros

Para resolver o erro de e-mail já em uso , remova o endereço de e-mail do contato HubSpot existente.

Para resolver o erro de regra de duplicação do Salesforce, é recomendável que você verifique as regras de coincidência de para desduplicações configuradas no Salesforce. 

Permissões

Exemplos de erros de permissões

• Acesso insuficiente ou registro ausente do Salesforce
• Permissão de campo do Salesforce
• Acesso insuficiente ao Salesforce

O que significam os erros

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.

Como resolver os erros

Na maioria dos casos, o erro Acesso insuficiente ou registro ausente do Salesforce ocorre quando a integração tenta atualizar um campo do Salesforce com um valor incorreto ou criar uma associação incorreta. 

Para resolver o erro de permissão do campo do Salesforce, certifique-se de que o usuário de integração do Salesforce tenha permissões de Leitura e Edição para o campo no Salesforce. 

O erro de acesso Insuficiente ao Salesforce ocorre quando o usuário de integração do Salesforce não pode executar a ação no Salesforce devido a suas permissões de usuário no Salesforce. É recomendável verificar as permissões de usuário de integração do Salesforce no Salesforce.

Listas de opções

Exemplos de erros de lista de seleção

• Opção de lista de seleção do Salesforce ausente
• Estado ou país sem correspondência
• Opções incompatíveis
• Proprietário inativo do Salesforce
• Valor da lista de seleção restrita
• Estágio de Oportunidade inativa
• Proprietários do Salesforce não sincronizados
• Limite de opção excedido
• Processo de venda padrão indisponível
• Estágio de Oportunidade ausente ou inválido

O que significam os erros

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.

Como resolver os erros

Para resolver o erro de estado Incompatível ou valor do país , é recomendável verificar se os seguintes requisitos foram atendidos:

• O valor interno da opção País propriedade no HubSpot deve corresponder a uma opção País existente em suas configurações de lista de seleção de Estado e País/Território no Salesforce. 
• O valor Estado deve existir como uma opção Estado/Província Disponível para o valor do registro no Salesforce. Além disso, o valor interno da opção State propriedade no HubSpot deve corresponder a uma opção State existente no Salesforce. 

Para resolver o erro de opções incompatíveis , é recomendável atualizar o nome interno/API das opções do campo Salesforce para corresponder ao valor interno das opções de propriedade no HubSpot. 

Para resolver o erro proprietário Inativo do Salesforce , reatribua o registro HubSpot a um usuário que seja um usuário ativo no Salesforce. 

O erro do valor da lista de seleção restrita ocorre quando você tem a lista de seleção restrita aos valores definidos na configuração do conjunto de valores ativada para o campo no Salesforce. Quando isso é ativado no Salesforce, o valor que você está tentando sincronizar do HubSpot para o Salesforce deve existir como uma opção na lista de opções do Salesforce. É recomendável desativar a lista de seleção Restringir aos valores definidos na configuração do conjunto de valores no Salesforce, para que todos os valores possam ser sincronizados de HubSpot para Salesforce. 

O erro de estágio Oportunidade inativa ocorre quando uma Oportunidade do Salesforce com um estágio Oportunidade inativa tenta sincronizar com o HubSpot. Para resolver esse erro, altere o estágio Oportunidade no Salesforce para ativo ou mova a Oportunidade para um estágio ativo. 

Para resolver o erro de proprietários do Salesforce não sincronizados, certifique-se de que os usuários do Salesforce tenham Tipo de Usuário definido como Standard, 

Para resolver o erro Limite de opções excedido , é recomendável excluir opções de propriedades extras no HubSpot e no Salesforce que sua equipe não está usando. Além disso, verifique se todas as propriedades mapeadas têm tipos de campo correspondentes. 

Na maioria dos casos, o erro Default sales process unavailable (Processo de venda padrão indisponível) ocorre quando a Oportunidade do Salesforce tenta sincronizar com o HubSpot com um Record Type (Tipo de registro)ausente. Se você tiver ativado Tipos de Registro no Salesforce, mas não os estiver usando, ou se tiver uma Oportunidade do Salesforce sem um Tipo de Registro, é recomendável que você trabalhe com o Salesforce para desativar todos os Tipos de Registro ou criar um novo Tipo de Registro. 

Para resolver o erro de estágio Oportunidade ausente ou inválido , verifique se o valor de estágio Oportunidade do Salesforce existe na pipeline HubSpot. 

Mapeamentos de propriedades

Exemplos de erros de mapeamento de propriedade 

• Tipo incompatível
• Falta a ID do Salesforce
• ID do Salesforce inválida

O que significam os erros

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.

Como resolver os erros 

Para resolver o erro de incompatibilidade de tipos , verifique se o tipo de propriedade em HubSpot e o tipo de campo no Salesforce são compatíveis. Saiba mais sobre os tipos de campo de propriedades HubSpot que podem ser sincronizados com o Salesforce. 

O erro de ID de Salesforce Ausente ocorre quando o HubSpot tentou sincronizar um valor diferente de uma ID de Salesforce existente com um campo de referência/pesquisa no Salesforce. 

Para resolver o erro de ID Inválida do Salesforce , é recomendável verificar a regra de validação personalizada que você configurou no Salesforce. 

Valores de propriedade

Exemplos de erros de valores de propriedade

• Cadeia de caracteres muito longa
• Email inválido
• País obrigatório ausente
• Valor inválido
• Atribuição de proprietário
• Valor exclusivo restrito
• Valor necessário ausente

O que significam os erros

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.

Como resolver os erros

Para resolver o erro de Cadeia de Caracteres muito longa , diminua o valor do campo no Salesforce ou HubSpot ou aumente o limite de caracteres do campo no Salesforce. 

Para resolver o erro de email inválido, atualize a formatação do endereço de email no registro do Salesforce que está tentando sincronizar com o HubSpot.

Para resolver o erro de país ausente obrigatório , é recomendável verificar se os seguintes requisitos foram atendidos:

• O valor interno da opção País propriedade no HubSpot deve corresponder a uma opção País existente em suas configurações de lista de seleção de Estado e País/Território no Salesforce. 
• O valor Estado deve existir como uma opção Estado/Província Disponível para o valor do registro no Salesforce. Além disso, o valor interno da opção State propriedade no HubSpot deve corresponder a uma opção State existente no Salesforce. 

Para resolver o erro Valor inválido, é recomendável que você atualize o valor da propriedade no registro do Salesforce para atender aos requisitos do HubSpot para o valor da propriedade. 

Na maioria dos casos, o erro de Atribuição de Proprietário ocorre quando uma atividade HubSpot é sincronizada com o Salesforce como uma tarefa do Salesforce e o HubSpot tenta atribuir a tarefa a um proprietário da Fila do Salesforce.

Para resolver o erro Valor exclusivo restrito, é recomendável que você verifique as regras de correspondência para desduplicações configuradas no Salesforce. 

Para resolver o erro de valor obrigatório Ausente, adicione um valor ao registro do Salesforce para qualquer propriedade marcada como obrigatória no HubSpot. 

Outro

Os registros não estão sendo sincronizados devido a um erro desconhecido. contato Envie o Suporte a HubSpot para obter assistência adicional com esses erros.

Observe: é possível ressincronizar em massa 100 erros do Salesforce 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 HubSpot, clique no ícone de <configurações< <settings icon< na barra de navegação superior. No menu da barra lateral esquerda, acesse <Integrações< > <Apps 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, ative a opçã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.