Conhecimento do bot

A base de conhecimento é o que o bot consulta para responder dúvidas: horário de funcionamento, políticas, produtos, preços, novidades. Ela tem duas origens: o que você cadastra manualmente e o que importa de fontes que se atualizam sozinhas.

Tudo fica em Mais → Automação → Bot, nas abas Base de conhecimento e Fontes.

Cadastrar conhecimento manualmente

Em Base de conhecimento, toque em Novo item e escolha o tipo:

• FAQ: uma pergunta e a resposta.
• Texto: um título e um conteúdo livre (por exemplo, a política de cancelamento).
• Produto/Serviço: nome, descrição e preço opcional.
• Arquivo: arraste um arquivo (máximo de 5 MB). Ele é processado e pode ser ativado ou desativado.

Cada item tem um interruptor Ativo: o bot só usa os ativos. Você pode buscar e filtrar por tipo.

Fontes: o que se atualiza sozinho

Em Fontes, toque em Adicionar fonte e escolha o tipo. O sistema importa em poucos minutos e atualiza sozinho; você pode mudar a frequência (a cada hora, 6 horas, dia ou semana), Atualizar agora, Pausar e Retomar. Cada cartão mostra o estado: Na fila, Em dia, Com erro ou Pausada. Uma fonte que falha várias vezes seguidas pausa sozinha. Se você a apagar, os itens importados dela também saem (os escritos à mão não são tocados).

Regras comuns: apenas endereços públicos http(s), até 2 MiB por fonte e 10 fontes por projeto. Páginas que exigem login não são lidas, e o robots.txt do site é respeitado.

Uma página web

1. Adicionar fonte → Página web, alcance Página.
2. Digite a URL pública (por exemplo, sua página de preços).
3. O texto da página é lido, sem executar JavaScript.

Uma seção do seu site

Para o bot aprender várias páginas de um mesmo site, sem cadastrá-las uma a uma:

1. Adicionar fonte → Página web, alcance Seção do site.
2. Digite o prefixo, por exemplo https://seusite.com/ajuda.
3. Escolha o máximo de páginas (50 por padrão, até 200).

O sistema lê o sitemap.xml do domínio e pega só as páginas do mesmo site que começam com esse prefixo. A cada atualização, adiciona as páginas novas, atualiza as que mudaram e arquiva as que sumiram. O cartão mostra "N páginas importadas" e Ver páginas lista cada uma com seu estado (Importada ou Arquivada).

Uma lista: planilha, CSV, JSON ou RSS

Serve para produtos, preços ou novidades que você já mantém em uma planilha, uma loja ou um feed.

1. Adicionar fonte e escolha Planilha, CSV, API JSON ou RSS.
2. Cole o link. Para uma planilha do Google: Arquivo → Compartilhar → Publicar na Web, ou deixe visível para qualquer pessoa com o link; a primeira linha deve ter cabeçalhos.
3. Em Mapeamento de campos, escreva qual coluna alimenta cada campo: Nome (obrigatório), Descrição, Preço, Categoria, Link e Chave estável. Em JSON, escreve-se o caminho, por exemplo produtos[].nome. Com RSS não é preciso mapeamento.
4. Toque em Ver pré-visualização: mostra as primeiras linhas válidas e quantas foram ignoradas.
5. Se estiver bom, Salvar fonte.

Até 1000 linhas por fonte. Se você usar Chave estável (um código que não muda, como um SKU), renomear um produto o atualiza; sem chave, renomear cria um item novo e desativa o antigo. Para uma API que exige credencial, você pode informar um cabeçalho Authorization ou um parâmetro na URL: ele é guardado criptografado e não volta a ser exibido.

Se algo der errado

O cartão da fonte explica a causa:

Para integrar fontes por API, veja os endpoints /knowledge em Endpoints.