Configuration Guide

Customize how your chatbot looks and feels on your website:

Basic Configuration

interface WidgetConfig {
  chatId: string;           // Your unique chat ID
  theme?: 'light' | 'dark'; // Widget theme
  position?: {              // Widget position on the page
    bottom?: number;
    right?: number;
  };
  initialMessage?: string;  // First message shown to users
  branding?: {              // Your brand settings
    logo?: string;          // URL to your logo
    primaryColor?: string;  // Main color for the widget
    fontFamily?: string;    // Custom font
  };
}

Styling

Customize the appearance using Tailwind classes with our rkt- prefix:

<Widget 
  chatId="YOUR_CHAT_ID"
  className="rkt-bg-neutral-900 rkt-text-white"
/>

Training Configuration

Content Sources

Configure what content your chatbot learns from:

interface TrainingConfig {
  sources: {
    websites?: string[];        // URLs to crawl
    documents?: string[];       // Paths to documents
    faqs?: FAQ[];              // Direct FAQ entries
    excludePatterns?: string[]; // URLs/paths to skip
  };
  crawling: {
    depth: number;             // How deep to crawl
    maxPages: number;          // Max pages to process
    waitTime: number;          // Time between requests
  };
  chunking: {
    size: number;              // Chunk size for processing
    overlap: number;           // Overlap between chunks
  };
}

Knowledge Base Updates

Configure how your chatbot stays up-to-date:

# Enable automatic updates
ENABLE_AUTO_UPDATES=true
UPDATE_FREQUENCY=daily      # hourly, daily, weekly
 
# Set update windows
UPDATE_WINDOW_START=02:00   # 2 AM
UPDATE_WINDOW_END=04:00     # 4 AM

Response Configuration

Answer Settings

interface AnswerConfig {
  maxLength: number;          // Maximum response length
  style: 'concise' | 'detailed';
  temperature: number;        // Response creativity (0-1)
  fallbackMessage: string;    // Message when no context found
  confidenceThreshold: number;// Min confidence to respond
}

Custom Responses

Define specific responses for certain queries:

const customResponses = [
  {
    trigger: /pricing|cost/i,
    response: "Our pricing starts at $10/month. Check out our pricing page for more details!"
  },
  {
    trigger: "business hours",
    response: "We're open Monday-Friday, 9am-5pm EST."
  }
];

Advanced Settings

Environment Variables

Required variables:

ROCKET_FLOW_API_KEY=your_api_key
NEXT_PUBLIC_WIDGET_URL=https://widget.getrocketflow.io

Optional settings:

# RAG Configuration
VECTOR_DB_PROVIDER=pinecone    # or weaviate, qdrant
EMBEDDING_MODEL=text-embedding-ada-002
CHUNK_SIZE=1000
CHUNK_OVERLAP=200
 
# Performance
MAX_CONCURRENT_REQUESTS=5
CACHE_DURATION=3600           # in seconds
RATE_LIMIT=100               # requests per minute
 
# Monitoring
ENABLE_ANALYTICS=true
LOG_LEVEL=info               # debug, info, warn, error

Webhook Integration

Set up webhooks for chat events:

# Configure webhook URL
WEBHOOK_URL=https://your-server.com/webhook
 
# Select events to receive
WEBHOOK_EVENTS=message,feedback,error
 
# Add authentication
WEBHOOK_SECRET=your_secret_key

For implementation examples and API details, check out our API Reference.

Configuration