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
- Navigate to FAQs in the sidebar
- Click Add FAQ
- Fill in the details:
| Field | Description |
|---|---|
| Question | How customers typically ask this question |
| Answer | The complete, accurate response |
| Category | Optional grouping for organization |
| Published | Toggle visibility in the widget |
- 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
- Click Manage Categories or the category dropdown
- Click Add Category
- Enter name and optional description
- 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):
- Generate from Knowledge Base – Use the button on the FAQ Suggestions page to create suggestions from your crawled website content.
- Improvement Agent – The agent can suggest new or updated FAQs as part of its improvement proposals.
- Manual – Create FAQs yourself at any time.
Generate from Knowledge Base
You can generate FAQ suggestions from your crawled website content:
- Go to FAQs → Suggestions tab
- Click Generate from Knowledge Base
- Optional: Select a category for targeted generation
- Wait for AI analysis to complete
- 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
- Go to FAQs → Suggestions tab
- Review each suggestion:
- See the original conversation context
- See the AI-suggested category (if categories exist)
- Edit question and answer as needed
- Click Accept to add to FAQs or Dismiss to reject
FAQ Suggestions are available on Starter plan and above.
Publishing
Draft vs Published
| Status | Behavior |
|---|---|
| Draft | Only visible in dashboard, not used by chatbot |
| Published | Active 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
- Click Export in the FAQs page
- Download as CSV or JSON
- Use for backup or analysis
Importing FAQs
- Click Import
- Upload CSV or JSON file
- Map columns to fields
- 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
- Start with top 20: Begin with your most common questions
- Be specific: "How do I cancel?" vs "How do I cancel my monthly subscription?"
- Keep answers helpful: Include next steps or links when relevant
- Review regularly: Check which questions are being asked but not answered
- Use categories: Organization helps both you and visitors
- Monitor suggestions: AI suggestions reveal knowledge gaps