DOCS
Get Started Free โ†’

Welcome to KokobeoChat

The complete documentation for installing, configuring and mastering KokobeoChat โ€” your AI-powered live chat for any website.

๐Ÿš€ QUICK START

From zero to live chat in 60 seconds

Install the plugin, create a free account, paste your API key. Done. No coding, no configuration, no credit card.

What you can do

Why KokobeoChat

  • Free plan forever โ€” no credit card, no trial expiration
  • 15-day trial on Pro (โ‚ฌ29/mo) and Business (โ‚ฌ79/mo) plans
  • Self-learning AI โ€” the more visitors chat, the smarter it becomes
  • 14 languages with automatic visitor detection
  • GDPR compliant โ€” data encrypted in transit and at rest
  • Works everywhere โ€” WordPress, Shopify, Wix, Webflow, plain HTML
โœจ

New to KokobeoChat? Start with the Quick Start guide โ€” it takes less than 2 minutes.

Quick Start

Get your live chat widget running in 4 simple steps.

1

Create your free account

Go to chat.kokobeo.com, fill the registration form with email and password. Registration is free and mandatory โ€” it takes 30 seconds and no credit card is required.

2

Verify your email

Open the email we sent you and click the verification link. This activates your account and generates your personal API key.

3

Copy your API Key

Log into your dashboard and go to API Keys. Copy your key โ€” it looks like kk_live_9f8a2b4c7d1e...

๐ŸŽ‰

That's it! The chat widget now appears on your site. Visitors can message you, and you'll see their messages in your dashboard at chat.kokobeo.com.

How KokobeoChat Works

Understand what happens behind the scenes when a visitor opens the chat.

The components

KokobeoChat is made of three main parts working together:

1. The Widget

A lightweight JavaScript file (under 50KB gzipped) loaded on your website. It shows a chat bubble in the corner. When a visitor clicks it, a chat interface opens.

2. The AI Brain

Every message a visitor sends is first checked against your AI knowledge base. If the AI has a confident answer, it replies instantly. If not, the conversation is routed to a human operator. The AI learns from every conversation โ€” so the more your visitors chat, the smarter and more personalized it becomes.

3. The Dashboard

Your admin dashboard at chat.kokobeo.com/client-admin.html is where you manage everything: active chats, operators, API keys, AI training, analytics, billing.

The flow

  1. Visitor opens your website โ†’ widget loads from our CDN
  2. Visitor clicks the chat bubble โ†’ chat window opens
  3. Visitor types message โ†’ widget sends it to chat.kokobeo.com
  4. AI Brain analyzes message โ†’ replies instantly OR routes to operator
  5. Operator sees the message in real-time โ†’ replies from dashboard
  6. Widget shows reply to visitor โ†’ conversation continues
๐Ÿ”’

Privacy first. No visitor data is sent to KokobeoChat until the visitor actively opens the chat and sends a message. GDPR compliant by design.

WordPress Plugin

The official KokobeoChat plugin for WordPress โ€” available on the WordPress.org directory.

๐Ÿ“ฆ

Official plugin: wordpress.org/plugins/kokobeochat

Install from WordPress Admin (recommended)

1

Open your WordPress admin

Navigate to yoursite.com/wp-admin and log in.

2

Add a new plugin

In the left menu go to Plugins โ†’ Add New. In the search bar type KokobeoChat.

3

Install and activate

Click Install Now, then Activate.

4

Go to plugin settings

Settings โ†’ KokobeoChat. You'll see a guided onboarding page with 3 colored buttons:

๐Ÿš€ REGISTER FREENo credit card
๐Ÿ” LOGINAlready have account
๐Ÿ’ฌ NEED HELP?Chat with us
5

Create your free account

Click REGISTER FREE. Fill the form with email + password, verify your email. Registration is mandatory โ€” you need an account to receive chats.

6

Paste your API Key

From your dashboard, copy your API key. Go back to Settings โ†’ KokobeoChat, paste it in the API Key field, click Save Changes.

โœ…

Done! The chat widget now appears on your entire WordPress site. Test it by visiting your homepage.

Alternative: manual upload (.zip)

If you prefer to upload the plugin manually:

  1. Download from wordpress.org/plugins/kokobeochat
  2. WP Admin โ†’ Plugins โ†’ Add New โ†’ Upload Plugin
  3. Select the .zip file โ†’ Install โ†’ Activate
  4. Continue from step 4 above

Compatibility

KokobeoChat works with:

  • WordPress 5.0+ / PHP 7.4+
  • All themes (Astra, Divi, Avada, GeneratePress...)
  • All page builders (Elementor, Divi Builder, WPBakery, Gutenberg)
  • All cache plugins (WP Rocket, W3 Total Cache, LiteSpeed, WP Super Cache)
  • WooCommerce and WordPress Multisite

Shopify Installation

