HomeDocumentation

Gerenciamento de FAQ

As FAQs (Perguntas Frequentes) são a maneira mais direta de treinar seu chatbot. Adicione perguntas comuns e suas respostas para garantir respostas precisas e consistentes.

Visão Geral

O sistema de FAQ no ChatReact inclui:

  • Criação manual de FAQs
  • Sugestões de FAQs geradas por IA (sob demanda via botão ou Improvement Agent)
  • Organização por categorias
  • Importação/exportação em massa
  • Controles de publicação

Criando FAQs

Criação Manual

  1. Navegue até FAQs na barra lateral
  2. Clique em Adicionar FAQ
  3. Preencha os detalhes:
CampoDescrição
QuestionComo os clientes normalmente fazem essa pergunta
AnswerA resposta completa e precisa
CategoryAgrupamento opcional para organização
PublishedAlternar visibilidade no widget
  1. Clique em Salvar

Escreva as perguntas da forma como os clientes realmente as formulam, incluindo erros comuns de digitação ou linguagem informal.

Formatação da Resposta

As respostas são editadas usando um editor WYSIWYG de rich-text com as seguintes opções de formatação:

  • Texto em negrito e itálico
  • Listas com marcadores e numeradas
  • Links (exibidos como links clicáveis no widget)
  • Quebras de linha e parágrafos

O mesmo editor rich-text também é usado ao editar sugestões de FAQ, para que você possa formatar as respostas antes de aceitá-las.

Categorias

Criando Categorias

  1. Clique em Gerenciar Categorias ou no menu suspenso de categoria
  2. Clique em Adicionar Categoria
  3. Insira o nome e uma descrição opcional
  4. Salve

Categorias Sugeridas

Categorias comuns incluem:

  • Pricing & Billing
  • Account Management
  • Technical Support
  • Shipping & Returns
  • Getting Started
  • Features & Capabilities

Organizando as FAQs

  • Arraste e solte FAQs entre categorias
  • Filtre por categoria na exibição em lista
  • As categorias aparecem no widget de FAQ como abas

Ordem de Classificação

Controle como as FAQs são exibidas no widget incorporado. Configure isso em FAQs → Settings → Behavior:

Modo de ClassificaçãoDescrição
DateFAQs mais recentes primeiro
NameOrdem alfabética por pergunta
CustomOrdenação manual por arrastar e soltar

Quando Custom está selecionado, as abas Publicados e Rascunhos mostram uma alça de arraste e um input numérico de ordem em cada cartão de FAQ. Arraste os cartões para reordenar, ou insira um número para mover uma FAQ para uma posição específica.

Ordem de Classificação Por Categoria

Cada categoria pode ter seu próprio modo de classificação independente. Configure isso na aba Categories:

  • A aba "All" no widget usa o modo de classificação global das Configurações do Widget
  • As abas de categorias individuais usam seu próprio modo de classificação
  • Isso permite estratégias de ordenação diferentes por categoria (por exemplo, alfabético para "Geral" mas personalizado para "Pricing")

Sugestões de FAQ

As sugestões de FAQ são geradas sob demanda (não automaticamente a partir das conversas):

  1. Gerar a partir da Knowledge Base – Use o botão na página de Sugestões de FAQ para criar sugestões a partir do conteúdo rastreado do seu site.
  2. Improvement Agent – O agente pode sugerir FAQs novas ou atualizadas como parte de suas propostas de melhoria.
  3. Manual – Crie FAQs você mesmo a qualquer momento.

Gerar a partir da Knowledge Base

Você pode gerar sugestões de FAQ a partir do conteúdo do seu site rastreado:

  1. Vá para FAQs → aba Suggestions
  2. Clique em Generate from Knowledge Base
  3. Opcional: Selecione uma categoria para geração direcionada
  4. Aguarde a conclusão da análise pela IA
  5. Revise as sugestões geradas

Análise Inteligente de Lacunas

Quando você não seleciona uma categoria, o ChatReact usa análise inteligente de lacunas:

  • A IA analisa suas FAQs existentes e o vector store
  • Detecta automaticamente quais tópicos já estão bem cobertos
  • Gera FAQs somente para tópicos que estão insuficientemente cobertos (0-1 FAQs)
  • Prioriza tópicos importantes para o negócio: pricing, services, requirements, processes

