Welcome to KokobeoChat
The complete documentation for installing, configuring and mastering KokobeoChat โ your AI-powered live chat for any website.
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
Install on WordPress
Use our official WordPress.org plugin with guided onboarding.
Train your AI
Upload your docs โ the AI learns from every conversation.
Go multilingual
Support visitors in 14 languages with real-time translation.
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.
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.
Verify your email
Open the email we sent you and click the verification link. This activates your account and generates your personal API key.
Copy your API Key
Log into your dashboard and go to API Keys. Copy your key โ it looks like kk_live_9f8a2b4c7d1e...
Install on your site
Choose your platform and follow the corresponding guide:
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
- Visitor opens your website โ widget loads from our CDN
- Visitor clicks the chat bubble โ chat window opens
- Visitor types message โ widget sends it to chat.kokobeo.com
- AI Brain analyzes message โ replies instantly OR routes to operator
- Operator sees the message in real-time โ replies from dashboard
- 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)
Open your WordPress admin
Navigate to yoursite.com/wp-admin and log in.
Add a new plugin
In the left menu go to Plugins โ Add New. In the search bar type KokobeoChat.
Install and activate
Click Install Now, then Activate.
Go to plugin settings
Settings โ KokobeoChat. You'll see a guided onboarding page with 3 colored buttons:
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.
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:
- Download from wordpress.org/plugins/kokobeochat
- WP Admin โ Plugins โ Add New โ Upload Plugin
- Select the .zip file โ Install โ Activate
- 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.
Open your theme code
Shopify Admin โ Online Store โ Themes โ Edit code.
Find theme.liquid
Under Layout, open theme.liquid. Scroll to the bottom and find the </body> tag.
Paste the widget script
Paste this line just before </body>:
<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.
Access Custom Code
Wix Editor โ Settings โ Custom Code โ + Add Custom Code.
Configure the code
Paste your widget script. Set:
- Name: KokobeoChat
- Add Code to: All Pages
- Place Code in: Body โ end
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):
<!-- 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
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
Open AI Brain in dashboard
Go to chat.kokobeo.com/client-admin.html โ click the AI Brain button in the sidebar.
Analyze your website
Paste your website URL and click Analyze. The AI generates a complete knowledge document automatically.
Upload documents
Drag and drop PDFs, product catalogs, FAQ files. The AI extracts the content and adds it to the Brain.
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.
- โ 1 operator
- โ 500 chats/month
- โ AI Brain basic
- โ 3 languages
- โ 5 operators
- โ Unlimited chats
- โ Full AI Brain + auto-learn
- โ All 14 languages
- โ Analytics & reviews
- โ No 'Powered by'
- โ 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
Technical
Billing
Troubleshooting
Common problems and how to fix them.
The widget doesn't appear on my site
Check the following:
- Plugin is activated (WP Admin โ Plugins)
- You have an active account on chat.kokobeo.com
- Email has been verified
- API Key is correctly pasted in Settings (no leading/trailing spaces)
- Site cache is cleared (if using WP Rocket, LiteSpeed, etc.)
- Browser cache is cleared (Ctrl+Shift+R or Cmd+Shift+R)
I'm not receiving the verification email
- Check your spam/junk folder
- Add
noreply@kokobeo.comto your contacts - Try resending from the dashboard
- 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.
Live Chat
Fastest response. Chat with our team directly from our website.
Email Support
Send us your question at info@kokobeo.com โ response in 24h.
WordPress Forum
Community support on the official WordPress.org plugin forum.
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.