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 ao Fin criar, atualizar e sincronizar cases do Salesforce e dados relacionados.
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 importam
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 o Fin personifica ao responder, postar ou executar ações de workflows
Quais permissões o user OAuth requer
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 > Instalar e atribuir permissões no Salesforce.
Siga os passos para instalar um pacote desbloqueado no Salesforce com todas as permissões e campos necessários para o Fin funcionar no canal Cases.
Inicie a instalação do pacote de permissões.
Na seção E se nomes de componentes existentes entrarem em conflito com os deste pacote?, selecione Não instalar.
Selecione Instalar para todos os users – isso significa que o conjunto de permissões pode ser atribuído a qualquer user, se desejar.
Aguarde até terminar - nenhum erro deve ser exibido
Configure e atribua o conjunto de permissões
Agora que você instalou o conjunto de permissões no Salesforce, precisará atribuí-lo ao user que autorizou a conexão com o Fin.
Nas suas configurações Salesforce Setup > Interface do User, habilite Definir Campos de Auditoria na Criação e Atualização de Registros com Owners Inativos.
Em Salesforce Setup > Permission Sets, encontre Fin for Salesforce permissions e habilite Definir Campos de Auditoria na Criação de Registros.
No Salesforce, navegue até o user que autorizou a conexão com o Fin
No perfil dele, role até a seção Atribuições de Permission Set e clique em Editar Atribuições
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 | User Conectado, Fin | Usado para criar mensagens e respostas para workflows de email-to-case |
CaseFeed | Id, Title, Body, Type, CreatedBy.*, CreatedDate, Visibility, ParentId, LastModifiedDate | Ler | User Conectado | Necessário para rastrear 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 aos 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