Este artigo explica como os dados fluem entre Fin e Salesforce Cases. Cobre quais campos o Fin extrai do Salesforce, como esses campos são mapeados para os objetos de dados do Fin, quais dados o Fin escreve automaticamente de volta nos casos do Salesforce e como configurar seu workflow Fin para preencher campos adicionais do Salesforce. Use este artigo após configurar o Fin para Salesforce Cases para entender e configurar a sincronização de dados.
Nota: Você precisará de acesso de administrador tanto no Fin quanto no Salesforce para gerenciar as configurações de sincronização de campos.
Quais campos o Fin extrai do Salesforce?
Quando você implanta o Fin para casos do Salesforce, o Fin extrai todos os seus campos de Contact, Case e Account do Salesforce.
Esses campos sincronizados de Contact, Case e Account estão disponíveis ao construir seu workflow Fin para Salesforce Cases. Você pode usá-los para criar ramificações (para que certos clientes sejam tratados de forma diferente) ou para definir dados em seus campos do Salesforce.
O Fin mantém esses campos sincronizados verificando atualizações quando é atribuído pela primeira vez a um caso. Nota: se os dados do Salesforce mudarem depois que o Fin for atribuído ao caso, essas mudanças não serão captadas durante a sessão — o Fin puxará os valores mais recentes na próxima vez que for atribuído a um caso.
| Campos do sistema Campos do sistema como ID e Name sempre serão sincronizados e não podem ser removidos da plataforma Fin, pois são obrigatórios. |
| Campos personalizados Campos personalizados que você criou no Salesforce podem ser removidos da plataforma Fin se você não precisar deles. |
| Sincronizando novos campos Você pode sincronizar novos campos do Salesforce usando o botão "+". |
Imagens e anexos
O Fin sincroniza tanto imagens embutidas quanto anexos dos casos do Salesforce, fornecendo contexto completo ao ler e responder aos casos. Isso é suportado em:
FeedItems
EmailMessages
FeedComments
FeedItems são publicações no feed Chatter de um caso do Salesforce, como atualizações de status e comentários. EmailMessages são e-mails recebidos e enviados vinculados ao caso. FeedComments são respostas às publicações do feed Chatter.
Re-sincronizar dados do Salesforce manualmente
Além da sincronização automática que ocorre quando o Fin é atribuído pela primeira vez a um caso, você pode acionar manualmente uma re-sincronização para campos de lista com múltiplas opções:
Vá para Configurações > Dados do Salesforce.
Role até a seção Extrair dados do Salesforce.
Selecione um campo de lista e clique em Re-sincronizar.
Nota: O botão Re-sincronizar aparece apenas para campos de lista com múltiplas opções (como picklists e multi-seleções). Se você não o vir, o tipo de campo não suporta re-sincronização manual — o Fin puxará os valores mais recentes automaticamente na próxima vez que for atribuído a um caso.
Como os campos do Salesforce são mapeados para os atributos do Fin
O Fin tem seu próprio sistema de dados com objetos semelhantes aos do Salesforce.
Campos de Contact do Salesforce = Dados de People do Fin
Campos de Contact do Salesforce são sincronizados no Fin como dados de People
| Você pode gerenciá-los indo em: Configurações > Dados de People.
Campos sincronizados do Salesforce são indicados pelo ícone da nuvem do Salesforce.
Na página de configurações de dados de People, você notará que há outros atributos além daqueles que você sincronizou do Salesforce. Estes são atributos padrão que o Fin coleta dos seus users e podem ser enviados de volta para o Salesforce, se desejar (veja a seção "Push" abaixo). Você também pode criar novos atributos de people dentro da plataforma Fin.
|
Campos de Case do Salesforce = Dados de Conversation do Fin
Campos de Case do Salesforce são sincronizados no Fin como dados de Conversation
| Você pode gerenciá-los indo em Configurações > Dados de Conversation.
Campos sincronizados do Salesforce são indicados pelo ícone da nuvem do Salesforce.
Na página de configurações de dados de Conversation, você também pode criar novos atributos dentro da plataforma Fin. Estes podem ser enviados de volta para o Salesforce, se desejar (veja a seção "Push" abaixo). |
Quais dados o Fin envia de volta para o Salesforce?
O Fin atualiza os casos com dados cada vez que responde ou quando precisa escalar para sua equipe porque não consegue fornecer uma resposta.
Quais dados o Fin envia para o objeto Case do Salesforce?
Campos | Quando enviado? | Valor |
FinInvolved | Sincronização a cada caso | Verdadeiro (padrão: falso) |
FinResolutionState | Sincronização a cada caso | Resolução Suave / Resolução Rigorosa / Abandonado / Encaminhado para equipe |
OwnerId | Como parte da transferência | Configurado por etapa. Salesforce User ou Queue Id. |
Valores de FinResolutionState:
Resolução Suave — Fin forneceu uma resposta e a conversa terminou sem mais escalonamento
Resolução Rigorosa — o cliente confirmou explicitamente que seu problema foi resolvido
Abandonado — o cliente saiu da conversa ou não respondeu
Encaminhado para equipe — Fin escalou o caso para um colega humano porque não conseguiu resolver a consulta
Preencher dados adicionais
Você também pode preencher campos do caso usando as etapas Set data, Collect data e Fin Attributes em Workflows.
Enviar dados para Salesforce: Controles adicionais
Quando Fin cria ou reatribui um caso, ele preenche automaticamente dados como Assunto, Descrição, Email, Transcrição e Resumo no caso. Você pode preencher campos adicionais através do seu workflow. Fin também usa suas configurações de correspondência de registros para associar casos que cria com Contatos ou Contas do Salesforce. A seção Enviar dados para Salesforce inclui duas configurações que dão mais controle sobre como Fin grava dados no Salesforce:
Acionar regras de atribuição do Salesforce — quando ativado, as regras de atribuição do Salesforce são executadas em cada registro que Fin cria ou atualiza, incluindo Cases. Desative isso e Fin informa ao Salesforce para ignorá-las.
Atualizar dados de Contato e Conta — quando ativado, Fin atualiza o Contato e a Conta do Salesforce correspondentes com novos valores de campo quando cria ou reatribui um Case ou transfere um chat ao vivo. Defina esses valores no seu JWT ou defina campos de contato no workflow. Desative isso e Fin ainda vincula novos Cases ao Contato e Conta correspondentes, mas não faz alterações nesses registros.
Transferindo para sua equipe quando Fin não pode responder
Quando Fin não pode responder, você pode usar "Hand-off to team in Salesforce" no seu workflow. Isso permite que Fin reatribua o caso ao proprietário selecionado no Salesforce.
| Clique em "Add step" e selecione "Hand-off to team in Salesforce".
|
| Para selecionar um proprietário para o caso, primeiro clique para expandir a gaveta. Em seguida, escolha uma Queue ou User no Salesforce que deve ser o proprietário do caso. |
Como preencher campos do Salesforce usando workflows
Além dos dados que Fin envia automaticamente para o Salesforce (FinInvolved, FinResolutionState, OwnerId), você pode preencher quaisquer campos adicionais do caso do Salesforce usando as etapas Set data, Collect data e Fin Attributes no seu workflow Fin.
Configurando dados manualmente
A etapa Set data permite definir manualmente um valor de campo do Salesforce no seu workflow Fin para Cases do Salesforce. É mais útil em ramificações do workflow onde você sabe qual deve ser o valor com base no caminho que o cliente seguiu.
|
|
|
|
Coletando dados do cliente
Usar "Collect data" permite que você peça ao cliente para inserir as informações via um formulário no Fin Messenger.
|
|
|
|
|
|
Usando a detecção de Fin Attributes para preencher dados
Fin Attributes permitem que o Fin detecte automaticamente e preencha campos de lista (como picklists e multi-seleções) em Cases do Salesforce. Esta opção está disponível apenas para campos de lista — para campos de texto, número ou data, use Set data ou Collect data.
Para isso, você precisará inserir uma descrição para cada item da lista, para que o Fin saiba qual selecionar. Você pode fazer isso acessando:
Configurações > Dados > Dados do Salesforce
Clique no campo (lista) que você gostaria que o Fin preenchesse e insira as descrições
Agora esses campos de lista podem ser habilitados para o Fin em Train > Attributes.
E o Fin os detectará automaticamente durante a etapa "Let Fin handle" onde o Fin é implantado no seu workflow.
Alternância de detecção de Fin Attributes vs. sincronização de dados do Salesforce
Existem dois controles separados que afetam como o Fin preenche os campos do Salesforce — e é importante entender que eles são independentes:
Train → Attributes: Esta alternância controla se o Fin usa AI para detectar e classificar o atributo durante uma conversa. Desativá-la aqui para a classificação AI do Fin — mas não impede que uma integração externa de API escreva um valor nesse mesmo campo.
Configurações → Dados do Salesforce → Puxar dados do Salesforce: Isso controla se os valores dos campos do Salesforce são sincronizados para o Fin no início de uma sessão. Esta é uma sincronização de leitura separada — não é controlada pela alternância Train → Attributes.
Nota: Se você vir um campo do Salesforce sendo preenchido mesmo após desativar a alternância Fin Attributes em Train → Attributes, verifique se uma integração externa de API ou um passo Workflow Set data está escrevendo diretamente nesse campo. A alternância Train → Attributes controla apenas a detecção AI do Fin, não bloqueia gravações de outras fontes como a API do Intercom ou passos do workflow.
Seus campos de case serão preenchidos no Salesforce
Qualquer que seja o método escolhido para preencher seus campos de case (setting data, collecting data ou Fin Attributes), uma vez configurado, você verá que o Fin insere valores nos seus cases do Salesforce.
Nota: Você pode precisar clicar em Editar no canto superior direito para ver esses campos, a menos que tenha ajustado o layout padrão do case para exibi-los.