Para proporcionar automação contínua e experiências de suporte inteligentes, Fin integra-se profundamente com sua instância Salesforce. Essa integração requer permissões específicas em objetos e campos, que permitem que Fin crie, atualize e sincronize casos e dados relacionados no Salesforce.
Este artigo irá guiá-lo por:
Por que essas permissões são importantes
Quem precisa delas
Como implementá-las
Uma tabela de referência completa das permissões necessárias
Por que essas permissões são importantes
Fin depende dos dados do Salesforce para criar cases, postar resumos, ler informações de contato e direcionar conversas para agentes. Sem as permissões adequadas, Fin pode não conseguir interagir efetivamente com seu ambiente Salesforce — resultando em sincronizações falhas, automações bloqueadas ou funcionalidade limitada.
Quem precisa dessas permissões?
Existem dois users principais do Salesforce envolvidos na integração:
O user OAuth do Salesforce – aquele vinculado durante a configuração da integração
O user designado como Fin – o user que Fin personifica ao responder, postar ou executar ações de workflows
Quais permissões o user OAuth precisa
Sua organização Salesforce deve ter API habilitada - veja Erro Salesforce 'API não habilitada para esta Organização ou Parceiro'
O user que conecta ao Salesforce não deve ter restrições de API - veja Restringir Acesso a APIs com Apps Conectados
O user que conecta ao Salesforce deve ter a permissão Approve Uninstalled Connected Apps habilitada — isso é necessário para autorizar apps de terceiros durante a configuração da integração.
Como configurar as permissões
Navegue até Deploy > Salesforce cases > Install and assign permissions in Salesforce.
Siga os passos para instalar um pacote desbloqueado no Salesforce com todas as permissões e campos necessários para que Fin funcione no canal Cases.
Inicie a instalação do pacote de permissões.
Na seção What if existing component names conflict with ones in this package?, selecione Do not install.
Selecione Install for all users – isso significa que o conjunto de permissões pode ser atribuído a qualquer user, se desejar.
Aguarde até finalizar - nenhum erro deve ser exibido
Configure e atribua o conjunto de permissões
Agora que você instalou o conjunto de permissões no Salesforce, será necessário atribuí-lo ao user que autorizou a conexão com Fin.
Nas suas configurações Salesforce Setup > User Interface, habilite Set Audit Fields upon Creation and Update Records with Inactive Owners.
Em Salesforce Setup > Permission Sets, encontre Fin for Salesforce permissions e habilite Set Audit Fields upon Record Creation.
No Salesforce, navegue até o user que autorizou a conexão com Fin
No perfil dele, role até a seção Permission Set Assignments e clique em Edit Assignments
Selecione Intercom Fin for Salesforce permissions e atribua o conjunto de permissões
Permissões necessárias do Salesforce
Objeto Salesforce | Campos | Operações | Quem Precisa | Por que é Necessário |
EmailMessage | Id, FromName, FromAddress, ToAddress, Subject, ThreadIdentifier, HtmlBody, TextBody, CreatedById, CreatedDate, Incoming, ParentId, LastModifiedDate, LastModifiedById | Criar, Ler | Connected User, Fin | Usado para criar mensagens e respostas para workflows de email-to-case |
CaseFeed | Id, Title, Body, Type, CreatedBy.*, CreatedDate, Visibility, ParentId, LastModifiedDate | Ler | Connected User | Necessário para rastrear a atividade do case |
FeedItem | Id, Body, ParentId, IsRichText, Type, Visibility, CreatedDate, CreatedById, LastEditById | Criar | Connected User, Fin | Adiciona transcrições de conversas e resumos de AI a casos |
Case | Id, Assunto, Descrição, ContactId, OwnerId, SuppliedEmail, SuppliedName, Origem, SourceId, FinInvolved__c, FinResolutionState__c, FinMarkedAsSpam__c, FinConversationId__c | Criar, Ler, Atualizar | Todos os papéis | Criação principal de casos, transferência e sincronização de campos |
Contact | Id, Email, DataDeCriação, PrimeiroNome, Sobrenome | Criar, Ler | Connected User | Necessário ao criar ou associar contatos a casos |
User | Id, ContactId, PrimeiroNome, Sobrenome, Email, UserType, IsActive | Ler | Connected User | Permite atribuir casos a usuários específicos |
Group | Id, Nome, Tipo | Ler | Connected User | Concede visibilidade nas filas do Salesforce |
QueueSobject | QueueId, SobjectType | Ler | Connected User | Permite seleção de filas para roteamento de casos |
PermissionSet | Nome | Ler | Connected User | Permite confirmar se o pacote de permissões está instalado |
PermissionSetAssignment | PermissionSetId, AssigneeId | Ler | Connected User | Permite confirmar se o conjunto de permissões está atribuído ao usuário correto. |
EmailRoutingAddress | Id, Endereço, EmailServicesAddressId | Ler | Connected User | Permite listar endereços de email de roteamento ativos. |
EmailServicesAddress | Id, EstáAtivo | Ler | Connected User | Permite verificar se o endereço de email de roteamento listado é válido. |
Dica: Campos marcados com __c (por exemplo, FinInvolved__c) são campos personalizados usados para rastrear o envolvimento de AI e o estado de resolução. Certifique-se de que estão configurados em Configurações → Integração Salesforce.
Lista de verificação de implementação
Antes de entrar em produção, certifique-se de:
Atribua o conjunto de permissões personalizado Fin for Salesforce permissions Permission Set
Ative Chatter e Feed Tracking no Salesforce
Confirme a visibilidade para campos personalizados como
FinInvolved__c,FinResolutionState__c,FinMarkedAsSpam__ceFinConversationId__cTeste a integração usando um ambiente sandbox ou não produtivo