Nevolus IA – Importação de WordPress

PorNevolus

Índice

Importação de WordPress

A Importação de WordPress permite trazer posts e páginas publicados de outro site WordPress para a base de conhecimento da Nevolus IA.

Os conteúdos importados são criados como artigos privados no ambiente Nevolus e podem ser usados pelos chatbots para responder com base no conteúdo do site de origem.

O recurso usa a REST API pública padrão do WordPress. Não é necessário instalar plugins no site de origem, desde que a API esteja disponível publicamente.

Quando usar este recurso

Use a Importação de WordPress quando o site de origem for WordPress e você quiser importar posts, páginas ou áreas específicas, com atualização periódica.

Exemplos:

  • importar páginas institucionais;
  • importar artigos de uma central de ajuda;
  • manter uma base de conhecimento sincronizada com um blog WordPress;
  • importar somente posts ou somente páginas;
  • limitar a importação a uma área, como /documentacao/ ou /suporte/.

Para importar conteúdos de sites que não são WordPress ou que não disponibilizam a REST API pública, use o recurso Importação de Sites.

Antes de começar

Você precisa de:

  1. Permissão para gerenciar configurações no WordPress.
  2. Um site WordPress de origem acessível publicamente.
  3. REST API pública habilitada no site de origem.
  4. Posts ou páginas publicados na origem.

A importação não usa login, senha ou token do WordPress de origem. Por isso, ela só consegue ler conteúdos publicados e expostos pela REST API pública.

Não são importados:

  • rascunhos;
  • conteúdos privados ou protegidos por senha;
  • tipos de conteúdo personalizados;
  • mídia isolada, comentários, usuários, categorias ou tags;
  • conteúdos de outro domínio.

Acessando a Importação de WordPress

No painel da Nevolus IA, abra Chatbots > Recursos adicionais e, na seção Conteúdo e base de conhecimento, selecione Importação de WordPress.

Criando uma fonte WordPress

Na seção Nova fonte WordPress, preencha os campos abaixo.

Nome

Use um nome interno que facilite identificar a origem.

Exemplo:

Base de conhecimento – Site institucional

URL do site WordPress

Informe a URL inicial do site de origem.

Exemplo: https://www.seu_site_wordpress

A URL precisa ser pública e usar HTTP ou HTTPS.

Conteúdo

Escolha os tipos de conteúdo que deseja importar:

  • Posts
  • Páginas

Você pode selecionar apenas um tipo ou os dois.

Limite de itens

Define o número máximo de posts e páginas processados em uma execução.

O padrão é 300 itens e o limite máximo atual é 1.000 itens.

Para a primeira importação, comece com um limite menor, como 50 ou 100, revise o resultado e aumente gradualmente se necessário.

Tamanho do lote

Define quantos itens são enviados por vez durante a execução.

O valor padrão é 50 e o máximo é 100.

Normalmente, mantenha o valor padrão. Diminua-o se o site de origem for lento ou se houver falhas de processamento.

Include paths

Campo opcional. Use um padrão por linha para importar somente URLs de determinadas áreas do site.

Exemplo:

