Se você deseja adicionar conteúdo de sites ao Intercom e torná‑lo disponível para Fin AI Agent e Copilot, você pode fazê‑lo sincronizando a URL pública do seu site. Você também pode treinar Fin e Copilot com conteúdo de posts de blog, changelogs, atualizações de notícias ou quaisquer outras páginas da web com datas. Isso garante que Fin e Copilot usem sempre as informações mais atualizadas e relevantes dessas fontes.

Vá para Fin AI Agent > Train > Content, depois selecione Website sync em “Add content.”

Agora insira a URL do seu conteúdo de suporte externo (domínio de nível superior) e clique em Next:

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

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

Selecione o dropdown Advanced settings para configurar URLs adicionais, excluir URLs, seletores CSS para excluir e mais.

A estrutura dos websites pode 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 a URL principal acima, você também pode querer adicionar a URL específica como https://myhelpcenter.com/help/index.html

Para excluir determinadas 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 usada para corresponder 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 gama de URLs que são em sua maioria 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, scripts e imagens inline.

Isso permite que elementos do DOM identificados pelo seletor CSS sejam clicados durante o processo de sincronização da 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 semelhante a AND, por exemplo .button.blue.small corresponderá apenas a elementos com as três classes.

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

Para direcionar conteúdo que pode ter um atraso em aparecer na página, você pode adicionar um seletor CSS que fará o scraper da web aguardar antes de raspar o conteúdo.

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

Ative o XML Sitemap para uma websync mais robusta em sites que suportam sitemap, permitindo o acesso a páginas que podem não ser alcançáveis a partir das URLs iniciais.

Se esta opção estiver ativada, o scraper da 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 Start URL, por exemplo https://www.example.com/sitemap.xml.

Você pode selecionar um proxy para o crawler usar se precisar que seu website 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 rastreador renderiza cada página ao sincronizar este site.

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

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

Há dois toggles adicionais em Advanced settings. Ambos estão desativados por padrão.

Respect robots.txt: faz o rastreador 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 rastreadores alcancem. Se o robots.txt impedir caminhos que contenham conteúdo que você deseja no Fin, isso reduzirá o que é sincronizado.

Exclude query parameters: 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.

Em seguida, 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 fica definido como 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:

Por fim, 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.

Uma vez que 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 "Details" à direita que contém:

Para tornar uma fonte do 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 nas páginas 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 segmentar.

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 nas páginas 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 desejar re-sincronizar ou remover uma URL pública como fonte, vá para Fin AI Agent > Train > Content e selecione a fonte. Em seguida, clique no menu de configurações no canto superior direito e selecione Re-sync ou Remove this source.

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

Você pode ver uma lista de sincronizações de sites passadas para ver 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 cursor 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, ela continua sincronizando automaticamente se qualquer uma das condições for verdadeira:

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

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

To restore it: O botão Sync now atualiza o conteúdo uma vez, mas não reinicia o cronograma. A sincronização automática retoma por si só quando o Fin voltar a usar a fonte.

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, nós a movemos de uma programação semanal para uma programação de every 14 days.

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

Ao importar conteúdo do site para habilitar o Fin, você precisa inserir a public URL. Isso pesquisará 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 então pesquisando todas as páginas aninhadas sob essa URL. Essas páginas devem ter o mesmo padrão de URL que a URL que você fornece.

Por exemplo, se o domínio de nível superior 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 de URL mais básico, por exemplo https://myhelpcenter.com, então tente a importação novamente.

Se o conteúdo que você quer usar estiver protegido por login, Fin não poderá acessá-lo ou importá-lo.

A sincronização de sites 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 email sempre que uma sincronização falhar.

A sincronização de sites da Intercom (usada para adicionar URLs públicas para Fin AI Agent e Copilot) não utiliza uma string de user-agent dedicada e personalizada no momento.

Para identificar ou permitir essas requisições:

Se seu sitemap inclui 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 de sitemaps agora suporta essas URLs, mas elas ainda podem ter problemas em outras partes do processo de sincronização. Tente ressincronizar manualmente para resolver. Se as páginas ainda estiverem ausentes, entre em contato com o suporte.

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

Isto é o que cada um significa e o que você pode fazer a seguir:

A sincronização de páginas 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 habilitada para Fin e Copilot.
​

Essas páginas não são sincronizadas intencionalmente porque você as excluiu nas suas configurações de sincronização. Elas não são reexecutáveis e não podem ser incluídas, salvo indicação em contrário.

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

1. Unknown error

2. Session blocked / Rate limited

3. Network, timeout, or similar errors

4. Duplicate

5. Keyword filtering

6. Status code 400

7. URL Bloqueada

​Você pode tentar novamente uma sincronização de página que falhou passando o cursor sobre a página, selecionando o menu de três pontos e então selecionando Resync.