Passar para o conteúdo principal

Sincronize ou importe artigos internos de fontes externas

Como sincronizar ou importar seu conteúdo de suporte do Confluence, Guru ou Notion.

Escrito por Beth-Ann Sher

Você pode sincronizar ou importar seu conteúdo interno do Confluence, Guru ou Notion para o Intercom, onde pode ser acessado pelos colegas de equipe no seu workspace e habilitado para Fin AI Agent e/ou Copilot. As fontes Confluence e Notion agora suportam metadados mais ricos, regras de pré-filtragem e um novo fluxo de revisão para que você possa controlar exatamente quais páginas entram no Intercom e onde são usadas.

Quando o conteúdo é sincronizado:

  • Ele não pode ser editado no Intercom. As alterações no conteúdo devem ser feitas na ferramenta de origem (Confluence, Notion ou Guru).

  • Ele será automaticamente ressincronizado a cada 24 horas e quaisquer novas alterações no conteúdo serão refletidas no Intercom. Também pode ser ressincronizado manualmente.

  • A sincronização diária é pulada quando não houve atualizações no conteúdo da fonte desde a última sincronização, pois executá-la não produziria nada novo.

  • O conteúdo será adicionado a uma nova pasta sincronizada em Knowledge. Uma pasta sincronizada não pode ser modificada e todas as pastas serão exibidas em ordem alfabética.

Quando o conteúdo é importado:

  • Ele é transformado em artigos internos nativos que podem ser editados/excluídos dentro do Knowledge no Intercom.

  • O conteúdo será adicionado a uma nova pasta nativa em Knowledge. Pastas nativas podem ser modificadas.

Artigos internos sincronizados ou importados estão disponíveis para Fin Copilot, mas não podem ser publicados no seu Help Center público. A maior parte da formatação será mantida igual à fonte original, incluindo imagens, tabelas, listas e cabeçalhos, mas algumas formatações não são suportadas (por exemplo, citações).


Sincronize ou importe artigos internos

Para sincronizar ou importar novas fontes internas, navegue até Fin AI Agent > Train > Content e selecione Ver tudo na seção "Adicionar conteúdo".

Então selecione a fonte da qual deseja sincronizar/importar.

Você será solicitado a fornecer credenciais para acessar a conta associada do Confluence/Guru/Notion.

Confluence

  1. Abra sua fonte Confluence no Intercom.

  2. Clique em Editar fonte (no menu de três pontos ao lado da fonte).

  3. Siga as etapas Conectar → Metadados → Destino → Revisão.

  4. Configure filtros de metadados, segmentação de público e disponibilidade para Fin AI Agent/Copilot.

  5. Clique em Atualizar e sincronizar.

Nota: Isso funciona para fontes v1 e v2 (fontes com pastas habilitadas). Suas credenciais OAuth existentes são mantidas — você pode ser solicitado a reautenticar se sua conexão expirou. Espaços com permissões restritas podem falhar na sincronização correta. Sempre garanta que a conta de usuário usada para conectar o Confluence tenha permissões adequadas de visualização e acesso para os espaços que pretende sincronizar.

A etapa de Metadados permite pré-filtrar quais páginas entram no Intercom. Para Confluence, os metadados sincronizados como campos estruturados incluem etiquetas, título, página pai, autor e datas de criação/edição. Você pode criar regras de pré-filtragem usando condições de string (é, não é, contém, começa com, termina com) e condições de etiqueta (é, não é).

Solução de problemas de sincronização de espaço Confluence

Ao integrar espaços Confluence com o Intercom, você pode encontrar situações em que certos espaços não estão visíveis ou sincronizando corretamente. Este guia ajuda a diagnosticar e resolver esses problemas comuns.

Verifique o tipo do espaço Confluence ausente

  • No Confluence, navegue até Configurações do espaço > Gerenciar espaço > Detalhes do espaço.

  • Revise o ‘Tipo’ do espaço.

  • O Intercom suporta apenas a sincronização de espaços do tipo ‘global’. Espaços marcados como ‘personal’ ou ‘knowledge_base’ não são incluídos na sincronização.

Crie um novo espaço personalizado (se o tipo não for suportado)

  • Se o espaço Confluence ausente for de um tipo não suportado (por exemplo, ‘personal’ ou ‘knowledge_base’), você pode criar um novo espaço ‘Custom’ para resolver o problema.

  • No Confluence, crie um novo espaço Custom.

  • Transfira o conteúdo do seu espaço não suportado para este novo espaço Custom criado.

