Possible Causes & Solutions:
Embed code not added: Verify embed code is present in your website's HTML
Wrong placement: Ensure code is placed before the </body> tag
Browser cache: Clear browser cache (Ctrl+F5 or Cmd+Shift+R)
Chatbot status: Check that chatbot is "Active" in your Markleyo dashboard
JavaScript disabled: Verify JavaScript is enabled in browser settings
HTTPS required: Your website must use HTTPS (not HTTP)
Test Steps:
Inspect your website code (Right-click → "Inspect")
Look for the Markleyo script tag
Check browser console for error messages
Copy error messages and contact support
Possible Causes & Solutions:
Knowledge base not trained: Add articles to your chatbot's knowledge base
AI model not selected: Verify AI model is configured in chatbot settings
AI instructions missing: Ensure you've set chatbot instructions
Integration not connected: Verify integrations (Facebook, WhatsApp, etc.) are properly connected
Rate limiting: If high volume of messages, may hit API limits temporarily
Troubleshooting:
Try asking a simple question (e.g., "Hello")
Check chatbot logs in Markleyo dashboard
Verify knowledge base articles are published
Test with different browsers
Contact support if issue persists
Possible Causes & Solutions:
Poor knowledge base: Articles contain incorrect information
Conflicting articles: Multiple articles with contradictory information
Insufficient training: Chatbot hasn't been trained on enough information
Weak instructions: Chatbot instructions don't provide enough guidance
How to Fix:
Review your knowledge base articles and other training material for accuracy
Check if articles contradict each other
Add more detailed training content
Provide clearer chatbot instructions
Use "Do Not Go Beyond Instructions" setting to keep chatbot focused
Test questions and adjust based on responses
Ensure if your training material has been trained with a "Trained" tag
Possible Causes & Solutions:
No agents configured: You don't have team members set up as agents
Agents offline: No agents are currently available
Escalation not enabled: Human agent handoff not enabled in chatbot settings
CRM Inbox not accessible: Agents can't access CRM Inbox
How to Fix:
Go to Team Members and add people as agents
Ensure agents have "Agent" role or appropriate permissions
Enable "Human Agent Support" in chatbot settings
Verify agents have access to CRM Inbox
Set "Office Hours" so customers know when agents are available
For Facebook Messenger:
Verify you have admin access to the Facebook page
Check Markleyo has permission to post on your behalf
Reconnect the integration and re-authorize
For WhatsApp (Twilio):
Verify Twilio Account SID and Auth Token are correct
Check WhatsApp phone number is active in Twilio
Ensure you're using correct format for phone number
For Telegram:
Verify Bot Token is correct (from BotFather)
Check bot hasn't been deactivated
Verify Markleyo has been given proper permissions
Q: How many chatbots can I create?
A: This depends on your plan. Most plans allow unlimited chatbots. Check your subscription details for exact limits.
Q: Can I use the same knowledge base for multiple chatbots?
A: Yes! When creating articles, you can select which chatbots should have access to each article.
Q: How often should I update my knowledge base?
A: Update whenever information changes—product pricing, policies, features, etc. Review quarterly at minimum.
Q: What languages does the chatbot support?
A: The chatbot supports 50+ languages including English, Spanish, French, German, Chinese, Japanese, Arabic, and more.
Q: Can the chatbot access external websites or databases?
A: Not by default. The chatbot only knows what you've trained it on. For external data, you'd need to regularly update your knowledge base or use API integrations.
Q: How is conversation data stored?
A: All conversations are securely stored in Markleyo's encrypted database. You can access conversation history anytime.
Q: Can I customize the chat bubble appearance?
A: Yes! You can customize colors, icon, position (left/right), and bubble text.
Q: Will the chatbot work with voice messages?
A: Text-based chatbots can't process voice, but you can encourage users to transcribe or type their message.
Q: How long does a conversation stay in the system?
A: Conversations are typically stored for 12 months. You can export conversations for archival.
Q: Can I use the chatbot for sales/commerce?
A: Yes! The chatbot can answer product questions, provide pricing, and help with checkout. For actual transactions, it can escalate to agents or provide payment links.
Q: What's the best way to train a new chatbot?
A: Start with your most critical information (FAQs, policies, products). Test the bot and refine based on conversation data. Gradually add more content.
Q: Can I see analytics for my chatbot?
A: Yes! Markleyo provides analytics showing conversation volume, user satisfaction, common questions, and escalation rates.
Q: What happens when the chatbot can't answer?
A: By default, the chatbot offers to connect to a human agent. You can customize this behavior through chatbot instructions.
Key Takeaways:
AI Chatbots automate customer conversations and support 24/7
Configure your chatbot with instructions, tone, and AI model selection
Train your chatbot with knowledge base articles for accuracy
Integrate with your website, Facebook Messenger, WhatsApp, and Telegram
Enable human agent handoff for complex conversations
Monitor performance through CRM Inbox and analytics
Quick Setup Timeline:
15 minutes: Create and configure chatbot
30 minutes: Build knowledge base articles
10 minutes: Embed on website or connect to integrations
30 minutes: Test and optimize
Next Steps:
Create your first chatbot
Build core knowledge base articles
Embed on your website
Test with customer scenarios
Monitor analytics and refine
For detailed help, visit our support center or contact [email protected]