/documentacao/*
/suporte/*

Quando este campo estiver preenchido, somente URLs que correspondam a pelo menos um dos padrões serão importadas.

Exclude paths

Campo opcional. Use um padrão por linha para bloquear URLs que não devem entrar na base de conhecimento.

Exemplo:

/tag/*
/categoria/*
/autor/*
/wp-json/*
*.pdf

Use este campo para evitar páginas de arquivo, áreas irrelevantes, documentos ou conteúdos duplicados.

Testando a conexão

Depois de criar a fonte, clique em Testar conexão.

O sistema verifica se consegue acessar a REST API do site de origem e exibe uma estimativa de:

  • quantidade de posts;
  • quantidade de páginas.

Faça esse teste antes da primeira importação.

Se o teste falhar, verifique se a URL está correta e se o site de origem permite acesso público a endereços como:

https://www.exemplo.com/wp-json/wp/v2/posts
https://www.exemplo.com/wp-json/wp/v2/pages

Alguns plugins de segurança, firewalls, serviços de CDN ou configurações de servidor podem bloquear a REST API. Nesses casos, peça ao responsável pelo site de origem para liberar o acesso público de leitura à API do WordPress.

Executando uma importação

Na tabela Fontes cadastradas, você encontrará duas opções.

Executar incremental

Importa conteúdos criados ou modificados desde a última execução concluída.

A importação incremental pode:

  • criar novos artigos;
  • atualizar artigos que foram alterados na origem;
  • recriar um artigo importado que tenha sido apagado localmente.

Ela não remove conteúdos que deixaram de existir no site de origem.

Executar varredura completa

Lê novamente todos os posts e páginas definidos na fonte, respeitando o limite de itens e os filtros configurados.

Use a varredura completa para:

  • fazer a primeira importação;
  • revisar conteúdos existentes;
  • detectar conteúdos removidos da origem;
  • executar a sincronização de remoções, quando ela estiver habilitada.

Depois de iniciar uma execução, acompanhe o resultado na tabela Execuções recentes.

A importação é processada por um serviço operacional da Nevolus. Se uma execução permanecer em queued ou dispatching por muito tempo, entre em contato com o suporte técnico.

Recorrência

Recorrência incremental

As opções são:

  • Manual
  • Diária incremental

A opção diária verifica aproximadamente uma vez por dia conteúdos novos ou modificados desde a última execução concluída.

Varredura completa

As opções são:

  • Manual
  • Semanal
  • Mensal

Quando uma varredura completa estiver vencida, ela terá prioridade sobre uma execução incremental diária.

Sincronizar em varreduras completas

Quando esta opção estiver ativada, o sistema identifica itens que desapareceram do site de origem.

A proteção funciona assim:

  1. Na primeira varredura completa em que um item não for encontrado, ele recebe o status missing.
  2. Se continuar ausente na próxima varredura completa com sincronização, o artigo local correspondente é movido para a lixeira.

Para reduzir o risco de remoções acidentais, a sincronização é ignorada quando a execução encontrar menos de 50% dos itens já conhecidos da fonte, desde que existam mais de três itens conhecidos.

Ative a sincronização somente depois de conferir a URL, os filtros e a primeira importação.

Entendendo as execuções

A tabela Execuções recentes apresenta:

  • Vistos: itens avaliados pelo sistema.
  • Importados: artigos criados ou atualizados.
  • Alterados: itens cujo conteúdo foi criado ou atualizado.
  • Ignorados: itens sem alteração, fora dos filtros ou que não podem ser importados.
  • Falhas: itens que não puderam ser processados.

Os principais status são:

  • queued: execução criada e aguardando o processamento.
  • dispatching: execução foi assumida pelo serviço de importação e está sendo iniciada.
  • running: importação em andamento.
  • completed: execução concluída sem falhas registradas.
  • completed_with_errors: execução concluída, mas uma ou mais páginas falharam.
  • failed: a execução não pôde ser concluída.

Para ver detalhes, clique em Log.

Visualizando os itens importados

Na tabela Fontes cadastradas, clique em Itens.

A tela mostra:

  • o artigo local correspondente;
  • o tipo e o identificador remoto;
  • o título;
  • a URL de origem;
  • o status;
  • a data de modificação no site remoto;
  • a última vez em que o item foi visto;
  • a data da última importação;
  • erros registrados, quando houver.

Os status possíveis são:

  • active: item importado corretamente.
  • missing: item não foi encontrado na última varredura completa com sincronização.
  • removed: artigo local movido para a lixeira após duas varreduras completas consecutivas sem localizar o item remoto.
  • failed: ocorreu uma falha ao importar ou atualizar o item.

Como o conteúdo é importado

O sistema converte o conteúdo HTML do site de origem em texto adequado para a base de conhecimento.

Em cada artigo importado, ele preserva:

  • título;
  • conteúdo principal em texto;
  • link da fonte original.

Elementos como scripts, estilos e conteúdos não textuais não são preservados como parte do artigo.

Os artigos são privados e identificados como conteúdos gerenciados pela importação.

Evite editar manualmente esses artigos: uma futura atualização da origem poderá substituir suas alterações.

Excluindo uma fonte

Na tabela Fontes cadastradas, clique em Excluir.

A fonte será removida da lista de fontes ativas, mas os artigos já importados não serão apagados automaticamente.

Se precisar remover conteúdos antigos, revise os artigos importados no WordPress e exclua-os manualmente.

Boas práticas

  • Faça o teste de conexão antes da primeira execução.
  • Comece com um limite baixo de itens.
  • Faça a primeira importação com varredura completa.
  • Revise os artigos importados antes de aumentar o limite.
  • Use Include paths para restringir a importação a áreas úteis para o chatbot.
  • Use Exclude paths para evitar arquivos, páginas de arquivo e conteúdos irrelevantes.
  • Habilite a sincronização somente após validar o resultado da importação.
  • Use varreduras completas periódicas para manter a base atualizada.
  • Consulte o log sempre que houver falhas.

Limitações conhecidas

  • O site de origem precisa disponibilizar a REST API pública do WordPress.
  • Apenas posts e páginas publicados são importados.
  • Tipos de conteúdo personalizados não são importados nesta versão.
  • Conteúdos protegidos por login, senha ou bloqueios de segurança não podem ser lidos.
  • Sites muito grandes podem exigir filtros e limites menores para uma importação segura.
  • Alterações feitas diretamente em artigos importados podem ser substituídas por futuras sincronizações.

Posts Similares