Configuration Guide

Customize your chatbot's behavior and appearance through these essential settings:

Basic Information

• Name: The internal name of your chatbot (not visible to users)
• Description: A brief description to help you identify this chatbot
• Avatar: Upload a custom avatar image for your chatbot

Chat Interface

• Chat Title: The title displayed at the top of the chat window
• Welcome Message: The first message users see when opening the chat
• Placeholder Text: Text displayed in the input field before the user types
• Primary Color: The main color used for the chat interface
• Position: Where the chat button appears on your website (bottom-right, bottom-left, etc.)

Behavior Settings

• Auto-Open: Whether the chat window should automatically open when a user visits your site
• Show Sources: Whether to display the sources of information used to answer questions
• Require Email: Whether to ask for the user's email before starting a conversation
• Working Hours: Set specific hours when the chatbot is available

Fine-tune your chatbot's AI behavior with these advanced settings:

Model Selection

BotFusion supports several AI models with different capabilities:

• GPT-3.5-Turbo: Good balance of performance and cost
• GPT-4: More capable but higher cost
• Claude: Alternative model with different strengths

Temperature

Temperature controls how creative or focused the AI responses are:

• Low (0.0-0.3): More focused, deterministic responses
• Medium (0.4-0.7): Balanced creativity and focus
• High (0.8-1.0): More creative, varied responses

For factual, support-oriented chatbots, we recommend a lower temperature (0.2-0.4).

System Prompt

The system prompt provides instructions to the AI about how it should behave. A well-crafted system prompt can significantly improve your chatbot's performance.

Example system prompt for a customer support chatbot:

You are a helpful customer support assistant for BotFusion, a company that provides AI chatbot solutions. Answer questions accurately based on the provided knowledge base. If you don't know the answer, politely say so and offer to connect the user with a human support agent. Keep responses concise and friendly. Always maintain a professional tone.

Context Window

The context window determines how much of the conversation history and knowledge base content is sent to the AI model:

• Small (2k tokens): Faster responses, less context
• Medium (4k tokens): Balanced approach
• Large (8k tokens): More context but potentially slower responses

Larger context windows allow the AI to reference more information but may increase response time and costs.

For power users, BotFusion offers several advanced configuration options:

Custom CSS

You can fully customize the appearance of your chatbot with custom CSS. Add your styles when initializing the chatbot:

BotFusion.init({
  botId: 'YOUR_BOT_ID',
  customCSS: `
    .bf-chat-window {
      border-radius: 16px;
      box-shadow: 0 12px 24px rgba(0, 0, 0, 0.1);
    }
    .bf-message-user {
      background-color: #F3F4F6;
      color: #1F2937;
    }
    .bf-message-bot {
      background-color: #4F46E5;
      color: white;
    }
  `
});

Webhooks

Set up webhooks to receive notifications when users interact with your chatbot:

1. Go to Settings → Webhooks in your dashboard
2. Add a new webhook URL
3. Select the events you want to receive (conversation started, message sent, etc.)
4. Save your webhook configuration

Webhook payloads include detailed information about the event, such as user data, message content, and timestamps.

Custom Functions

For advanced use cases, you can define custom functions that your chatbot can call:

BotFusion.init({
  botId: 'YOUR_BOT_ID',
  functions: [
    {
      name: 'getProductPrice',
      description: 'Get the current price of a product',
      parameters: {
        type: 'object',
        properties: {
          productId: {
            type: 'string',
            description: 'The ID of the product'
          }
        },
        required: ['productId']
      },
      function: async ({ productId }) => {
        // Fetch the product price from your API
        const response = await fetch(`/api/products/${productId}`);
        const product = await response.json();
        return { price: product.price, currency: product.currency };
      }
    }
  ]
});

When a user asks about a product price, the chatbot can call this function to get real-time pricing information.

Multi-Language Support

Configure your chatbot to support multiple languages:

1. Go to Settings → Languages in your dashboard
2. Enable the languages you want to support
3. For each language, you can customize the welcome message and system prompt
4. The chatbot will automatically detect the user's language and respond accordingly