Verifique as configurações de visibilidade

  • No Confluence, certifique-se de que o espaço que deseja sincronizar esteja definido com o status ‘current’.

  • Apenas espaços com esse status serão considerados para sincronização com o Intercom.

Solução de problemas de hierarquias de pastas e páginas

  • O Intercom não suporta diretamente pastas dentro do Confluence para fins de sincronização. Em vez disso, ele sincroniza com base em páginas e subpáginas individuais.

  • Para garantir que seu conteúdo seja sincronizado corretamente, estruture-o usando páginas e subpáginas. Se precisar excluir conteúdo específico, mova essas páginas para um espaço Confluence separado que não seja destinado à sincronização com o Intercom.

Se os passos acima não resolverem o problema, pode haver uma configuração específica no backend que precisa ser ativada para seu workspace. Para resolver isso, entre em contato com nossa equipe de Suporte. Ao fazer isso, informe que você já seguiu os passos de solução de problemas. Então, peça para eles verificarem a ativação de quaisquer configurações de backend que possam ajudar a exibir todos os seus espaços Confluence não pessoais, ignorando essas restrições padrão incômodas. Eles são as melhores pessoas para ajudar a fazer tudo funcionar perfeitamente para você.

Nota:

  • A integração do Intercom atualmente suporta apenas Confluence Cloud. Certifique-se de que não está tentando integrar com uma versão on-premises do Confluence.

  • A exclusão de pastas agora é feita via filtros: use o filtro "Página ancestral" para excluir subárvores inteiras de páginas. Se você tinha pastas negadas configuradas antes, elas são automaticamente migradas para regras de filtro na sua próxima sincronização — nenhuma ação é necessária.

  • Não suportamos sincronizações de página única. Apenas a sincronização completa é suportada.

  • Suportamos a sincronização de Pastas, mas não de Whiteboards do Confluence.

Guru

  1. Abra sua fonte Guru no Intercom.

  2. Digite seu e-mail Guru e token API.

  3. Selecione Coleção, Pastas e se deseja importar ou sincronizar o conteúdo.

  4. O banner de status e o ícone de progresso serão exibidos no Knowledge quando a sincronização/importação começar.

  5. Quando a sincronização/importação for concluída, o ícone de status será atualizado para um visto verde.

Dicas:

  • Certifique-se de que você tem as permissões corretas associadas à sua conta Guru e tenha suas credenciais API em mãos ao sincronizar ou importar.

  • As credenciais API podem ser acessadas seguindo as instruções descritas aqui e podem ser encontradas na sua página de configurações. Certifique-se de selecionar o User Token.

Notion

  1. Abra sua fonte Notion no Intercom.

  2. Clique em Editar fonte (no menu de três pontos ao lado da fonte).

  3. Siga os passos Conectar → Metadados → Destino → Revisar.

  4. Configure filtros de metadados, segmentação de público e disponibilidade do Fin AI Agent/Copilot.

  5. Clique em Atualizar e sincronizar.

Nota: Nenhuma migração é necessária para Notion — tudo é tratado implicitamente na sua próxima sincronização. Propriedades dinâmicas são trazidas automaticamente como campos estruturados.


Fluxo de revisão de metadados

As fontes Confluence e Notion usam um fluxo de configuração em quatro etapas que torna transparente como o conteúdo é buscado no Intercom e dá controle sobre o que é importado e onde é usado.

Conectar

Autentique-se na fonte externa. Suas credenciais OAuth existentes são mantidas para fontes Confluence — você pode ser solicitado a reautenticar se a conexão expirou.

Metadados

Escolha qual conteúdo deve estar no escopo usando regras pré-filtro baseadas em metadados da sua knowledge base externa. Metadados típicos incluem:

  • Rótulos ou tags

  • Título

  • Página pai / página ancestral

  • Autor

  • Datas de criação e edição

  • Propriedades dinâmicas (Notion)

Construa regras usando condições de string (é, não é, contém, começa com, termina com) e condições de rótulo (é, não é) para restringir a fatia de conteúdo que será sincronizada — por exemplo, apenas páginas rotuladas "fin-ai", ou apenas conteúdo atualizado após uma certa data.

