Passar para o conteúdo principal

Fin Messenger: Como os dados são sincronizados com o Salesforce?

Entenda como os dados são puxados e enviados de volta para o Salesforce ao usar o canal Fin Messenger

Este artigo explica como os dados fluem entre Fin Messenger e Salesforce. Use-o para entender quais campos do Salesforce o Fin puxa, como enviar dados de volta quando o Fin resolve uma conversa ou transfere para um agente, e como controlar atualizações de Contato e Conta nas configurações Push data to Salesforce.

Diagrama mostrando dados fluindo do Salesforce para o Fin, representando a direção de puxar dados

Fin Messenger: Puxando seus campos do Salesforce

Quando você configura o canal Fin Messenger e conecta ao Salesforce, o Fin puxará todos os seus campos de Contato, Caso e Conta do Salesforce.

Página de dados do Fin Settings > Salesforce mostrando três seções: Correspondência de registro (com menus suspensos de ID de correspondência de registro de Contato e Conta), Puxar dados do Salesforce (listando campos sincronizados de Contato, Caso e Conta), e Push data to Salesforce (descrevendo criação de caso e comportamento de envio de dados)

Isso permite que você use esses campos ao construir seu workflow, onde pode criar ramificações (para que certos users sejam tratados de forma diferente), ou definir dados em seus campos.

O Fin mantém esses campos sincronizados com quaisquer alterações no Salesforce verificando atualizações quando:

  • Um cliente abre o Fin Messenger

  • Um dos seus agentes responde a uma conversa quando o Fin transfere (porque não pode responder)

Painel de configurações de campo para o campo de sistema Nome, mostrando formato como String e a mensagem 'Este é um atributo do sistema e sempre será sincronizado', com apenas um botão Cancelar — confirmando que campos do sistema não podem ser removidos

Campos do sistema

Campos do sistema como ID e Nome sempre serão sincronizados e não podem ser removidos da plataforma Fin, pois são obrigatórios.

Painel de configurações de campo para o campo personalizado Engineering Req Number do Salesforce, mostrando formato como String e um botão Remover — indicando que campos personalizados podem ser removidos da plataforma Fin se não forem necessários

Campos personalizados

Campos personalizados que você criou no Salesforce podem ser removidos da plataforma Fin se você não precisar deles.

Lista de campos de dados do Salesforce mostrando atributos de User (Id, Nome, Email) e atributos de Caso (Id, Assunto, Descrição e outros), com um botão '+' destacado para adicionar e sincronizar campos adicionais do Salesforce no Fin

Sincronizando novos campos

Você pode sincronizar novos campos do Salesforce usando o botão "+".

Re-sincronizar dados do Salesforce manualmente

Você também pode acionar manualmente uma re-sincronização para campos de lista com múltiplas opções:

  1. Role até a seção Pull data from Salesforce.

  2. Selecione um campo de lista e clique em Re-sync. As opções do campo serão atualizadas imediatamente, e os valores atualizados estarão disponíveis na próxima vez que um cliente abrir o Messenger.

Página de dados do Fin Settings > Salesforce com o painel de detalhes do campo Status aberto, mostrando formato do campo (Lista), opções com descrições para auto-detecção do Fin, e um botão Re-sync na parte inferior para atualizar manualmente os valores do campo de lista

Nota: O botão Re-sync 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 um cliente abrir o Messenger.

Para adicionar descrições a atributos de lista sincronizados do Salesforce, veja Upload list attribute options via CSV.

Como os campos do Salesforce mapeiam para os atributos do Fin

O Fin tem seu próprio sistema de dados com objetos similares aos do Salesforce.

Campos de Contato do Salesforce = Dados de People do Fin

Campos de Contato do Salesforce são sincronizados no Fin como dados de People

Página de dados do Fin Settings > People listando atributos sincronizados de Contato do Salesforce incluindo nome, email, telefone e campos personalizados. Campos sincronizados do Salesforce são indicados com um ícone de nuvem ao lado do nome do campo.

Você pode gerenciá-los indo em: Settings > People data.

Campos sincronizados do Salesforce são indicados pelo ícone de 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 Caso do Salesforce = Dados de Conversation do Fin

