HomeDocumentation

FAQ Management

FAQs (Frequently Asked Questions) are the most direct way to train your chatbot. Add common questions and their answers to ensure accurate, consistent responses.

Overview

The FAQ system in ChatReact includes:

  • Manual FAQ creation
  • AI-generated FAQ suggestions (on demand via button or Improvement Agent)
  • Category organization
  • Bulk import/export
  • Publishing controls

Creating FAQs

Manual Creation

  1. Navigate to FAQs in the sidebar
  2. Click Add FAQ
  3. Fill in the details:
FieldDescription
QuestionHow customers typically ask this question
AnswerThe complete, accurate response
CategoryOptional grouping for organization
PublishedToggle visibility in the widget
  1. Click Save

Write questions the way customers actually phrase them, including common typos or informal language.

Answer Formatting

Answers support:

  • Plain text
  • Line breaks for readability
  • URLs (displayed as clickable links)
  • Basic formatting in the widget

Categories

Creating Categories

  1. Click Manage Categories or the category dropdown
  2. Click Add Category
  3. Enter name and optional description
  4. Save

Suggested Categories

Common categories include:

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

Organizing FAQs

  • Drag and drop FAQs between categories
  • Filter by category in the list view
  • Categories appear in the FAQ widget as sections

FAQ Suggestions

FAQ suggestions are generated on demand (not automatically from chat):

  1. Generate from Knowledge Base – Use the button on the FAQ Suggestions page to create suggestions from your crawled website content.
  2. Improvement Agent – The agent can suggest new or updated FAQs as part of its improvement proposals.
  3. Manual – Create FAQs yourself at any time.

Generate from Knowledge Base

You can generate FAQ suggestions from your crawled website content:

  1. Go to FAQsSuggestions tab
  2. Click Generate from Knowledge Base
  3. Optional: Select a category for targeted generation
  4. Wait for AI analysis to complete
  5. Review the generated suggestions

Intelligent Gap Analysis

When you don't select a category, ChatReact uses intelligent gap analysis:

  • The AI analyzes your existing FAQs and vector store
  • Automatically detects which topics are already well covered
  • Generates FAQs only for topics that are insufficiently covered (0-1 FAQs)
  • Prioritizes important business topics: pricing, services, requirements, processes

Gap analysis prevents duplicates and focuses on real knowledge gaps.

Category-Based Generation

When you select a category, the AI uses semantic search:

  • Searches the vector store specifically for information related to the chosen category
  • Extracts relevant content (up to 1500 words)
  • Generates FAQs specifically for that category

Automatic Category Assignment

If you have FAQ categories set up, the AI will automatically suggest the most appropriate category for each generated FAQ. This saves time when organizing your FAQs.

Reviewing Suggestions

  1. Go to FAQsSuggestions tab
  2. Review each suggestion:
    • See the original conversation context
    • See the AI-suggested category (if categories exist)
    • Edit question and answer as needed
  3. Click Accept to add to FAQs or Dismiss to reject

FAQ Suggestions are available on Starter plan and above.

Publishing

Draft vs Published

StatusBehavior
DraftOnly visible in dashboard, not used by chatbot
PublishedActive in chatbot responses and FAQ widget

Bulk Actions

Select multiple FAQs to:

  • Publish all
  • Unpublish all
  • Delete all
  • Move to category

FAQ Widget

Display FAQs on your website as a standalone component:

Embedding

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

Widget Features

  • Accordion-style expandable questions
  • Category filtering
  • Search functionality
  • "Still need help?" link to open chat
  • Matches your brand colors

Import & Export

Exporting FAQs

  1. Click Export in the FAQs page
  2. Download as CSV or JSON
  3. Use for backup or analysis

Importing FAQs

  1. Click Import
  2. Upload CSV or JSON file
  3. Map columns to fields
  4. Review and confirm

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: Begin with your most common questions
  2. Be specific: "How do I cancel?" vs "How do I cancel my monthly subscription?"
  3. Keep answers helpful: Include next steps or links when relevant
  4. Review regularly: Check which questions are being asked but not answered
  5. Use categories: Organization helps both you and visitors
  6. Monitor suggestions: AI suggestions reveal knowledge gaps

Next Steps