Passar para o conteúdo principal

Fin para Salesforce pacote desbloqueado

Este artigo é para Administradores de Sistema Salesforce configurando o Fin AI Agent com Salesforce Cases ou Fin Messenger. Está disponível em planos que incluem a integração Salesforce — verifique seu plano Intercom se não tiver certeza.

O pacote desbloqueado Fin para Salesforce concede ao Fin as permissões Salesforce e campos personalizados de caso necessários para criar, ler e atualizar casos Salesforce em nome dos seus clientes. Um pacote desbloqueado é um contêiner de metadados Salesforce — campos, conjuntos de permissões e configurações relacionadas — que é automaticamente adicionado à sua organização Salesforce quando você o instala. O pacote desbloqueado instala os seguintes componentes:

Quais campos personalizados o pacote Fin para Salesforce adiciona ao Salesforce?

O pacote desbloqueado adiciona quatro campos personalizados ao objeto Case do Salesforce. Esses campos permitem que o Fin acompanhe seu envolvimento, estado de resolução, detecção de spam e ID da conversa em cada caso. Se você estiver criando esses campos manualmente em vez de instalar o pacote, os nomes da API devem corresponder exatamente.

Nome do Campo

Metadados

FinInvolved__c

Armazena se o Fin esteve envolvido neste caso

  • Tipo: Caixa de seleção

  • Rótulo: FinInvolved

  • Valor Padrão: false

FinResolutionState__c

Armazena o estado de resolução do Fin

  • Tipo: Lista de opções

  • Rótulo: FinResolutionState

  • Valores:

    • Resolução Suave
      (API Name: soft_resolution)

    • Resolução Rígida
      (API Name: hard_resolution)

    • Encaminhado para a Equipe
      (API Name: routed_to_team)

    • Abandonado
      (API Name: abandoned_negative_feedback)

FinMarkedAsSpam__c
Armazena se a conversa foi marcada como spam pelo Fin

  • Tipo: Caixa de seleção

  • Rótulo: FinMarkedAsSpam

  • Valor Padrão: false

FinConversationId__c
Armazena o identificador da conversa para vinculação à plataforma Fin

  • Rótulo: FinConversationId

  • Comprimento: 255 caracteres

Nota: FinConversationId__c é um campo de Texto (tipo: Texto, comprimento máximo: 255 caracteres). Certifique-se de que isso esteja configurado corretamente ao criar o campo manualmente.


Quais permissões o pacote Fin para Salesforce requer?

O pacote desbloqueado Fin para Salesforce cria um PermissionSet chamado Fin for Salesforce permissions (nome da API: Fin_for_Salesforce_permissions). Este PermissionSet deve ser atribuído ao usuário Salesforce que conecta o Fin à sua organização Salesforce. Ele concede as permissões mínimas que o Fin precisa para gerenciar casos e inclui:

Permissões de Objeto

  • Case: Criar, Ler, Editar (sem Excluir, sem Modificar/Visualizar Todos os Registros)

  • Contact: Ler, Editar (sem Criar/Excluir, sem Modificar/Visualizar Todos os Registros)

  • Account: Ler, Editar (sem Criar/Excluir, sem Modificar/Visualizar Todos os Registros)

Permissões de Campo (Acesso de Leitura e Edição)

  • Campos do Case: ContactId, Description, FinInvolved__c, FinMarkedAsSpam__c, FinConversationId__c, FinResolutionState__c, Origin, SourceId, Subject, SuppliedEmail, SuppliedName

  • Campos do Contact: Email

  • Campos da Task: ActivityDate, Description, Type, WhatId, WhoId

Permissões do Sistema

  • API Enabled

  • Can Insert Feed System Fields

  • Edit Task

  • View All Users

  • View Roles

  • View Setup

Changelog