Campos de Caso do Salesforce são sincronizados no Fin como dados de Conversation

Página de dados do Fin Settings > Conversation listando atributos sincronizados de Caso do Salesforce incluindo Número do Caso, Tipo de Caso, Assunto e campos personalizados. Campos sincronizados do Salesforce são indicados com um ícone de nuvem ao lado do nome do campo.

Você pode gerenciá-los indo em Settings > Conversation data.

Campos sincronizados do Salesforce são indicados pelo ícone de 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).


Fin Messenger: Enviando dados de volta para o Salesforce

O Fin envia dados de volta para o Salesforce de forma diferente dependendo da configuração escolhida.

Fin resolve a conversa: Criar um caso no Salesforce

Quando o Fin resolve uma conversa, você pode configurá-lo para criar um caso no Salesforce. Isso ajuda sua equipe no Salesforce a acompanhar as consultas dos clientes que estão sendo resolvidas, sem precisar acessar a plataforma Fin.

Editor de workflow do Fin Messenger mostrando a etapa 'Let Fin answer' expandida, com a seção 'Create Salesforce case on resolution' visível. O toggle está ativado e um botão 'Manage case creation settings' é exibido.

No seu workflow do Fin Messenger, clique em "Let Fin answer" e expanda a seção "Create Salesforce case on resolution"

Aqui você encontrará o toggle para ativar essa configuração.

Painel de configurações de criação de caso no Salesforce mostrando um campo Owner para selecionar uma fila ou usuário, campos de dados do Caso preenchidos automaticamente (Assunto, Email, Descrição, Transcrição, Resumo de IA), e uma seção 'Populate additional data' com opções de etapas do workflow para Definir dados, Coletar dados e Atributos do Fin

Clique em "Gerenciar configurações de criação de caso"

Essas configurações permitem que você selecione uma fila ou usuário como proprietário dos casos (se necessário), além da capacidade de personalizar o Assunto e a Descrição do seu caso, ou preencher dados adicionais – o que deve ser feito via Workflows.

Ao criar um Caso Salesforce para uma conversa que o Fin resolveu, ele preenche automaticamente:

  • Assunto

  • Descrição

  • Email

  • Transcrição

  • Resumo

Você também pode preencher dados adicionais no seu caso usando Definir dados, Coletar dados ou usar Fin Attributes.

Fin não pode responder: Criar um caso Salesforce

Quando o Fin não pode responder, você pode usar "Criar caso Salesforce" no seu workflow.

Editor de workflow do Fin Messenger mostrando um fluxo de trabalho com dois caminhos. O caminho direito (C Path) contém uma etapa 'Adicionar nota de resumo' seguida pelas etapas 'Criar caso Salesforce' e 'Atribuir fila de Cases', usado quando o Fin não consegue responder à consulta do cliente

Isso encerra a sessão de mensagens do usuário no Fin Messenger e cria um novo caso no Salesforce.

Painel de configurações Criar caso Salesforce (para quando o Fin não pode responder) mostrando opção Gerenciar conexão Salesforce, campo Proprietário, campos de dados do Caso preenchidos automaticamente (Assunto, Email, Descrição, Transcrição, Resumo AI) e opções para preencher dados adicionais via etapas de workflow

Ao criar um Caso Salesforce para uma conversa que o Fin não conseguiu resolver, ele preenche automaticamente:

  • Assunto

  • Descrição

  • Email

  • Transcrição

  • Resumo

Você também pode preencher dados adicionais no seu caso usando Definir dados, Coletar dados ou usar Fin Attributes.

Fin não pode responder: Transferir para agente Salesforce

Quando o Fin não pode responder, você pode usar "Transferir para agente Salesforce" no seu workflow.

Editor de workflow do Fin Messenger mostrando um fluxo de trabalho com dois caminhos. O caminho direito (C Path) termina com uma etapa 'Transferir para agente Salesforce', usado quando o Fin não pode responder e é necessária a transferência para um agente ao vivo

Isso cria um chat ao vivo no Salesforce para que um dos seus agentes atenda, e o usuário continua a conversa perfeitamente no Fin Messenger.