Dica: Se você pular a etapa de Metadados, o importador trará todo o conteúdo elegível da fonte por padrão.

Destino

Decida onde o conteúdo importado será usado dentro do Intercom. Configure:

  • Fin AI Agent — use o conteúdo para responder automaticamente às perguntas dos clientes (padrão DESLIGADO)

  • Copilot — disponibilize o conteúdo para colegas como respostas sugeridas

  • Segmentação de público — defina regras de público no nível da fonte, aplicadas automaticamente na importação

Revisar

Confirme sua configuração antes de iniciar a sincronização. A revisão mostra:

  • Detalhes da conexão (qual conta externa ou subdomínio você está conectado)

  • Itens no escopo após aplicar filtros de Metadados

  • Destinos habilitados em Destino

  • Regras de público e segmentação

Dê um nome claro à fonte antes de confirmar — por exemplo, "Confluence – Internal Support KB" ou "Notion – Product Docs (EMEA)". Então clique em Atualizar e sincronizar.

Dica: Você pode reabrir o mesmo fluxo depois para ajustar as configurações de Metadados, Destino ou Revisão sem recriar a fonte.


Gerencie artigos internos sincronizados ou importados

Quando a sincronização ou importação for concluída, você receberá uma notificação por e-mail e os artigos internos aparecerão em uma pasta em Knowledge > Content.

Configure as configurações

Se você abrir um artigo interno em Knowledge, poderá visualizar o conteúdo desse artigo e configurar as configurações no painel "Detalhes" à direita:

  • Dados: Veja o tipo de conteúdo, idioma, data de criação, criado por, última atualização e o colega que atualizou por último.

  • Fin: Para ativar/desativar para Fin e Copilot. Quando ativado, o conteúdo fica disponível para clientes através do Fin AI Agent e para colegas via Copilot, respectivamente.

    • Público: Garanta que os clientes recebam apenas respostas e vejam conteúdo relevante para eles quando Fin ou Copilot responderem.

  • Tags: Adicione uma tag para agrupar artigos internos e manter o conteúdo organizado.

  • Pasta: Adicione o artigo a uma pasta relevante no Knowledge para manter o conteúdo organizado. Artigos sincronizados já pertencem à pasta da fonte e não podem ser movidos.

Nota:

  • Artigos internos sincronizados ficarão dentro de uma pasta sincronizada que não pode ser editada. Se quiser fazer alterações na pasta, será necessário fazer isso na própria fonte.

  • Artigos e pastas internas importados podem ser editados e gerenciados dentro do Knowledge. Eles não serão sincronizados com a fonte, então quaisquer alterações que você quiser fazer precisam ser feitas dentro do Knowledge.

Tornar disponível para Fin

Para tornar um artigo interno disponível para Fin Copilot, vá para Knowledge e então abra o artigo.

No painel "Detalhes" , role para baixo até “Fin” e ative a opção:

  • Fin Copilot - Esta configuração tornará o trecho disponível para o Fin Copilot usar ao responder aos colegas de equipe.

Re-sincronizar ou remover fontes

As fontes serão sincronizadas automaticamente a cada 24 horas, mas você pode re-sincronizar ou remover uma fonte manualmente indo para Fin AI Agent > Train > Content e então selecione o menu de 3 pontos ao lado de uma fonte para re-sincronizar ou removê-la.

Importar conteúdo sincronizado

Você também pode decidir importar artigos internos que você já sincronizou com uma fonte externa (Confluence/Guru/Notion) se preferir gerenciar o conteúdo no Intercom (reestruturar, editar, etc.)

Vá para Fin AI Agent > Train > Content e então selecione o menu de 3 pontos ao lado de uma fonte e clique em Import content.

Importante:

  • Uma vez que você decidir importar completamente os artigos internos, a conexão com a fonte externa será cortada. A fonte não será mais visível, e o conteúdo será movido de pastas sincronizadas para pastas não sincronizadas no Intercom.

  • Não há como recriar essa sincronização nessas pastas e conteúdos específicos. A fonte terá que ser criada como uma nova sincronização seguindo o processo original novamente, o que criará um conjunto totalmente novo de pastas e conteúdos sincronizados, sem qualquer ligação com as pastas importadas.

Respondeu à sua pergunta?