InícioDocumentação

Gerenciamento de FAQ

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 do 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
  • Traduções para todos os 24 idiomas da UE
  • Controles de publicação
  • Um widget de FAQ incorporável para seu site

Criando FAQs

Criação Manual

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

Novas FAQs são publicadas imediatamente. Para tirar uma offline, clique em Save as Draft no cartão — Publish a torna ativa novamente.

O número de FAQs que você pode criar por chatbot depende do seu plano de assinatura — veja Billing.

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

Formatação de Respostas

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 listas 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, assim você pode formatar as respostas antes de aceitá-las.

Categorias

Criando Categorias

  1. Vá para FAQs → aba Categories
  2. Clique em Add Category
  3. Insira um nome de categoria e uma descrição opcional
  4. Salve

Categorias Sugeridas

Categorias comuns incluem:

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

Organizand o FAQs

  • Atribua uma categoria usando o dropdown em cada cartão de FAQ
  • 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 OrdenaçãoDescrição
DateFAQs mais recentes primeiro
NameOrdem alfabética pela pergunta
CustomOrdenação manual via arrastar & soltar

Quando Custom estiver selecionado, as abas Published e Drafts mostram uma alça de arraste e um campo 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 ordenação independente. Configure isso na aba Categories:

  • A aba "All" no widget usa o modo de ordenação global das Configurações do Widget
  • Abas de categorias individuais usam seu próprio modo de ordenação
  • Isso permite estratégias de ordenação diferentes por categoria (por exemplo, alfabética para "General" e customizada para "Pricing")

Sugestões de FAQ

Sugestões de FAQ são geradas sob demanda (não automaticamente a partir do chat):

  1. Generate from Knowledge Base – Use o botão na página de FAQ Suggestions para criar sugestões a partir do conteúdo do seu site rastreado.
  2. Improvement Agent – O agente pode sugerir novas FAQs ou atualizações como parte de suas propostas de melhoria.
  3. Manual – Crie FAQs manualmente 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 análise da IA ser concluída
  5. Reveja 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 a base de conhecimento
  • Detecta automaticamente quais tópicos já estão bem cobertos
  • Gera FAQs apenas para tópicos insuficientemente cobertos (0-1 FAQs)
  • Prioriza tópicos importantes para o negócio: preços, serviços, requisitos, processos

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

Geração Baseada em Categoria

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

  • Pesquisa na base de conhecimento informações relacionadas especificamente à 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. Reveja cada sugestão:
    • Veja a pontuação de confiança e a categoria sugerida pela IA (se houver categorias)
    • Edite a pergunta e a resposta conforme necessário — o botão Approve & Publish do diálogo de edição publica sua versão editada
  3. Clique em Approve para adicionar a sugestão às suas FAQs ou Reject para descartá-la

FAQ Suggestions estão disponíveis a partir do plano Starter.

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

Alterando o Status de Publicação

Cada cartão de FAQ tem seus próprios controles: clique em Save as Draft para retirar uma FAQ publicada, ou Publish para tornar um rascunho ativo.

Widget de FAQ

Exiba FAQs em 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>

Você pode encontrar o código de incorporação pronto para copiar em FAQs → aba Embed.

Exibindo Somente Categorias Específicas

Adicione o atributo opcional data-categories para exibir apenas FAQs de categorias específicas, usando slugs de categoria separados por vírgulas:

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

Sem esse atributo, todas as FAQs publicadas são exibidas — com abas de categoria quando você tiver mais de uma categoria. Seus slugs de categoria disponíveis estão listados na aba Embed.

WordPress

Com o plugin ChatReact para WordPress instalado, você pode incorporar o widget de FAQ nativamente:

  • Shortcode: [chatreact_faq id="YOUR_CHATBOT_ID"]
  • Shortcode com filtro de categoria: [chatreact_faq id="YOUR_CHATBOT_ID" categories="slug1"]
  • Bloco Gutenberg: procure por "ChatReact FAQ" no inseridor de blocos