Painel de configurações Transferir para agente Salesforce mostrando opção Gerenciar conexão Salesforce, uma lista de atributos de Pessoas e Dados da Conversa que o Fin enviará para o Salesforce durante a transferência, e um link 'Saiba mais para gerenciar dados'

Ao transferir para um agente Salesforce, o Fin enviará todos os atributos de Pessoas e Dados da Conversa que existem na plataforma Fin para o Salesforce e você precisará decidir como usá-los.

Esses dados não são enviados para nenhum objeto Salesforce — são passados como atributos de roteamento (metadados enviados junto com a conversa que os Flows do Salesforce podem ler e mapear para campos).

Os atributos de roteamento são passados nesses gatilhos:

  1. Criar conversa - Quando iniciamos uma conversa

  2. Mensagem no app - Criar uma entrada de conversa

  3. Enviar um arquivo

Nota: Colegas de equipe não podem interromper uma conversa Fin antes de uma escalada oficial ou transferência para o Salesforce. A inbox do Fin não tem compositor, e a conversa não existe no Salesforce até que a transferência ocorra.

Para mapear os dados para campos no seu chat ao vivo Salesforce, você precisará usar Flows no Salesforce

Ajuda Salesforce

Mapear dados usando Flows do Salesforce

Veja nosso guia completo sobre como mapear dados com Flows do Salesforce:

Criar um caso quando nenhum agente atender

As transferências aguardam na sua fila Salesforce até que um agente as atenda. Quando sua equipe está na capacidade máxima, essa espera é invisível para o cliente, que não vê resposta nem explicação. O Fin pode criar um caso em vez disso, para que a consulta ainda chegue à sua equipe e o cliente saiba que deve esperar um retorno.

  • Ative Criar um caso quando nenhum agente atender a tempo na etapa Transferir para agente Salesforce para que o Fin crie um caso Salesforce com um resumo e transcrição da conversa, e então feche o chat ao vivo. Se um agente aceitar o chat antes do tempo de espera acabar, isso é cancelado e a conversa continua normalmente.

  • Defina quanto tempo o Fin deve esperar para que um agente atenda, em horas e minutos.

  • Um caso Salesforce precisa de um endereço de email. Se o Fin ainda não tiver um, ele pedirá o email do cliente antes de conectá-lo a um agente. Clientes que pulam essa pergunta ainda são conectados a um agente, mas não terão um caso criado para eles.

  • Use Gerenciar configurações de criação de caso para informar ao Fin para quem atribuir o caso e como ele deve aparecer no Salesforce.

Criando ou reatribuindo casos

Quando o 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. O Fin usa suas configurações de correspondência de registros para associar os casos que cria com Contatos ou Contas do Salesforce. Você pode controlar como o Fin grava dados no Salesforce na seção Enviar dados para Salesforce nas configurações da sua integração Salesforce.

  • Acionar regras de atribuição do Salesforce — quando ativado, as regras de atribuição do Salesforce são executadas em cada registro que o Fin cria ou atualiza, incluindo Cases. Desative isso e o Fin informa ao Salesforce para ignorá-las.

Transferindo chats ao vivo

Quando o Fin transfere um chat ao vivo, ele envia todos os dados disponíveis para o Salesforce e você deve usar Flows no Salesforce para mapeá-los para seus campos de chat ao vivo.

  • Atualizar dados de Contato e Conta — quando ativado, Fin atualiza o Contato e a Conta correspondentes no Salesforce com novos valores de campo ao criar ou reatribuir um Caso ou transferir um chat ao vivo. Defina esses valores no seu JSON Web Token (JWT) — o token de autenticação passado quando o cliente inicia uma sessão — ou defina os campos de contato no workflow. Desative isso e Fin ainda vincula novos Casos ao Contato e Conta correspondentes, mas não faz alterações nesses registros.


Usando Workflows para preencher dados

Além dos dados que Fin envia automaticamente para o Salesforce, você pode preencher campos adicionais do caso usando três etapas do workflow: Set data, Collect data e Fin Attributes. Elas funcionam para todos os cenários de envio — criação de caso na resolução, criação de caso quando Fin não pode responder e transferências de chat ao vivo.

Definindo dados manualmente

