Quando o Fin encontra um problema ao conectar com o 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 do 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 foi afetado.
Como acessar os logs de erro
Vá para Configurações > Logs de erro.
Selecione qualquer erro relacionado ao Salesforce para abrir o painel de 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 ao conectar ao Salesforce
Código de erro: OAUTH_EC_APP_NOT_FOUND
Quando aparece: ao conectar o Fin ao Salesforce.
Como corrigir este erro: O pacote Fin para Salesforce não está instalado na organização que você está conectando, ou não está na versão mais recente.
Instale ou atualize o pacote Fin para Salesforce nessa organização Salesforce exata.
Reconecte o Fin ao Salesforce.
Reinstalar o pacote não afeta outros workspaces do Fin.
Erros com importação de conhecimento
Objeto: Knowledge__kav
Código de erro: INVALID_QUERY_FILTER_OPERATOR
Mensagem: Filtro inválido na consulta de 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 dos 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 inválidos no filtro da consulta de 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 dos 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 nos campos dos artigos de conhecimento do Salesforce. Verifique se houve atualizações nas permissões ou visibilidade dos campos usados em seus filtros.
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 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 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 está causando o erro de validação personalizada está sendo configurado corretamente no workflow.
Se você não quiser que o workflow defina esse 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 o 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:
Vá para Deploy > Salesforce Cases > Workflow.
Faça uma das seguintes ações:
Atualize o workflow para garantir que o campo picklist que está causando o erro de restricted picklist 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 com o valor correto.
Objeto: Case
Código de erro: UNABLE_TO_LOCK_ROW
Como corrigir este erro: Fin não conseguiu atualizar o Salesforce Case porque outro processo estava atualizando ao mesmo tempo. Algumas atualizações do 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 Salesforce Case.
Objeto: Case
Sintoma: Respostas de clientes a um caso existente estão criando novas conversas no seu workspace Fin em vez de se conectarem ao caso original.
Como corrigir este erro: Isso ocorre quando Lightning threading não está habilitado no Salesforce. Sem ele, o Salesforce não preserva os cabeçalhos do thread de e-mail que o Fin usa para associar respostas recebidas ao caso original.
Vá para Salesforce Setup → Email → Email-to-Case.
Habilite Lightning Threading e salve suas alterações.
Nota: Lightning threading se aplica a toda a sua organização Salesforce — afeta todos os casos e e-mails, não apenas os tratados pelo Fin. Se sua equipe depende que o threading esteja desativado para outros workflows, revise o impacto em toda a sua configuração Salesforce antes de habilitá-lo.
Objeto: EmailMessage
Código de erro: INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY
Como corrigir este erro: O objeto Salesforce EmailMessage referencia o Case via ParentId e um User via CreatedById e LastModifiedById. Certifique-se de que o Salesforce User 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 Salesforce Case 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 Salesforce Setup → User Interface.
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 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 de caso com texto rico.
Vá para Salesforce Setup → Chatter Settings
Clique em Editar
Em Rich Text Posts habilite “Permitir que usuários componham posts 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 ajuda.
Erros com Fin Messenger
Objeto: Case
Código de erro: INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST
Mensagem: Valor inválido selecionado para campo restricted picklist.
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 restricted picklist 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 com 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 restricted picklist.
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 com 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 com o valor correto.
Nota: Se o campo não estiver visível como uma etapa Set data, 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 Salesforce Case. 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 Salesforce Case. 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 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.
Objeto: FeedItem
Código de erro: UNKNOWN_EXCEPTION
Mensagem: O usuário do contexto não tem permissão para criar texto formatado no feed
Como corrigir este erro: Fin precisa da capacidade de criar itens de feed de case com texto formatado.
Vá para Configuração do Salesforce → Configurações do Chatter
Clique em Editar
Em Publicações com Texto Formatado ative “Permitir que users componham publicações com texto formatado”
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.
Erro: Incompatibilidade no modo de autenticação no Fin Messenger com Salesforce Messaging
Como corrigir este erro: Visitantes logados sempre enviam tokens autenticados, então o canal de mensagens Salesforce deve aceitá-los.
No Salesforce, vá para Configuração → Configurações de Mensagens e selecione o canal.
Ative Verificação de User para o canal de mensagens.
Configure a verificação de identidade para o Fin Messenger.
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á ativado na sua Organização Salesforce.
Para resolver isso, faça uma das seguintes ações:
Vá para Configuração do Salesforce → Enhanced Email e ative o Enhanced Email.
Desative a sincronização do histórico da conversa. Vá para Fin Workspace → Configurações → integração Salesforce e desative Sincronizar histórico de case do Salesforce.
Estamos trabalhando ativamente para suportar organizações Salesforce sem Enhanced Email. Entre em contato com nossa equipe de suporte para as últimas atualizações.
Objeto: CaseFeed
Código de erro: INVALID_FIELD
Mensagem: O workspace precisa que Digital Experiences esteja ativado.
Como corrigir este erro: Fin não pode consultar o campo Visibility no objeto CaseFeed do Salesforce. 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 ativá-lo.
Se o problema persistir após a ativação, compartilhe os detalhes do erro com seu administrador Salesforce ou entre em contato com nossa equipe de suporte.
Objeto: Case
Código de erro: INVALID_FIELD
Como corrigir este erro: Fin não pode consultar certos campos no objeto Case do Salesforce. 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 entre em contato com 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 erro do Salesforce?
Ainda não — mas você pode clicar em Copiar todos os detalhes 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 de Error logs assim que Fin reconecta com sucesso ou tenta novamente a solicitação que falhou.