A aba Embed fornece shortcodes prontos para copiar e um link para download do plugin. Veja WordPress → para a configuração do plugin.

Sites WordPress e CMS conectados armazenam em cache os dados de FAQ. O cache é atualizado automaticamente quando você publica, atualiza ou exclui FAQs — você também pode limpá-lo manualmente com Clear Remote Cache na aba Embed.

Shopify

Adicione o widget de FAQ à sua loja Shopify via Theme Editor (recomendado):

  1. Instale o app ChatReact na Shopify App Store
  2. Abra o Theme Editor da Shopify (Online Store → Customize)
  3. Clique em Add section ou Add block e pesquise por "ChatReact FAQ"
  4. Insira seu Chatbot ID e configure categorias e idioma

Alternativamente, cole o código de incorporação em uma seção Custom Liquid no seu tema. Veja Shopify → para detalhes.

Recursos do Widget

  • Perguntas expansíveis em estilo acordeão
  • Abas de categoria (exibidas quando você tem mais de uma categoria)
  • SEO-friendly: FAQs são renderadas em um formato amigável para mecanismos de busca com dados estruturados FAQPage para rich snippets
  • Combina com as cores da sua marca
  • Largura configurável (100% ou largura personalizada em pixels 400–1200px)
  • Ordem de classificação configurável (Date, Name ou Custom por categoria)

Configurações do Widget

Personalize a aparência e o comportamento do widget em FAQsSettings:

ConfiguraçãoOpções
ColorsPredefinições rápidas Light/Dark, além de cores primária, de fundo, de texto e de borda
Border RadiusAjuste o arredondamento dos cantos
Title & LayoutMostrar ou ocultar o título, definir um texto de título personalizado, escolher espaçamento Compact, Normal ou Relaxed
Maximum Width100% ou uma largura personalizada em pixels
Allow Multiple OpenPermitir que visitantes abram múltiplas FAQs ao mesmo tempo
Auto-Open First FAQExpandir automaticamente a primeira FAQ
Sort OrderDate, Name ou Custom

Traduções

Traduzindo FAQs

O ChatReact suporta traduzir suas FAQs para todos os 24 idiomas da UE:

  1. Vá para FAQs → aba Translations
  2. Escolha uma FAQ no dropdown Select FAQ...
  3. Mude para a aba do idioma alvo
  4. Edite as traduções manualmente ou use Translate this FAQ para traduzir uma FAQ única com IA

Tradução em Lote

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

  • As traduções são executadas como um background job no servidor — você pode sair da página ou fechar o navegador
  • O progresso é salvo e exibido quando você retornar
  • Uma notificação aparece no ícone do sino quando todas as traduções estiverem completas
  • Use o botão Cancel para interromper o processo a qualquer momento
  • As traduções são salvas imediatamente à medida que 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.

Pesquisa & Filtro

Encontrando FAQs

Use a barra de pesquisa para encontrar FAQs por:

  • Texto da pergunta
  • Conteúdo da resposta
  • Nome da categoria

Filtragem & Ordenação

  • Por Status: Troque entre as abas Published e Drafts
  • Por Categoria: Filtre a lista com o seletor de categoria
  • Ordenação: Ordene FAQs por Date, Name ou Category com um alternador ascendente/descendente — ou escolha Custom para ordenação manual

Melhores Práticas

  1. Comece com as 20 principais: Inicie com suas perguntas mais comuns
  2. Seja específico: "How do I cancel?" vs "How do I cancel my monthly subscription?"
  3. Mantenha as respostas úteis: Inclua próximos passos ou links quando relevante
  4. Revise regularmente: Verifique quais perguntas estão sendo feitas mas não respondidas
  5. Use categorias: A organização ajuda tanto você quanto os visitantes
  6. Monitore as sugestões: Sugestões de IA revelam lacunas de conhecimento

Próximos Passos