A etapa Set data no seu workflow do Fin Messenger permite atribuir manualmente um valor fixo a um campo do Salesforce. É mais útil em ramificações do workflow onde você já sabe qual deve ser o valor do campo com base no caminho que o cliente seguiu.

Editor de workflow do Fin Messenger mostrando o menu de seleção do tipo de etapa aberto, com opções Set data listadas incluindo Set Case Type, Set Case Origin, Set Engineering Req Number, Set Origin, Set Product, Set SLA Violation, Set Topic e Set Urgent

  • Vá para o workflow do seu canal

  • Clique em "Add step" na parte direita do workflow

  • Selecione a opção "Set data"

Workflow do Fin Messenger mostrando uma etapa 'Set Case Type to Mechanical' configurada no caminho direito, seguida por uma etapa 'Hand-off to Salesforce agent' — demonstrando como Set data preenche um campo do Salesforce antes da transferência

  • Escolha o campo que você gostaria de preencher (os campos do Salesforce são marcados com um ícone de nuvem), depois insira o valor fixo que você quer que Fin atribua a ele

  • Os dados que você definir serão enviados para o Salesforce quando um caso for criado ou o chat for transferido para um agente do Salesforce

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.

Editor de workflow do Fin Messenger com o menu de seleção de etapas aberto, mostrando opções de etapas de coleta de dados incluindo Collect data para vários campos junto com outras ações do workflow

  • Vá para o workflow do seu canal

  • Clique em "Add step" na parte direita do workflow

Painel de configuração Collect data no Fin Messenger mostrando uma lista de campos Salesforce disponíveis para coletar do cliente, incluindo Case Number, Case Type, Engineering Req Number, Product, Sub-dataset, Team e uma opção 'New attribute'

  • Selecione a opção "Collect data"

Editor de workflow do Fin Messenger mostrando uma etapa Collect data configurada no caminho do workflow, seguida por um endpoint 'Hand-off to Salesforce agent' — demonstrando como os dados coletados do cliente são enviados para o Salesforce na transferência

  • Escolha o campo que você gostaria que o cliente preenchesse (os campos do Salesforce são marcados com um ícone de nuvem) — o cliente será solicitado a inserir um valor via um formulário no Fin Messenger

  • Os dados que você definir serão enviados para o Salesforce quando um caso for criado ou o chat for transferido para um agente do Salesforce

Usando Fin Attributes para preencher dados

Fin Attributes significa que Fin pode preencher campos de lista para você automaticamente.

  1. Vá para Settings > Data > Salesforce data e sincronize o campo picklist que você quer que Fin preencha.

  2. Clique no campo e adicione uma descrição para cada valor. Fin usa essas descrições para decidir qual valor selecionar.

  3. Vá para Train > Attributes e escolha Use a list, depois salve.

Fin então detectará o valor correto da conversa e o escreverá no Salesforce quando o caso for criado ou a conversa for transferida.

Página Fin Settings > Salesforce Integration mostrando o campo de lista Status aberto, com opções para adicionar descrições a cada valor (como 'Beginning/End/Continuous', 'Text', 'Pages') para que Fin Attributes possa detectar e preencher automaticamente o campo

Seus campos de caso serão preenchidos no Salesforce

Qualquer que seja o método que você escolheu para preencher seus campos de caso (setting data, collecting data ou Fin Attributes), uma vez configurado, você verá que Fin insere valores nos seus casos do Salesforce.

Um registro de caso do Salesforce Service Cloud mostrando campos preenchidos automaticamente pelo Fin: Assunto lê 'Case from Fin AI Agent with <a href="mailto:joshua.dorrell@intercom.io" target="_blank" rel="nofollow noopener noreferrer">joshua.dorrell@intercom.io</a>', Descrição lê 'Created from Intercom Messenger', e campos personalizados Topic (Billing), Urgent (Yes) e Engineering Req Number (2500) estão destacados — demonstrando o envio bem-sucedido de dados do Fin Messenger para o Salesforce

Nota: Você pode precisar clicar em "Edit" no canto superior direito para ver esses campos, a menos que tenha ajustado seu layout padrão de caso para exibi-los.

Respondeu à sua pergunta?