A análise de lacunas evita duplicatas e foca em lacunas reais de conhecimento.

Geração por Categoria

Quando você seleciona uma categoria, a IA usa busca semântica:

  • Procura no vector store especificamente por informações relacionadas à categoria escolhida
  • Extrai conteúdo relevante (até 1500 palavras)
  • Gera FAQs especificamente para essa categoria

Atribuição Automática de Categoria

Se você tiver categorias de FAQ configuradas, a IA sugerirá automaticamente a categoria mais apropriada para cada FAQ gerada. Isso economiza tempo ao organizar suas FAQs.

Revisando Sugestões

  1. Vá para FAQs → aba Suggestions
  2. Revise cada sugestão:
    • Veja o contexto original da conversa
    • Veja a categoria sugerida pela IA (se existirem categorias)
    • Edite a pergunta e a resposta conforme necessário
  3. Clique em Accept para adicionar às FAQs ou Dismiss para rejeitar

As Sugestões de FAQ estão disponíveis no plano Starter e superiores.

Publicação

Rascunho vs Publicado

StatusComportamento
DraftVisível apenas no painel, não usado pelo chatbot
PublishedAtivo nas respostas do chatbot e no widget de FAQ

Ações em Massa

Selecione várias FAQs para:

  • Publicar todas
  • Despublicar todas
  • Excluir todas
  • Mover para categoria

Widget de FAQ

Exiba FAQs no seu site como um componente independente:

Incorporação

<div id="chatreact-faq"></div>
<script 
  src="https://www.chatreact.ai/embed/faq-widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  async
></script>

Recursos do Widget

  • Perguntas expansíveis no estilo accordion
  • Filtragem por categoria com abas
  • Funcionalidade de busca
  • Link "Still need help?" para abrir o chat
  • Compatível com as cores da sua marca
  • Largura configurável (100% ou largura personalizada em pixels 400–1200px)
  • Ordem de classificação configurável (Data, Nome ou Personalizado por categoria)

Traduções

Traduzindo FAQs

ChatReact suporta a tradução das suas FAQs para todas as 24 línguas da UE:

  1. Vá para FAQs e selecione uma FAQ
  2. Mude para a aba do idioma de destino
  3. Edite as traduções manualmente, ou use Translate with AI para uma única FAQ

Tradução em Massa

Traduza todas as FAQs de uma vez usando o botão Translate All:

  • As traduções são executadas como um job em background no servidor — você pode sair da página ou fechar o navegador
  • O progresso é salvo e exibido quando você retorna
  • Uma notificação aparece no ícone de sino quando todas as traduções estão completas
  • Use o botão Cancel para interromper o processo a qualquer momento
  • As traduções são salvas imediatamente conforme cada FAQ é processada

O idioma de origem é detectado automaticamente por FAQ, então mesmo que algumas FAQs estejam escritas em um idioma diferente do idioma principal do seu chatbot, elas serão traduzidas corretamente.

Import & Export

Exporting FAQs

  1. Clique em Export na página de FAQs
  2. Baixe como CSV ou JSON
  3. Use para backup ou análise

Importing FAQs

  1. Clique em Import
  2. Envie um arquivo CSV ou JSON
  3. Mapeie colunas para campos
  4. Revise e confirme

CSV Format

question,answer,category,published
"How do I reset my password?","Click 'Forgot Password' on the login page...","Account",true
"What payment methods do you accept?","We accept Visa, Mastercard...","Billing",true

Search & Filter

Finding FAQs

Use the search bar to find FAQs by:

  • Question text
  • Answer content
  • Category name

Filtering Options

  • By Category: Select specific Category
  • By Status: Draft, published, all
  • By Date: Recently created, updated

Best Practices

  1. Start with top 20: Comece com as suas perguntas mais comuns
  2. Be specific: "How do I cancel?" vs "How do I cancel my monthly subscription?"
  3. Keep answers helpful: Inclua próximos passos ou links quando relevante
  4. Review regularly: Verifique quais perguntas estão sendo feitas mas não respondidas
  5. Use categories: A organização ajuda tanto você quanto os visitantes
  6. Monitor suggestions: AI suggestions revelam gaps de conhecimento

Next Steps