Add KokobeoChat to your Shopify store in 3 steps.

1

Open your theme code

Shopify Admin โ†’ Online Store โ†’ Themes โ†’ Edit code.

2

Find theme.liquid

Under Layout, open theme.liquid. Scroll to the bottom and find the </body> tag.

3

Paste the widget script

Paste this line just before </body>:

theme.liquid
<script src="https://chat.kokobeo.com/widget.js" data-key="YOUR_API_KEY"></script>

Replace YOUR_API_KEY with your actual key from the KokobeoChat dashboard. Save the file.

๐Ÿ›๏ธ

The widget appears on all store pages including product, collection, and cart.

Wix Installation

Add the chat widget to your Wix site.

1

Access Custom Code

Wix Editor โ†’ Settings โ†’ Custom Code โ†’ + Add Custom Code.

2

Configure the code

Paste your widget script. Set:

  • Name: KokobeoChat
  • Add Code to: All Pages
  • Place Code in: Body โ€” end
3

Apply and publish

Click Apply โ†’ Publish your site. The widget is live.

HTML / Plain Script

Works on any HTML website, custom CMS, or framework.

Paste this line just before the closing </body> tag on every page (or in your global template):

index.html
<!-- KokobeoChat widget -->
<script src="https://chat.kokobeo.com/widget.js" data-key="YOUR_API_KEY" async></script>

Replace YOUR_API_KEY with your actual key.

Framework-specific

React / Next.js

Layout.jsx
import Script from 'next/script';

export default function Layout() {
  return (
    <Script
      src="https://chat.kokobeo.com/widget.js"
      data-key="YOUR_API_KEY"
      strategy="afterInteractive"
    />
  );
}

AI Brain โ€” Self-Learning Knowledge Base

Train your AI with your own content. Every conversation makes it smarter.

How it works

The AI Brain is a knowledge base the AI uses to answer visitor questions. You can feed it:

  • Your website โ€” paste the URL, the AI reads all pages and extracts information
  • Documents โ€” upload PDF, TXT, DOCX, XLSX, CSV (up to 20MB each)
  • Additional URLs โ€” FAQ pages, Terms, Privacy, product pages, catalogs

Self-learning from chats

When you enable Auto-learn from chats, the AI automatically generates a knowledge document from every closed conversation. This means:

  • The more visitors chat, the richer the AI memory becomes
  • Replies get more accurate and personalized over time
  • Common questions are answered instantly with perfect context
  • Operators save time โ€” the AI handles routine questions automatically
๐Ÿง 

The AI learns your business. After 100-200 chats, it knows your products, policies, pricing, and tone of voice better than a new hire.

How to train your AI

1

Open AI Brain in dashboard

Go to chat.kokobeo.com/client-admin.html โ†’ click the AI Brain button in the sidebar.

2

Analyze your website

Paste your website URL and click Analyze. The AI generates a complete knowledge document automatically.

3

Upload documents

Drag and drop PDFs, product catalogs, FAQ files. The AI extracts the content and adds it to the Brain.

4

Enable auto-learn

Turn on Auto-learn from chats. The AI starts building its memory with every conversation.

14 Languages Supported

Chat with visitors worldwide without speaking their language.

Supported languages

๐Ÿ‡ฌ๐Ÿ‡ง

English

๐Ÿ‡ฎ๐Ÿ‡น

Italiano

๐Ÿ‡ช๐Ÿ‡ธ

Espaรฑol

๐Ÿ‡ซ๐Ÿ‡ท

Franรงais

๐Ÿ‡ฉ๐Ÿ‡ช

Deutsch

๐Ÿ‡ต๐Ÿ‡น

Portuguรชs

๐Ÿ‡ณ๐Ÿ‡ฑ

Nederlands

๐Ÿ‡ต๐Ÿ‡ฑ

Polski

๐Ÿ‡ท๐Ÿ‡บ

ะ ัƒััะบะธะน

๐Ÿ‡จ๐Ÿ‡ณ

ไธญๆ–‡

๐Ÿ‡ฏ๐Ÿ‡ต

ๆ—ฅๆœฌ่ชž

๐Ÿ‡ธ๐Ÿ‡ฆ

ุงู„ุนุฑุจูŠุฉ

๐Ÿ‡น๐Ÿ‡ท

Tรผrkรงe

๐Ÿ‡จ๐Ÿ‡ฟ

ฤŒeลกtina

Automatic language detection

KokobeoChat detects the visitor's browser language automatically. The widget greets them in their own language, the AI replies in that language, and messages are translated in real-time between the visitor and the operator.

๐ŸŒ

Real-time translation: Your operator writes in Italian โ†’ the visitor reads in Arabic. The visitor writes in Japanese โ†’ your operator reads in Italian. Transparent, instant, automatic.

Multi-Operator Team

Add your team, distribute chats, work together.

