Se você quiser adicionar conteúdo do site ao Intercom e torná-lo disponível para Fin AI Agent e Copilot, pode fazer isso sincronizando a URL pública do seu site. Você também pode treinar Fin e Copilot com conteúdo de postagens de blog, changelogs, atualizações de notícias ou qualquer outra página da web com datas. Isso garante que Fin e Copilot sempre usem as informações mais atualizadas e relevantes dessas fontes.

Vá para Fin AI Agent > Treinar > Conteúdo, depois selecione Sincronização de site em “Adicionar conteúdo.”

Agora insira a URL do seu conteúdo de suporte externo (top-level domain) e clique em Próximo:

Isso buscará todas as páginas do URL do site que você fornecerá e lerá todas as páginas do subdomain.

Depois de inserir sua URL, verificaremos se ela é válida e acessível. Em seguida, você precisará revisar as páginas para sincronizar. Todas as subpáginas vinculadas em cada seção selecionada serão sincronizadas. Selecione apenas conteúdo relevante e atualizado.

Selecione o menu suspenso Configurações avançadas para configurar URLs adicionais, excluir URLs, seletores CSS para excluir e mais.

As estruturas dos sites podem variar. Para garantir que sincronizemos seu conteúdo mais relevante, recomendamos adicionar URLs adicionais para essas subpáginas específicas.

Por exemplo, se você inserir https://myhelpcenter.com/help como URL principal acima, talvez queira adicionar também a URL específica como https://myhelpcenter.com/help/index.html

Para excluir certas páginas das quais você não deseja sincronizar conteúdo, você pode adicionar uma lista de globs de URL.

Um glob é uma sequência de caracteres literais e/ou curingas usados para corresponder a caminhos de arquivos ou URLs. Globbing é o ato de localizar arquivos em um sistema de arquivos usando um ou mais globs. Usar globs de URL também ajuda a obter uma variedade de URLs que são quase iguais, com apenas uma pequena parte mudando entre as requisições.

Por exemplo, este glob de URL https://{store,docs}.example.com/** permite que o rastreador acesse todas as URLs que começam com https://store.example.com/ ou https://docs.example.com/ e https://example.com/**/*\?*foo=*

Para excluir certos elementos da página, você pode usar seletores CSS dessas seções ou elementos específicos que deseja excluir.

Isso é útil para pular conteúdo irrelevante da página. O valor deve ser um seletor CSS válido aceito pela função document.querySelectorAll(). Por padrão, já removemos elementos comuns de navegação, cabeçalhos, rodapés, modais e scripts.

Isso permite que elementos DOM identificados pelo seletor CSS sejam clicados durante o processo de sincronização web.

Isso é útil para expandir seções recolhidas, a fim de capturar seu conteúdo de texto. O valor deve ser um seletor CSS válido aceito pela função document.querySelectorAll().

Exemplos são "[aria-expanded=\"false\"]", #expand_section

Condições complexas também podem ser descritas com um seletor CSS. Em CSS, encadear seletores sem espaços cria uma condição do tipo E, por exemplo .button.blue.small corresponderá apenas a elementos com as três classes.

Usar vírgula (,) como separador funciona como OU, por exemplo .button, .blue, h1 seleciona todos os elementos com a classe button, ou a classe blue, ou cabeçalhos de primeiro nível.

Para direcionar conteúdo que pode demorar a aparecer na página, você pode adicionar um seletor CSS que fará o scraper web esperar antes de capturar o conteúdo.

Isso é útil para páginas nas quais o reconhecimento padrão de carregamento de conteúdo por rede ociosa falha. Configurar esta opção desativa completamente o comportamento padrão, e a página será processada somente se o elemento especificado por este seletor aparecer.

Ative o Mapa do site XML para uma sincronização web mais robusta em sites que suportam sitemap, permitindo acesso a páginas que podem não ser alcançáveis pelas URLs iniciais.

Se esta opção estiver ativada, o scraper web procurará Sitemaps nos domínios da URL de origem fornecida e enfileirará URLs correspondentes de forma semelhante aos links encontrados nas páginas rastreadas. Você também pode referenciar um arquivo sitemap.xml diretamente adicionando-o como outra URL inicial, por exemplo https://www.example.com/sitemap.xml.

Você pode selecionar um proxy para o rastreador usar se precisar que seu site seja rastreado com um proxy configurado para uma região ou país específico.

