Adicione documentos ao conhecimento do Captain

Pranav

Pranav

Última atualização em Oct 21, 2026

Descobrir

Os documentos ensinam seu assistente sobre o seu produto. Adicione páginas de sites ou arquivos PDF, e o Captain irá lê-los, responder com base neles e criar FAQs a partir deles.

Plano & acesso: Startups, Business ou Enterprise Preços & Planos. Administradores podem adicionar, atualizar e excluir documentos. Todo plano pago inclui até 2.000 documentos. O limite é compartilhado por todos os assistentes da conta, e cada PDF ou página rastreada conta como um documento.

Configurar & testar

Antes de começar

  • Um assistente. Veja Configure um assistente Captain e conecte suas caixas de entrada.

  • As páginas do site devem ser públicas. O Captain não consegue ler páginas protegidas por login.

  • Os PDFs devem ter até 10MB e conter texto real (imagens escaneadas podem não ser lidas).

  • Se seu site bloqueia rastreadores no robots.txt, permita o Chatwoot primeiro (abaixo).

Adicionar um site ou PDF

  1. Acesse Captain > Documentos.

  2. Clique em Criar novo documento.

  3. Escolha o Tipo de Documento:

    • URL: insira o endereço da página. O Captain lê essa página e as páginas vinculadas sob o mesmo caminho. Por exemplo, https://example.com/help cobre todas as páginas que começam com esse endereço.

      • Arquivo PDF: clique em Escolher arquivo PDF e selecione o arquivo.

  4. Opcional: adicione um Nome do Documento (Opcional).

  5. Escolha o assistente e clique em Criar.

O Captain lê e indexa o conteúdo. As páginas encontradas durante o rastreamento são adicionadas como documentos separados.

Permita que o Chatwoot rastreie seu site

O Chatwoot usa Firecrawl para ler sites e respeita o seu robots.txt. Se algumas páginas estiverem bloqueadas, adicione isto em https://seudominio.com/robots.txt:

User-agent: FirecrawlAgent
Allow: /

Verifique se o arquivo está acessível nesse endereço e depois adicione ou atualize o documento.

Se o seu robots.txt bloquear o rastreador ao adicionar um site, nenhuma página será adicionada e nenhum erro será mostrado. O assistente poderá então dar respostas incompletas ou genéricas.

Teste

  1. Abra o menu do documento e escolha Ver detalhes.

  2. Verifique se Conteúdo rastreado (ou Detalhes do PDF) mostra seu texto, e se as FAQs relacionadas listam perguntas pertinentes.

  3. Envie uma pergunta dessa página no Playground do assistente.

Aproveitar ao máximo

  • Mantenha os documentos atualizados: use Atualizar agora em um documento, ou selecione vários e clique em Atualizar. A lista mostra quando cada um foi atualizado pela última vez.

  • Documentos de sites também são atualizados automaticamente: mensalmente no Startups (dia 1), semanalmente no Business (aos domingos) e diariamente no Enterprise. O processamento pode levar mais tempo, então uma página pode não ser atualizada exatamente nesse horário. PDFs enviados não são atualizados automaticamente.

  • Um rastreamento de site adiciona até 500 páginas, e nunca mais do que o total restante do seu limite de documentos.

  • Prefira fontes focadas, como o seu centro de ajuda, em vez de todo o site institucional.

  • Usado em conversas mostra quais conversas usaram um documento.

  • Excluir um documento remove tudo que o Captain aprendeu com ele.

  • Artigos do Centro de Ajuda não são lidos automaticamente. Para usá-los, adicione o endereço do seu Centro de Ajuda como um documento de URL. Cada versão de idioma de um artigo é uma página separada, então cada uma conta como um documento.

  • FAQs criadas a partir de um documento entram no ar imediatamente. Elas aparecem em FAQs e não precisam de aprovação.

  • FAQs que o Captain gera sempre usam o idioma da sua conta. O assistente ainda irá responder no idioma do cliente.

  • O Captain não remove detalhes pessoais ou confidenciais do que você adiciona. Só adicione conteúdo que você autoriza o assistente a citar para clientes.

Solução de problemas

Sintoma Possível causa O que fazer
Status exibe Falha ao sincronizar com Acesso negado A página precisa de login, ou seu site bloqueou o pedido (erro 401 ou 403). Torne a página pública, ou permita o acesso no seu site.
Adicionou um site mas nenhuma página aparece, ou respostas genéricas Seu robots.txt pode estar bloqueando o rastreador. Permita como mostrado em Permita que o Chatwoot rastreie seu site, então adicione novamente.
Página não encontrada URL está incorreta ou a página foi movida Corrija a URL e adicione novamente
Página demorou demais para responder Seu site estava lento Use Tentar atualizar depois
Página retornou conteúdo vazio Conteúdo só carrega com scripts, ou a página está vazia Use uma página com texto simples ou envie um PDF
atualização travada Uma atualização não finalizou Use Tentar atualizar
Detalhes do PDF informam que não foi possível extrair conteúdo legível PDF é escaneado ou só imagem Faça upload de um PDF com texto
Banner: Limite de documentos atingido A conta possui 2.000 documentos entre todos os assistentes Exclua documentos desnecessários ou veja Preços & Planos

Mais motivos: Solução de problemas com o Captain.