How many operators can I have?

  • Free plan: 1 operator
  • Pro plan (โ‚ฌ29/mo): 5 operators
  • Business plan (โ‚ฌ79/mo): Unlimited operators

Adding operators

In your dashboard go to Operators โ†’ + Add Operator. Configure:

  • Name, email, password
  • Role โ€” Agent or Admin
  • Languages they can handle
  • Working hours โ€” per day, with 24h option
  • Max simultaneous chats
  • Profile photo shown in the widget

Auto-assign chats

When enabled, new chats are automatically routed to operators based on:

  • Operator availability (online + within working hours)
  • Current load (fewer active chats = higher priority)
  • Language match (visitor language matches operator's managed languages)

Pricing & Plans

Free forever. Upgrade when you grow.

FREE
โ‚ฌ0
Forever
  • โœ“ 1 operator
  • โœ“ 500 chats/month
  • โœ“ AI Brain basic
  • โœ“ 3 languages
POPULAR
PRO
โ‚ฌ29/mo
15-day free trial
  • โœ“ 5 operators
  • โœ“ Unlimited chats
  • โœ“ Full AI Brain + auto-learn
  • โœ“ All 14 languages
  • โœ“ Analytics & reviews
  • โœ“ No 'Powered by'
BUSINESS
โ‚ฌ79/mo
15-day free trial
  • โœ“ Unlimited operators
  • โœ“ White-label branding
  • โœ“ SLA guarantee
  • โœ“ Custom integrations
  • โœ“ Priority support
๐Ÿ’ณ

No credit card required for the Free plan or 15-day trials on Pro/Business.

Frequently Asked Questions

Quick answers to common questions.

General

Is KokobeoChat really free?
Yes. The Free plan is forever free with no credit card required. 500 chats/month, 1 operator, no ads.
Do I need a credit card to sign up?
No. Registration is free and requires only email and password. Credit card is only needed if you upgrade to Pro or Business.
Can I try Pro or Business for free?
Yes โ€” 15 days free trial on both plans, no credit card required.
What languages are supported?
14 languages with automatic visitor detection: English, Italian, Spanish, French, German, Portuguese, Dutch, Polish, Russian, Chinese, Japanese, Arabic, Turkish, Czech.

Technical

Does the widget slow down my site?
No. The widget loads asynchronously from our CDN. Under 50KB gzipped. It does not block page render.
Is it GDPR compliant?
Yes. Fully GDPR compliant. Data encrypted in transit and at rest. See privacy policy.
Does the AI really learn from chats?
Yes. With Auto-learn enabled, every closed conversation enriches the AI Brain. Replies get more accurate and personalized over time.
Can I use it on multiple sites?
Yes. Pro plan: up to 5 widgets. Business: unlimited. You can use the same key or create separate keys per site.

Billing

How do I cancel my subscription?
Dashboard โ†’ Billing โ†’ Cancel subscription. You keep access until the end of the billing period.
What payment methods are accepted?
All major credit/debit cards via PayPal, or pay directly with your PayPal account.
Do you offer annual billing?
Yes โ€” 20% discount on annual plans for both Pro and Business.

Troubleshooting

Common problems and how to fix them.

The widget doesn't appear on my site

Check the following:

  1. Plugin is activated (WP Admin โ†’ Plugins)
  2. You have an active account on chat.kokobeo.com
  3. Email has been verified
  4. API Key is correctly pasted in Settings (no leading/trailing spaces)
  5. Site cache is cleared (if using WP Rocket, LiteSpeed, etc.)
  6. Browser cache is cleared (Ctrl+Shift+R or Cmd+Shift+R)

I'm not receiving the verification email

  1. Check your spam/junk folder
  2. Add noreply@kokobeo.com to your contacts
  3. Try resending from the dashboard
  4. If still missing, contact info@kokobeo.com

The widget appears twice

This usually happens when two installation methods are active simultaneously. Solution:

  • Deactivate any other live chat plugin
  • If you had manually pasted the script in your theme before installing the plugin, remove it
  • Check header/footer injection plugins don't have duplicate code

Messages don't arrive in real-time

  • Check your internet connection
  • Make sure you're logged in to the dashboard
  • Check browser console (F12) for any errors
  • Firewall or ad-blocker may block WebSocket connections to chat.kokobeo.com

Can't find KokobeoChat in WordPress plugins search

Make sure to search for exactly "KokobeoChat" (one word, no spaces). If it still doesn't appear, use the manual installation method (upload .zip from wordpress.org/plugins/kokobeochat).

Get Support

We're here to help. Choose your preferred channel.

Business hours

Our team is available Monday-Friday, 9:00-18:00 CET. For technical emergencies on Business plans, priority support is available 24/7.

๐Ÿš€

Pro tip: when contacting support, include your API key (first 12 characters only) and a description of what you're trying to do. It helps us help you faster.