Atualmente, suportamos os seguintes proxies:

Escolha com que profundidade o crawler renderiza cada página ao sincronizar este site.

Quando ativado, o web scraper ignora as tags de link canônico (rel="canonical") e trata cada URL como uma página distinta. Esta opção está desativada por padrão.

Isso é útil quando um site aponta muitas páginas para uma URL canônica e o conteúdo está sendo perdido como resultado.

Existem dois outros interruptores em Configurações avançadas. Ambos estão desligados por padrão.

Respeitar robots.txt: faz o crawler obedecer às regras de disallow no robots.txt do seu site. Ative para manter a sincronização consistente com o que você permite que outros crawlers alcancem. Se o robots.txt proibir caminhos que contenham conteúdo que você deseja no Fin, isso reduzirá o que é sincronizado.

Excluir parâmetros de consulta: pula qualquer URL com uma string de consulta (?). Ative quando seu site adiciona parâmetros de rastreamento, sessão ou ordenação que produzem muitas páginas quase duplicadas. Deixe desativado se conteúdo real estiver atrás de uma string de consulta, como /docs?page=intro — essas páginas também seriam puladas.

A etapa Target permite definir um público padrão para todas as páginas sincronizadas e criar regras baseadas em URL para atribuir automaticamente públicos específicos com base em padrões de URL — sem necessidade de marcação manual.

Primeiro decida se o conteúdo desta fonte está habilitado para Fin AI Agent e/ou Copilot.

Então você pode definir um público Fin padrão para aplicar a todas as páginas sincronizadas desta fonte (se nenhum padrão for definido, o conteúdo padrão é Everyone), ou criar regras para atribuir públicos específicos com base em padrões de URL.

Por exemplo: Se a URL contiver /uk, atribua o público do Reino Unido. As regras são avaliadas durante a sincronização, então Fin e Copilot sempre servem o conteúdo certo para o público certo.

Cada regra suporta três comparadores de URL:

Finalmente, revise suas configurações de sincronização e clique em Sync website para começar a sincronizar o conteúdo do seu site com o Intercom.

Quando a sincronização for concluída, você receberá uma notificação por e-mail e o site aparecerá como uma fonte sincronizada em Fin AI Agent > Train > Content.

Vá para Fin AI Agent > Train > Content, selecione a fonte do site e clique em uma página que você sincronizou. Você encontrará um painel "Detalhes" à direita que contém:

Para tornar uma fonte de site disponível para Fin AI Agent e/ou Copilot, vá para Fin AI Agent > Train > Content e selecione a fonte do site, depois clique na(s) página(s) ao vivo que você sincronizou e selecione Change AI Agent state > Enable for AI Agent ou Change Copilot state > Enable for Copilot.

Você também pode gerenciar essas configurações a partir de uma página individual no painel "Details" , role para baixo até as configurações Fin e escolha se deseja ativar:

Você pode atribuir públicos ao conteúdo sincronizado automaticamente usando regras baseadas em URL durante a criação da sincronização web, ou manualmente por página. Primeiro, você precisará criar e definir o público que deseja atingir.

Para atribuir um público manualmente a páginas individuais, vá para Fin AI Agent > Train > Content e selecione a fonte do site, depois clique na(s) página(s) ao vivo que você sincronizou e selecione More actions > Change Fin audience.

Você não precisa recriar uma sincronização para adicionar segmentação de público. Vá para Fin AI Agent > Train > Content, selecione a fonte, clique no menu de configurações no canto superior direito e selecione Open settings. Navegue até a etapa Target para adicionar ou editar regras baseadas em URL.

Se você quiser re-sincronizar ou remover uma URL pública como fonte, vá para Fin AI Agent > Train > Content e selecione a fonte. Então clique no menu de configurações no canto superior direito e selecione Re-sync ou Remove this source.

Se você quiser ajustar as configurações avançadas para uma sincronização de site, vá para Fin AI Agent > Train > Content e selecione a fonte. Então clique no menu de configurações no canto superior direito e selecione Open settings.

Você pode ver uma lista das sincronizações passadas do site para saber quando foram executadas pela última vez, quais páginas foram encontradas e quaisquer páginas com falha. Vá para Fin AI Agent > Train > Content e selecione a fonte do site, depois clique no menu de configurações no canto superior direito e selecione View sync history.

