Quando Fin encontra um problema ao conectar com Salesforce, os detalhes aparecem em Logs de erro. Este guia ajuda você a entender rapidamente o que cada erro significa e como corrigi-lo.
Cada entrada de erro inclui:
Código de erro – um identificador único para o erro.
Erro do sistema – a mensagem retornada pelo Salesforce.
Caminho da requisição – O endpoint específico da API Salesforce que gerou o erro.
Método da requisição – O método HTTP usado (por exemplo, GET, POST ou PATCH).
Código de status – O código de resposta HTTP retornado pelo Salesforce (por exemplo, 400 ou 403).
Funcionalidade do produto – onde o problema ocorreu (por exemplo, Historical Conversations Import).
Tipo de API e Tipo de objeto – detalhes técnicos para ajudar a identificar qual objeto de dados ou endpoint do Salesforce está afetado.
Como acessar os logs de erro
Vá para Configurações > Logs de erro.
Selecione qualquer erro relacionado ao Salesforce para abrir o painel Detalhes do erro.
Dica: Você pode clicar em Revisar configuração para abrir as configurações relevantes de conexão ou permissão do Salesforce diretamente dos logs de erro.
Como corrigir erros comuns de integração
Erros com importação de conhecimento
Objeto: Knowledge__kav
Código de erro: INVALID_QUERY_FILTER_OPERATOR
Mensagem: Filtro inválido na consulta do artigo de conhecimento, provavelmente devido a incompatibilidade de tipo de dado.
Como corrigir este erro:
Revise seus filtros e tente sincronizar seus artigos novamente.
Se a sincronização estava funcionando antes, o erro pode ser causado por alterações nos campos de artigos de conhecimento do Salesforce. Verifique se algum campo usado em seus filtros foi atualizado no Salesforce.
Objeto: Knowledge__kav
Código de erro: MALFORMED_QUERY
Mensagem: Valores de filtro inválidos na consulta do artigo de conhecimento.
Como corrigir este erro:
Revise seus filtros e tente sincronizar seus artigos novamente.
Se a sincronização estava funcionando antes, o erro pode ser causado por alterações nos campos de artigos de conhecimento do Salesforce. Verifique se algum campo usado em seus filtros foi atualizado no Salesforce.
Objeto: Knowledge__kav
Código de erro: NOT_FOUND
Mensagem: O artigo de conhecimento solicitado não foi encontrado.
Como corrigir este erro: Ao iniciar uma importação de conhecimento, coletamos um instantâneo dos artigos que precisam ser sincronizados e então iniciamos a sincronização. Entre a coleta e a sincronização, parece que um artigo foi excluído e não está mais disponível para consulta. Não há outra ação a ser tomada, exceto talvez restaurar o artigo excluído.
Objeto: Knowledge__kav
Código de erro: INVALID_FIELD
Mensagem: Houve alguns problemas na construção da consulta do artigo de conhecimento.
Como corrigir este erro:
Verifique e atualize seus filtros e tente sincronizar sua seleção de artigos novamente.
Se a sincronização estava funcionando antes, o erro pode ser causado por alterações nas permissões ou visibilidade dos campos usados em seus filtros no Salesforce.
Objeto: Knowledge__kav
Código de erro: UNKNOWN
Mensagem: Houve alguns problemas na construção da consulta do artigo de conhecimento.
Como corrigir este erro: Atualmente, só suportamos a importação de objetos Knowledge__kav como artigos do Salesforce. Se sua organização Salesforce usa um objeto diferente, entre em contato com nossa equipe de suporte para assistência.
Erros com Cases do Salesforce
Objeto: Case
Código de erro: INVALID_FIELD_FOR_INSERT_UPDATE
Mensagem: O usuário de integração não tem permissões para atualizar os campos de auditoria no objeto.
Como corrigir este erro:
Se o erro for sobre Fin não conseguir definir CreatedById ou LastModifiedById:
Vá para Configuração do Salesforce → Interface do Usuário.
Habilite as permissões “Definir campos de auditoria ao criar registro” e “Atualizar registros com proprietários inativos”.
(Consulte Habilitar a permissão 'Criar campos de auditoria' no Salesforce)
Se o erro for sobre qualquer outro campo:
Compartilhe os detalhes do erro com seu administrador Salesforce ou entre em contato com nossa equipe de suporte para ajuda.
Objeto: Case
Código de erro: FIELD_CUSTOM_VALIDATION_EXCEPTION
Como corrigir este erro:
Faça uma das seguintes ações:
Verifique se o campo que causa o erro de validação personalizada está sendo definido corretamente no workflow.
Se você não quiser que o workflow defina este campo, configure um Salesforce Flow para definir ou padronizar o campo com o valor correto.
Objeto: Case
Código de erro: CANNOT_EXECUTE_FLOW_TRIGGER
Como corrigir este erro: Um fluxo ou processo na sua organização Salesforce está gerando um erro quando Fin atualiza ou cria um Case.
Compartilhe os detalhes do erro do sistema com seu administrador Salesforce para que ele possa resolver o problema no fluxo ou processo do Salesforce.
Objeto: Case
Código de erro: INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST
Como corrigir este erro:
Faça uma das seguintes ações:
Atualize o workflow para garantir que o campo picklist que causa o erro de picklist restrito esteja definido corretamente.
Se você não quiser que o workflow defina este campo, configure um Salesforce Flow para definir ou padronizar o campo picklist com o valor correto.
Objeto: Case
Código de erro: UNABLE_TO_LOCK_ROW
Como corrigir este erro: Fin não conseguiu atualizar o Case do Salesforce porque outro processo estava atualizando-o ao mesmo tempo. Algumas atualizações no Case podem não ter sido salvas.
Se Fin ainda estiver atribuído ao Case, a próxima atualização tentará novamente automaticamente.
Se Fin não estiver mais atribuído, pode ser necessário copiar manualmente quaisquer atualizações da conversa do Fin para o Case do Salesforce.
Objeto: EmailMessage
Código de erro: INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY
Como corrigir este erro: O objeto EmailMessage do Salesforce referencia o Case via ParentId e um User via CreatedById e LastModifiedById. Certifique-se de que o User do Salesforce que conectou o Fin tenha permissão para acessar tanto o Case quanto os objetos User.
Se sua Organização Salesforce usa Enhanced Email, o Salesforce também criará Tasks a partir dos registros EmailMessage. Nesse caso, certifique-se de que o mesmo usuário tenha permissão para acessar Tasks, se o primeiro passo não resolver o problema.
Objeto: EmailMessage
Código de erro: UNABLE_TO_LOCK_ROW
Como corrigir este erro: Fin não conseguiu criar um EmailMessage para o Case do Salesforce porque outro processo estava atualizando o Case ao mesmo tempo.
Se Fin ainda estiver atribuído ao Case, a próxima atualização criará automaticamente o EmailMessage e enviará o e-mail novamente.
Objeto: EmailMessage
Código de erro: INVALID_FIELD_FOR_INSERT_UPDATE
Como corrigir este erro: Se o erro for sobre o Fin não conseguir definir CreatedById ou LastModifiedById:
Vá para Configuração do Salesforce → Interface do Usuário.
Habilite as permissões “Set Audit Fields upon Record Creation” e “Update Records with Inactive Owners”.
(Consulte Habilitar a permissão 'Create Audit Fields' no Salesforce)
Se o erro for sobre qualquer outro campo:
Compartilhe os detalhes do erro com seu administrador Salesforce ou entre em contato com nossa equipe de suporte para obter ajuda.
Objeto: FeedItem
Código de erro: UNKNOWN_EXCEPTION
Mensagem: O usuário do contexto não tem permissão para criar texto rico no feed
Como corrigir este erro: Fin precisa da capacidade de criar itens de feed do case com texto rico.
Vá para Configuração do Salesforce → Configurações do Chatter
Clique em Editar
Em Publicações com Texto Rico habilite “Permitir que users componham publicações com texto rico”
Clique em Salvar.
Se o erro for sobre qualquer outro campo:
Compartilhe os detalhes do erro com seu administrador Salesforce ou entre em contato com nossa equipe de suporte para obter ajuda.
Erros com Fin Messenger
Objeto: Case
Código de erro: INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST
Mensagem: Valor inválido selecionado para campo picklist restrito.
Como corrigir este erro:
Vá para Deploy > Fin Messenger > Workflow.
Faça uma das seguintes ações:
Atualize o workflow para garantir que o campo picklist que está causando o erro de picklist restrito esteja configurado corretamente.
Se você não quiser que o workflow defina este campo, configure um Salesforce Flow para definir ou padronizar o campo picklist para o valor correto.
Objeto: Case
Código de erro: CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY
Como corrigir este erro: Fin não pode criar um Case durante a etapa Create Salesforce Case no workflow do Fin messenger. Certifique-se de que o usuário Salesforce que conectou o Fin ao Salesforce tenha permissão para acessar o objeto Case.
Objeto: Case
Código de erro: FIELD_CUSTOM_VALIDATION_EXCEPTION
Mensagem: Valor inválido selecionado para campo picklist restrito.
Como corrigir este erro:
Vá para Deploy > Fin Messenger > Workflow.
Faça uma das seguintes ações:
Atualize o workflow para garantir que o campo que está causando o erro de validação esteja configurado corretamente.
Se você não quiser que o workflow defina este campo, configure um Salesforce Flow para definir ou padronizar o campo para o valor correto.
Objeto: Case
Código de erro: REQUIRED_FIELD_MISSING
Como corrigir este erro:
Vá para Deploy > Fin Messenger > Workflow.
Faça uma das seguintes ações:
Atualize o workflow para garantir que o campo que está causando o erro de validação esteja configurado corretamente.
Se você não quiser que o workflow defina este campo, configure um Salesforce Flow para definir ou padronizar o campo para o valor correto.
Nota: Se o campo não estiver visível como uma etapa de definição de dados, vá para Deploy > Fin Messenger > Data e selecione o campo Case na seção Pull data from Salesforce.
Objeto: Case
Código de erro: INVALID_FIELD_FOR_INSERT_UPDATE
Como corrigir este erro: Fin não pode definir certos campos no objeto Case do Salesforce. Certifique-se de que o usuário Salesforce que conectou o Fin tenha as permissões corretas no objeto Case.
Se o problema continuar, compartilhe os detalhes do erro com seu administrador Salesforce ou entre em contato com nossa equipe de suporte para assistência.
Objeto: Case
Código de erro: INVALID_EMAIL_ADDRESS
Como corrigir este erro: Fin não conseguiu criar um objeto Case do Salesforce. Por favor, verifique se o e-mail fornecido ao Fin é válido.
Objeto: Case
Código de erro: CANNOT_EXECUTE_FLOW_TRIGGER
Como corrigir este erro: Um fluxo ou processo em sua Organização Salesforce está gerando um erro quando Fin atualiza ou cria um Case. Compartilhe os detalhes do erro do sistema com seu administrador Salesforce para que ele possa resolver o problema.
Objeto: FeedItem
Código de erro: UNKNOWN_EXCEPTION
Mensagem: O usuário do contexto não tem permissão para criar texto rico no feed
Como corrigir este erro: Fin precisa da capacidade de criar itens de feed do case com texto rico.
Vá para Configuração do Salesforce → Configurações do Chatter
Clique em Editar
Em Publicações com Texto Rico habilite “Permitir que users componham publicações com texto rico”
Clique em Salvar.
Se o erro for sobre qualquer outro campo:
Compartilhe os detalhes do erro com seu administrador Salesforce ou entre em contato com nossa equipe de suporte para obter ajuda.
Erros com histórico de sincronização de case
Objeto: Emails
Código de erro: INVALID_TYPE
Mensagem: O usuário de integração não pode acessar as mensagens de email anexadas ao case.
Como corrigir este erro: Fin não pode acessar o relacionamento Emails no objeto Case do Salesforce. Isso provavelmente ocorre porque Enhanced Email não está habilitado em sua Organização Salesforce.
Para resolver isso, faça uma das seguintes ações:
Vá para Salesforce Setup → Enhanced Email e ative o Enhanced Email.
Desative a sincronização do histórico de conversas. Vá para Fin Workspace → Settings → Salesforce integration e desative Sync case history from Salesforce.
Estamos trabalhando ativamente para suportar organizações Salesforce sem Enhanced Email. Contate nossa equipe de suporte para as últimas atualizações.
Object: CaseFeed
Error code: INVALID_FIELD
Message: O workspace precisa que Digital Experiences esteja ativado.
How to fix this error: Fin não pode consultar o campo Visibility no objeto Salesforce CaseFeed. Certifique-se de que o usuário Salesforce que conectou o Fin tem permissão para acessar este campo.
O campo Visibility está disponível apenas quando Digital Experiences está ativado no Salesforce. Este campo é necessário para determinar se um comentário é interno ou público. Consulte Ativar Digital Experiences no Salesforce para habilitá-lo.
Se o problema persistir após a ativação, compartilhe os detalhes do erro com seu administrador Salesforce ou contate nossa equipe de suporte.
Object: Case
Error code: INVALID_FIELD
How to fix this error: Fin não pode consultar certos campos no objeto Salesforce Case. Verifique se o usuário Salesforce que conectou o Fin tem permissão para acessar esses campos.
Se o problema continuar, compartilhe os detalhes do erro com seu administrador Salesforce ou contate nossa equipe de suporte.
Perguntas Frequentes
Como saber se um erro está relacionado ao Salesforce?
Erros relacionados ao Salesforce mostrarão API type: Salesforce REST API nos detalhes do erro.
Posso exportar logs de erros do Salesforce?
Ainda não — mas você pode clicar em Copy all details em qualquer painel de erro para copiar o log completo para relatório ou compartilhamento.
Onde posso ver erros resolvidos?
Problemas resolvidos são automaticamente removidos da visualização Error logs assim que o Fin reconecta com sucesso ou tenta novamente a solicitação que falhou.