v1.0 - Versão 1

  • Cria 4 campos personalizados no case FinInvolved__c, FinResolutionState__c, FinMarkedAsSpam__c e FinConversationId__c

  • Cria 1 conjunto de permissões chamado Fin for Salesforce permissions


Perguntas Frequentes

Como instalo o pacote Fin para Salesforce?

O pacote está vinculado na etapa de implantação no canal Fin Messenger e Salesforce Cases. Você também pode instalá-lo pelos links abaixo

OU

O que faço se não quiser instalar o pacote?

Se preferir não instalar o pacote desbloqueado, você pode criar manualmente os mesmos componentes Salesforce. Siga estes passos para configurar o Fin para Salesforce sem instalar o pacote:

  1. Crie os quatro campos personalizados do Case definidos na seção "Quais campos personalizados o pacote Fin para Salesforce adiciona ao Salesforce?" deste artigo: FinInvolved__c, FinResolutionState__c, FinMarkedAsSpam__c e FinConversationId__c. Os nomes da API devem corresponder exatamente conforme documentado.

  2. Crie um PermissionSet com as permissões de objeto, permissões de campo e permissões do sistema listadas na seção "Quais permissões o pacote Fin para Salesforce requer?" deste artigo. O nome da API do PermissionSet deve ser exatamente Fin_for_Salesforce_permissions. Isso desbloqueará a etapa Instalar e atribuir permissões no Salesforce no seu fluxo de implantação.

  3. Atribua o PermissionSet ao usuário Salesforce que conectou o Fin ao Salesforce.

  4. Atualizações futuras do pacote serão documentadas no changelog.

Como faço a migração do pacote não gerenciado?

Abordagem preferida:

  1. Pausar o Fin.

  2. Desatribua o usuário Salesforce do PermissionSet Intercom Fin AI permission, isso permitirá que você desinstale o pacote não gerenciado.

  3. Desinstale o pacote não gerenciado. Durante a desinstalação, o Salesforce solicitará que você salve seus dados — selecione esta opção, pois você perderá permanentemente os valores armazenados em FinInvolved__c e FinResolutionState__c se pular esta etapa. A captura de tela abaixo mostra a tela de desinstalação do Salesforce onde você seleciona a opção de retenção de dados.

    A tela de desinstalação do Salesforce, mostrando a opção para reter e salvar os dados dos campos antes de desinstalar o pacote não gerenciado. Selecione esta opção para evitar perder os valores FinInvolved__c e FinResolutionState__c.

  4. Após a desinstalação ser concluída, o Salesforce enviará um e-mail quando a exportação dos seus dados estiver pronta. Baixe os dados salvos dos campos como um arquivo .csv clicando em Data na tela de exportação de dados do Salesforce, conforme mostrado abaixo.

    A tela de exportação de dados do Salesforce após a desinstalação, mostrando o botão Data usado para baixar os valores salvos FinInvolved__c e FinResolutionState__c como um arquivo .csv.

  5. Vá para Configurações > Integração Salesforce > Instalar e atribuir permissões no Salesforce

  6. Clique em Instalar Fin para Salesforce

Uma vez instalado, você pode usar o DataLoader para importar o arquivo csv do passo 4 e atualizar seus Cases com FinInvolved__c e FinResolutionState__c.

Abordagem opcional:

Adicione ou atualize manualmente os componentes do pacote desbloqueado documentados neste artigo. Atualizações do pacote desbloqueado serão documentadas aqui no changelog.

Nota: O pacote não gerenciado não suporta atualizações. Isso significa que novos campos e componentes adicionados em versões futuras — como FinMarkedAsSpam__c e FinConversationId__c — não estarão automaticamente disponíveis para organizações que ainda usam o pacote não gerenciado. Embora o Fin continue funcionando para funcionalidades existentes, você perderá novos recursos que exigem campos ou permissões adicionais. Migrar para o pacote desbloqueado é o caminho recomendado para se manter atualizado. Adições futuras serão documentadas no changelog acima.

Respondeu à sua pergunta?