Cada linha na tabela representa uma execução passada ou ativa, e você pode filtrar as execuções por status. Inclui as seguintes informações:

Se uma sincronização falhou, você pode passar o mouse sobre o status para ver uma explicação detalhada do motivo.

Uma nova fonte sincroniza conforme o cronograma pelos primeiros 90 dias, independentemente. Depois disso, continua sincronizando automaticamente se uma das condições for verdadeira:

Caso contrário, as sincronizações agendadas pausam.

Quando pausado: as páginas permanecem no seu Knowledge Hub e continuam disponíveis para Fin e Copilot (nada é excluído). Apenas a revarredura para, então edições no seu site não serão captadas.

Para restaurar: O botão Sync now atualiza o conteúdo uma vez, mas não reinicia o cronograma. A sincronização automática retoma sozinha assim que Fin usar a fonte novamente.

Sites muito grandes e sites que precisam de renderização completa de JavaScript custam muito mais para rastrear. Quando uma fonte se mostra pesada em recursos, movemos ela de um cronograma semanal para um cronograma de 14 em 14 dias.

Isso acontece automaticamente, por fonte. Para manter um site grande em um cronograma mais rápido, restrinja o rastreamento usando exclusões de URL, ou adicione subpáginas específicas em vez de um domain inteiro.

Ao importar conteúdo do site para habilitar o Fin, você precisa inserir a public URL. Isso buscará todas as páginas aninhadas sob essa URL e as sincronizará para o Fin AI Agent usar.

Se o importador não retornou o número de páginas que você esperava, há algumas razões...

A sincronização do site funciona indo até a URL que você fornece e depois buscando todas as páginas aninhadas sob essa URL. Essas páginas devem ter o mesmo padrão de URL que a URL que você forneceu.

Por exemplo, se o top level domain for https://myhelpcenter.com/home, então todas as páginas que você deseja importar devem incluir o prefixo /home na URL, por exemplo, https://myhelpcenter.com/home/article. Se não incluírem, remova o prefixo e use o tronco da URL mais básico, por exemplo, https://myhelpcenter.com, e tente importar novamente.

Se o conteúdo que você deseja usar estiver atrás de um login, Fin não poderá acessá-lo ou importá-lo.

A sincronização do site tem dois limites:

Uma sincronização também pode falhar se uma única página contiver uma quantidade muito grande de conteúdo. Você será notificado por e-mail sempre que uma sincronização falhar.

A sincronização do site do Intercom (usada para adicionar URLs públicas para Fin AI Agent e Copilot) não usa uma string de user-agent dedicada e personalizada neste momento.

Para identificar ou permitir essas solicitações:

Se seu sitemap incluir URLs com caracteres não ASCII (como letras acentuadas ou scripts como chinês ou árabe), algumas dessas páginas podem não sincronizar como esperado. A descoberta do sitemap agora suporta essas URLs, mas ainda podem ocorrer problemas em outras partes do processo de sincronização. Tente sincronizar manualmente para resolver. Se as páginas ainda estiverem faltando, entre em contato com o suporte.

Quando você sincroniza conteúdo, pode ver diferentes status que indicam o que aconteceu durante o processo. Para ver o status da sincronização do seu site, vá para Fin AI Agent > Train > Content e selecione a fonte do site, depois use o menu suspenso Status para filtrar por:

Aqui está o que cada um significa e o que você pode fazer a seguir:

A sincronização da página ainda está em andamento. Uma sincronização inicial pode levar de alguns minutos a mais de uma hora, dependendo da quantidade de conteúdo que você tem.

A página foi sincronizada com sucesso e pode ser ativada para Fin e Copilot.
​

Essas páginas não são sincronizadas intencionalmente porque você as excluiu em suas configurações de sincronização. Elas não podem ser incluídas nem tentadas novamente, a menos que especificado de outra forma.

Esses erros significam que a sincronização não foi concluída e podem exigir alterações do seu lado antes de tentar novamente:

1. Erro desconhecido

2. Sessão bloqueada / Limite de taxa

3. Erros de rede, timeout ou similares

4. Duplicado

5. Filtragem por palavra-chave

6. Código de status 400

7. URL bloqueada

​Você pode tentar sincronizar novamente uma página com falha passando o mouse sobre a página, selecionando o menu de três pontos e depois escolhendo Resync.