Sincronize artigos do Salesforce Knowledge e use-os para alimentar o Fin AI Agent, Sales Agent e Copilot.
Nota:
Você continuará mantendo seu site Help Center no Salesforce.
Apenas artigos publicados do Salesforce são sincronizados. Artigos que não estão visíveis na sua knowledge base pública também são sincronizados, mas ficam desativados para o Fin AI Agent e ativados para o Copilot, para que sua equipe possa usá-los sem que o Fin os compartilhe com os clientes.
Sua estrutura atual do Salesforce Knowledge ainda não é suportada, mas esse recurso estará disponível em breve.
Configure a sincronização com o Salesforce Knowledge
Para configurar a sincronização do seu Salesforce Knowledge, vá para Train > Content e clique em See all depois escolha From Salesforce.
Primeiro, você precisará fazer login no Salesforce e autorizar o Fin, para que ele possa sincronizar do seu help center. Isso não modificará nenhum dado do Salesforce. Em seguida, selecione Sync articles from production.
Nota: Se seu login no Salesforce expirar após a conexão, o assistente mostrará uma mensagem e oferecerá um botão Reconnect. Clique nele para reautenticar e continuar — o assistente não permitirá que você prossiga até que a conexão seja restaurada.
Selecione o conteúdo para sincronizar
Em seguida, escolha quais artigos o Fin deve sincronizar:
Sincronizar todos os artigos - o Fin terá acesso a todos os artigos do seu help center.
Sincronizar uma seleção - aplique filtros para dar acesso ao Fin apenas a certos artigos do seu help center.
Então clique em Continue.
Mapeie campos dos artigos do Salesforce para os dados do Fin
Agora mapeie os campos dos seus artigos do Salesforce para os dados do Fin. Isso ajuda o Fin a usar o conteúdo correto ao responder clientes em seus públicos. Seus dados do Salesforce serão sincronizados regularmente no Fin.
Você também pode receber sugestões com tecnologia AI para melhorar os artigos do Salesforce Knowledge e publicar as alterações no seu help center diretamente do workspace do Fin. Para usar esse recurso, você precisará mapear o campo de conteúdo para um campo do Salesforce para sabermos para qual campo publicar o artigo no Salesforce. Se seus artigos do Salesforce forem construídos a partir de vários campos de conteúdo, mapeie cada um deles: quando uma recomendação for aceita, cada edição é publicada de volta para seu próprio campo e os campos que não foram editados permanecem como estão.
Adicione um novo campo do Salesforce e selecione o campo correspondente para seus artigos do Salesforce, depois mapeie-o para o campo content do Fin. Quando terminar, clique em Sync from Salesforce.
Escolha quem vê o conteúdo sincronizado
Após mapear seus campos, escolha quais produtos podem acessar os artigos sincronizados. Ative os produtos que deseja habilitar:
Fin AI Agent — gera respostas AI para clientes.
Sales Agent — gera respostas AI para prospects.
Copilot — disponibiliza conteúdo para colegas de equipe.
Use a seção Audience control para limitar para quais clientes o Fin pode usar esses artigos. Cada regra mostra a contagem de artigos correspondentes, para que você veja o impacto dos seus filtros rapidamente. Dentro de cada regra, escolha um audience existente ou adicione filtros baseados em campos do Salesforce, depois use o menu Select access para escolher os papéis do Fin (Service, Sales ou Copilot) aos quais a regra deve se aplicar. Então clique em Save.
Nota: Pelo menos um produto deve estar ativado para que o botão Save fique disponível — o botão explica por que está bloqueado se nada estiver habilitado.
O acesso ao conteúdo funciona em dois níveis:
Nível | O que faz |
Chaves de ativação no topo da etapa Target | Define o padrão para cada artigo que essa fonte importa — aplica-se ao Fin AI Agent, Sales Agent e Copilot. |
Menu de papéis do Fin dentro de cada regra de audiência | Substitui as chaves de ativação do nível superior, mas apenas para os artigos que a regra corresponde. O padrão é desligado para uma nova regra. |
Nota:
Se duas regras de audiência corresponderem ao mesmo artigo, o artigo será marcado com ambas as audiências de forma aditiva. No entanto, a disponibilidade da AI (quais produtos podem usá-la) é determinada apenas pela última regra correspondente na cadeia.
Depois que a primeira sincronização for iniciada, não é possível forçar a parada. Você pode remover a sincronização após a sincronização inicial ser concluída.
Após a sincronização ser concluída, você receberá um e-mail no endereço registrado no Fin confirmando quantos artigos foram sincronizados.
Gerencie o conteúdo do Salesforce Knowledge
Quando seu conteúdo estiver sincronizado com o Salesforce, ele estará acessível em Train > Content na seção “Content sources”.
Configure as configurações
Para gerenciar o conteúdo do Salesforce, vá para Train > Content e clique na sua fonte Salesforce na seção “Content sources”, depois abra o artigo que deseja gerenciar.
Há um painel “Details” à direita que contém:
Dados: Veja o tipo de conteúdo, idioma, data de criação, última atualização (data da última sincronização com o Salesforce).
Fin: Ative/desative para Fin AI Agent, Sales Agent e Copilot. Quando ativado, o conteúdo fica disponível para clientes, prospects e colegas de equipe, respectivamente.
Agendamento: Ative ou desative o conteúdo para Fin e Copilot em datas definidas.
Audience: Direcione seu conteúdo para um público específico, para que o Fin compartilhe apenas o conteúdo relevante para eles.
Relatórios: Acompanha com que frequência esse conteúdo é usado para resolver conversas pelo Fin.
Tag: Adicione uma tag para agrupar artigos e manter o conteúdo organizado.
Agende a disponibilidade do conteúdo do Salesforce
Você pode agendar quando os artigos sincronizados do Salesforce serão ativados ou desativados para Fin e Copilot, em uma data, hora e fuso horário futuros. Defina apenas uma data de início ou defina uma data de início e fim para criar uma janela de disponibilidade limitada. O agendamento se aplica a artigos individuais ou em massa.
Agendar um único artigo
Abra o artigo. No painel Detalhes à direita, encontre a seção Scheduling dentro do menu suspenso Fin.
Clique em Schedule availability.
No modal: selecione o produto de IA (Fin for Service ou Fin Copilot), defina a disponibilidade (Ativar ou Desativar) e escolha uma data, hora e fuso horário.
Opcionalmente, ative Set end date para adicionar uma data e hora de término — a ação será revertida automaticamente nesse momento.
Clique em Schedule para confirmar.
Agendar artigos em massa
Selecione vários artigos na lista de conteúdo.
Vá para o menu suspenso More actions e selecione Schedule availability.
O mesmo modal de agendamento se aplica a todos os itens selecionados.
Como o agendamento funciona
Somente data de início: A ação de ativar/desativar ocorre no horário agendado e permanece em efeito até que você a altere manualmente.
Data de início + fim: O conteúdo é ativado (ou desativado) no horário de início e depois reverte automaticamente no horário de término.
Alterações manuais não cancelam um agendamento pendente: Se você alterar manualmente a disponibilidade após definir um agendamento, a transição agendada ainda ocorrerá no horário previsto e substituirá sua alteração manual.
Um agendamento pendente por item por agente: Definir um novo agendamento substitui o anterior — sem duplicatas.
Conteúdo excluído: Se um artigo for excluído antes do agendamento ser executado, o agendamento simplesmente não será aplicado e nenhum erro será exibido.
Dica: Para auditar e gerenciar conteúdo agendado, filtre a lista de conteúdo pela tag scheduled-for-agent-availability. Isso mostra apenas itens com transições agendadas próximas, facilitando a revisão de tudo de uma vez.
Re-sincronize ou remova a sincronização com Salesforce Knowledge
Se desejar re-sincronizar ou remover a sincronização com Salesforce Knowledge, você pode fazer isso em Train > Content. Clique no menu de três pontos ao lado da fonte e selecione Re-sync ou Remove sync.
Nota:
As re-sincronizações são executadas automaticamente todos os dias e propagam quaisquer alterações feitas nos artigos do Salesforce para o Fin. Isso inclui novos artigos, alterações no conteúdo do artigo e remoção de artigos. Para receber artigos novos e editados no Fin em poucos minutos, ative as atualizações em tempo real.
Artigos sincronizados do Salesforce serão exibidos como somente leitura e não podem ser editados, a menos que você esteja revisando/aprovando uma sugestão de conteúdo AI.
Sincronizações que ocorrem automaticamente após a primeira sincronização não enviarão um e-mail ao concluir.
Como ativar as atualizações em tempo real
Por padrão, os artigos do Salesforce Knowledge são re-sincronizados uma vez por dia. Com as atualizações em tempo real ativadas, artigos novos e editados no Salesforce sincronizam com o Fin em poucos minutos. As atualizações em tempo real estão desativadas por padrão e você as ativa para cada fonte do Salesforce.
Antes de começar
No Salesforce:
Instale o pacote Fin for Salesforce: Knowledge na sua organização Salesforce. Você encontrará um link de instalação no painel Real-time updates.
Atribua o conjunto de permissões Fin Knowledge Admin ao usuário Salesforce conectado ao Fin.
Atribua o conjunto de permissões Fin Knowledge Events a todos que editam artigos do Knowledge.
Ative as atualizações em tempo real
Para ativar as atualizações em tempo real:
Vá para Train > Content e edite sua fonte do Salesforce.
Na etapa de mapeamento de campos, encontre o painel Real-time updates e ative-o.
Verifique se o status mostra On. Article edits sync within a few minutes.
Para desativar as atualizações em tempo real, desligue o botão no mesmo painel. Seu conteúdo continuará sincronizando uma vez por dia.
Nota:
As atualizações em tempo real começam após a conclusão da primeira sincronização completa da sua fonte.
Artigos excluídos não são removidos em tempo real. A sincronização diária os remove.
Solução de problemas das atualizações em tempo real
Se você vir um destes erros ao ativar as atualizações em tempo real:
O pacote Fin for Salesforce: Knowledge não está instalado nesta organização Salesforce. Instale o pacote e ative as atualizações em tempo real novamente.
O usuário Salesforce conectado ao Intercom precisa do conjunto de permissões Fin Knowledge Admin. Atribua o conjunto de permissões a esse usuário e ative as atualizações em tempo real novamente.
O Intercom não conseguiu fazer login no Salesforce. Reconecte o Salesforce e ative as atualizações em tempo real novamente.
Não foi possível ativar as atualizações em tempo real. Tente novamente. Se continuar falhando, entre em contato com nossa equipe de suporte.
Para verificar a atividade em tempo real da sua fonte Salesforce Knowledge, abra o histórico de sincronização e veja o resumo Live updates. Ele mostra os últimos 7 dias de atividade em tempo real: quantos artigos foram criados, atualizados e excluídos, quaisquer falhas, quando a última atualização chegou e os itens mais recentes.
Solução de problemas de citações do Salesforce
Se você encontrar problemas com citações de artigos do Salesforce ao sincronizar para o Fin, consulte esta seção para solução de problemas.
Problemas comuns de citação
Citações desaparecendo: Este problema pode ocorrer quando o workspace não está configurado para conteúdo externo.
URLs internas vs. públicas: As citações podem vincular incorretamente a URLs internas do Salesforce se o mapeamento de URL não estiver configurado corretamente.
Resolvendo problemas de citação
Ative o conteúdo externo para seu workspace:
Certifique-se de que o recurso para usar conteúdo externo está ativado nas configurações do seu workspace.
Re-sincronize após ativar o recurso para corrigir citações desaparecendo.
Atualize o Mapeamento de URL:
Acesse as configurações de mapeamento de URL do Salesforce e alinhe as citações com as URLs públicas dos artigos.
Salve as configurações novamente e teste os links mapeados.
Diferenças importantes entre seus artigos no Salesforce e Fin
Existem pequenas diferenças na aparência dos artigos sincronizados no Fin Messenger comparados aos artigos no Salesforce. As diferenças podem incluir formatos de conteúdo como títulos adicionais, estilos de texto, formatação de tabelas, etc.
Se um cliente clicar no link “Abrir no Help Center” na parte inferior de um artigo sincronizado no Fin Messenger, isso abrirá uma nova aba com o artigo no seu Help Center do Salesforce.
Artigos sincronizados são somente leitura e não podem ser editados a partir do seu workspace Fin ou via Public API. Todas as alterações devem ser feitas através do Salesforce e serão automaticamente propagadas para o Fin na próxima sincronização.
Não suportamos artigos em qualquer idioma que não seja atualmente suportado pelo Fin. Se você tiver suporte apenas para o idioma inglês, ele será transferido para o “inglês padrão” do Fin em vez do inglês regional mapeado no Salesforce.
Não suportamos os estilos dos artigos definidos a nível de tema no Salesforce, portanto pode haver diferenças na aparência de um artigo no Salesforce versus no Fin.
Suportamos exclusivamente vídeos adicionados pelo botão “Add video” do Salesforce, normalmente incorporados via
iframe, e compatíveis com todos os provedores disponíveis no editor de artigos do Salesforce (ex.: YouTube, Vimeo, Wistia, JWPlayer, Brightcove, Vidyard, Loom, Guidde). Incorporações de vídeo personalizadas em HTML, CSS ou JavaScript não são suportadas.





