Para proporcionar automação perfeita 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
Como configurar as permissões
Como conectar à Salesforce Enhanced Chat API para Fin Messenger
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 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 Salesforce principais envolvidos na integração:
O usuário OAuth Salesforce – aquele vinculado durante a configuração da integração
O usuário designado como Fin – o usuário que Fin personifica ao responder, postar ou executar ações de workflow
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 às APIs com Connected Apps
O usuário que conecta ao Salesforce deve ter a permissão Aprovar Connected Apps Desinstalados habilitada. Isso é necessário para autorizar aplicativos de terceiros durante a configuração da integração.
Como configurar as permissões
Navegue até Connect > 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 o funcionamento do Fin.
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 usuário, se desejar.
Aguarde até que termine - nenhum erro deve ser exibido.
Fin Messenger: Conectar à Salesforce Enhanced Chat API
Nota: Esta seção é necessária apenas se você estiver usando o Fin Messenger. Se estiver configurando o Fin apenas para lidar com casos Salesforce, pode pular esta seção.
Para que o Fin possa transferir chats ao vivo para sua equipe no Salesforce, é necessária uma conexão com a Enhanced Chat API. Isso requer que um deployment de serviço embutido seja configurado no Salesforce.
Vá para o deployment de serviço embutido no Salesforce.
Clique em New Deployment.
Clique em Messaging for In-App and Web.
Escolha Custom Client.
Dê um nome (ex.: "Fin"), selecione seu Canal de Mensagens e depois Salve. Se você ainda não tiver um Canal de Mensagens, precisará criar um.
Entre no seu novo cliente customizado e clique no botão publicar no canto superior direito.
Selecione Code Snippet.
Copie o nome do Desenvolvedor e a URL.
Vá para Connect > Connect to the Salesforce Enhanced Chat API no seu workspace Fin.
Copie o nome do Desenvolvedor e a URL no formulário na seção "Connect".
Clique em Connect to Enhanced Chat API.
Configure e atribua o conjunto de permissões
Agora que você instalou o conjunto de permissões no Salesforce, precisará atribuí-lo ao usuário que autorizou a conexão com o Fin.
Nas 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 usuário que autorizou a conexão com o 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
Nota: Recomenda-se habilitar os campos de auditoria para que itens do feed e mensagens de e-mail sejam corretamente atribuídos ao Fin.
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 aos cases |
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 case, 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 cases |
User | Id, ContactId, FirstName, LastName, Email, UserType, IsActive | Ler | Connected User | Permite atribuir cases a usuários específicos |
Group | Id, Name, Type | Ler | Connected User | Concede visibilidade nas filas do Salesforce |
QueueSobject | QueueId, SobjectType | Ler | Connected User | Permite seleção de filas para roteamento de cases |
MessagingSession | Status, ConversationId | Ler | Fin Messenger | Verificando o status da MessagingSession |
Conversa | Id, ConversationIdentifier | Ler | Fin Messenger | Para obter a sessão de mensagens correta |
PermissionSet | Nome | Ler | Connected User | Permite-nos confirmar se o pacote de permissões está instalado |
PermissionSetAssignment | PermissionSetId, AssigneeId | Ler | Connected User | Permite-nos confirmar se o permission set está atribuído ao usuário correto. |
EmailRoutingAddress | Id, Address, EmailServicesAddressId | Ler | Connected User | Permite listar endereços de email de roteamento ativos. |
EmailServicesAddress | Id, IsActive | Ler | Connected User | 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 de AI e estado de resolução. 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:
Atribuir o Permission Set de permissões Fin para Salesforce personalizado
Habilitar Chatter e Feed Tracking no Salesforce
Confirmar visibilidade para campos personalizados como
FinInvolved__c,FinResolutionState__c,FinMarkedAsSpam__ceFinConversationId__cTestar a integração usando um ambiente sandbox ou não produtivo