Para possibilitar 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 dados com Salesforce.
Este artigo irá guiá-lo por:
Por que essas permissões são importantes
Quem precisa delas
Quais permissões o usuário OAuth requer
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 casos, 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 usuários principais do Salesforce envolvidos na integração:
O usuário OAuth Salesforce – aquele vinculado durante a configuração da integração
O usuário atribuído como Fin – o usuário que Fin personifica ao responder, postar ou executar ações em workflows
Quais permissões o usuário OAuth requer
Sua organização Salesforce deve ter API habilitada - veja Erro Salesforce 'API não habilitada para esta Organização ou Parceiro'
O usuário que conecta ao Salesforce não deve ter restrições de API - veja Restringir Acesso a APIs com Connected Apps
O usuário 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?
Siga o artigo de ajuda Como conectar Fin ao Salesforce para conectar Fin ao Salesforce e instalar as permissões necessárias.
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 caso |
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, Subject, Description, ContactId, OwnerId, SuppliedEmail, SuppliedName, Origin, 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, CreatedDate, FirstName, LastName | Criar, Ler | Connected User | Necessário ao criar ou associar contatos a casos |
User | Id, ContactId, FirstName, LastName, Email, UserType, IsActive | Ler | User Conectado | Permite atribuir casos a usuários específicos |
Group | Id, Name, Type | Ler | User Conectado | Concede visibilidade nas filas do Salesforce |
QueueSobject | QueueId, SobjectType | Ler | User Conectado | Permite a seleção de filas para roteamento de casos |
MessagingSession | Status, ConversationId | Ler | Fin Messenger | Verificando o status da MessagingSession |
Conversation | Id, ConversationIdentifier | Ler | Fin Messenger | Para obter a sessão de mensagens correta |
PermissionSet | Name | Ler | User Conectado | Permite confirmar se o pacote de permissões está instalado |
PermissionSetAssignment | PermissionSetId, AssigneeId | Ler | User Conectado | Permite confirmar se o conjunto de permissões está atribuído ao usuário correto. |
EmailRoutingAddress | Id, Address, EmailServicesAddressId | Ler | User Conectado | Permite listar endereços de email de roteamento ativos. |
EmailServicesAddress | Id, IsActive | Ler | User Conectado | Permite verificar se o endereço de email de roteamento listado é válido. |
Dica: Campos marcados com __c (ex.: FinInvolved__c) são campos personalizados usados para rastrear envolvimento e estado de resolução de AI. Certifique-se de que estão configurados em Settings → Salesforce Integration.
Lista de verificação de implementação
Antes de entrar em produção, certifique-se de:
Atribua o Permission Set de permissões Fin para Salesforce personalizado
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