KrooBot Logo KrooBot
KrooBot

KrooBot Documentation

Complete guide to setting up, configuring, and using KrooBot AI chatbot. From installation to advanced customization.

Table of Contents

Getting Started

Quick setup guide

WordPress Setup

Plugin installation

API Documentation

REST API reference

Voice Chat

Voice features guide

Customization

Styling & branding

Troubleshooting

Common issues & fixes

Getting Started

What is KrooBot?

KrooBot is an AI-powered chatbot platform that helps businesses provide instant customer support and engagement. With advanced natural language processing and voice capabilities, KrooBot can understand and respond to customer queries in real-time, 24/7.

Key Features

🤖 AI-Powered Responses

Advanced natural language processing for human-like conversations

🎤 Voice Chat

Speak naturally with voice-to-text and text-to-speech capabilities

📚 Easy Training

Upload FAQs, documents, or manually add training data

🔧 WordPress Integration

Seamless integration with any WordPress website

Quick Start Guide

  1. Create Account: Sign up at KrooBot and verify your email
  2. Create Chatbot: Go to Dashboard → Create New Chatbot
  3. Add Training Data: Upload FAQs or add questions manually
  4. Configure Settings: Customize appearance and behavior
  5. Get API Key: Generate your unique API key
  6. Install Plugin: Download and install WordPress plugin
  7. Test & Launch: Test your chatbot and go live!

WordPress Plugin Setup

Installation

Method 1: Direct Upload (Recommended)

  1. Download the plugin from our download page
  2. Go to WordPress Admin → Plugins → Add New
  3. Click "Upload Plugin" and select the downloaded ZIP file
  4. Click "Install Now" and then "Activate Plugin"

Configuration

After installation, configure your chatbot:

Required Settings

  • API Key: Enter your KrooBot API key
  • Chatbot ID: Select your chatbot from the dropdown
  • Widget Position: Choose where to display the chat widget
  • Enable Voice Chat: Toggle voice chat functionality

Widget Positioning

Choose from 4 corner positions for your chat widget:

Top Left
Top Right
Bottom Left
Bottom Right

API Documentation

Authentication

All API requests require your API key in the header:

Authorization: Bearer YOUR_API_KEY

Text Chat Endpoint

POST /api/chat

Request Body:

{
  "message": "Hello, how can you help me?",
  "chatbot_id": "your-chatbot-id",
  "visitor_info": {
    "name": "John Doe",
    "email": "john@example.com",
    "origin": "https://yourwebsite.com"
  }
}

Response:

{
  "success": true,
  "response": "Hello! I'm here to help you with any questions you might have.",
  "confidence": 0.95,
  "sources": ["faq_1", "faq_2"]
}

Voice Chat Endpoint

POST /api/voice

Request:

Send audio file (MP3, WAV, M4A) with the same parameters as text chat.

Response:

{
  "success": true,
  "text_response": "Here's the answer to your question...",
  "audio_response": "https://example.com/audio/response.mp3",
  "confidence": 0.92
}

Voice Chat Features

How Voice Chat Works

Voice chat combines speech recognition, AI processing, and text-to-speech to create a natural conversation experience.

1. Voice Input

User speaks into microphone, audio is captured and sent to server

2. AI Processing

Speech converted to text, processed by AI, response generated

3. Voice Response

AI response converted to speech and played back to user

Voice Chat Settings

Configurable Parameters

Silence Threshold

How long to wait after silence before processing (default: 2 seconds)

Minimum Recording Time

Shortest allowed recording duration (default: 1 second)

Voice Quality

Audio quality settings (low, medium, high)

Auto-play Response

Automatically play voice responses (enabled by default)

Browser Compatibility

Supported Browsers: Chrome, Firefox, Safari, Edge (all modern versions)

Customization

Widget Appearance

Customize your chatbot widget to match your website's design:

Colors

  • Primary color (buttons, highlights)
  • Background color
  • Text color
  • Border color

Layout

  • Widget position (4 corners)
  • Widget size
  • Chat window dimensions
  • Toggle button style

Chatbot Personality

Customizable Elements

  • Welcome Message: Set a custom greeting
  • Chatbot Name: Give your AI a personality
  • Response Style: Formal, casual, or professional
  • Language: Support for multiple languages

Advanced Settings

Performance & Behavior

Response Timeout

Maximum time to wait for AI response (default: 30 seconds)

Auto-scroll

Automatically scroll to new messages (enabled by default)

Sound Notifications

Play sound when new messages arrive

Typing Indicator

Show "AI is typing..." indicator

Troubleshooting

Common Issues

Chatbot Not Responding

If your chatbot isn't responding:

  • Check if your API key is correct
  • Verify your chatbot is active
  • Ensure you have sufficient credits
  • Check browser console for errors

Voice Chat Not Working

If voice chat isn't working:

  • Check microphone permissions
  • Ensure you're using HTTPS
  • Try a different browser
  • Check if voice chat is enabled in settings

Widget Not Displaying

If the widget isn't showing:

  • Check if plugin is activated
  • Verify API key and chatbot ID
  • Clear browser cache
  • Check for JavaScript errors

Getting Help

Still having issues? We're here to help!

Contact Support Browse FAQ