Chatyllo Documentation

1. Introduction

What is Chatyllo?

Chatyllo is an AI-powered chatbot plugin for WordPress that allows your website visitors to ask questions and receive instant, accurate answers based on your actual site content. Unlike generic chatbot solutions that require complex configuration or external services, Chatyllo integrates directly into your WordPress dashboard and learns from your pages, posts, products, and FAQs automatically.

Whether you run an online store, a service business, a blog, or a SaaS product, Chatyllo provides 24/7 automated customer support that actually knows what your business offers.

Key Benefits

• Instant answers from your content — Chatyllo reads and indexes your WordPress content, so it answers questions using your own words and data.
• Works on every plan — Even the free plan includes smart FAQ matching, so every site gets a working chatbot out of the box.
• AI-powered intelligence — Premium plans use AI to understand complex questions and provide conversational, context-aware responses.
• WooCommerce-ready — Automatically indexes products, prices, attributes, stock status, and variations.
• GDPR-compliant — Built-in consent banner, IP anonymization, data export, and compatibility with popular cookie plugins.
• Zero coding required — Install, activate, and your chatbot is live. Customize everything from the WordPress admin panel.
• Automatic fallback — When AI is unavailable, the chatbot seamlessly switches to FAQ mode so visitors always get answers.
• Multilingual — 13 built-in languages with automatic detection based on your WordPress locale.

Who Is Chatyllo For?

Chatyllo is designed for WordPress site owners who want to provide automated, intelligent customer support without the complexity or cost of enterprise chat solutions. It is ideal for:

• E-commerce store owners using WooCommerce
• Service businesses that receive repetitive questions
• Bloggers and content creators who want to help readers find articles
• SaaS companies with documentation and help pages
• Agencies managing multiple client sites (Agency plan)

Free vs Premium Overview

Chatyllo works immediately on the Free plan with smart FAQ matching. Premium plans unlock AI-powered responses, knowledge base indexing, custom branding, advanced analytics, and more. See the full Plans & Pricing comparison for details.

System Requirements

2. Installation & Activation

2.1 Installing from WordPress.org

The easiest way to install Chatyllo is directly from the WordPress plugin repository.

1. Log in to your WordPress admin dashboard.
2. Navigate to Plugins → Add New in the left sidebar.
3. In the search box at the top right, type Chatyllo.
4. Locate the Chatyllo plugin in the results (look for the WPezo author name) and click Install Now.
5. Once the installation completes, click Activate.

2.2 Installing via ZIP Upload

If you have downloaded the Chatyllo plugin as a ZIP file (for example, from a premium purchase), you can install it manually.

1. Download the Chatyllo ZIP file to your computer.
2. Log in to your WordPress admin dashboard.
3. Go to Plugins → Add New.
4. Click the Upload Plugin button at the top of the page.
5. Click Choose File and select the downloaded ZIP file.
6. Click Install Now and wait for the upload to complete.
7. Click Activate Plugin.

2.3 Activating Premium

If you have purchased a premium plan (Starter, Business, or Agency), you need to activate your license to unlock premium features.

1. In your WordPress admin, go to Chatyllo → Account.
2. If prompted, enter the license key you received via email after purchase.
3. Alternatively, click the Upgrade button within the plugin to purchase a premium plan directly. Freemius will handle the payment and licensing automatically.
4. Once activated, premium features become available immediately. You will see a confirmation notice and your plan name displayed on the Account page.

2.4 First Steps After Activation

After activating Chatyllo, follow these steps to get your chatbot up and running:

1. Visit Chatyllo → Dashboard to see the main overview screen.
2. Follow the Getting Started checklist displayed on the dashboard. It guides you through the essential configuration steps.
3. The chatbot is automatically enabled on activation with the Free plan in FAQ-only mode. This means visitors can already interact with the widget on your site.
4. Add a few FAQ entries to give the chatbot some content to work with right away.
5. If you are on a premium plan, go to Settings → Knowledge to enable content indexing so the AI can learn from your site.

3. Dashboard

3.1 Overview

The Chatyllo Dashboard is the first screen you see when you open the plugin. It provides a high-level summary of your chatbot's activity and quick access to common actions.

Stats Cards

At the top of the dashboard, four summary cards display key metrics:

• Total Chats — The total number of conversation sessions recorded.
• AI Responses — The number of responses generated by the AI engine (Premium only; shows 0 on Free).
• Knowledge Entries — The number of content items currently indexed in the knowledge base.
• FAQ Entries — The total number of FAQ entries you have created (manual and AI-generated combined).

Quick Actions

The Quick Actions section provides one-click access to frequently used operations:

• Open the Settings page
• Create a new FAQ entry
• View Chat Logs
• Rebuild Knowledge Base (Business+ plans)

System Info Sidebar

On the right side of the dashboard, a System Info panel shows your current environment details including WordPress version, PHP version, Chatyllo version, active plan, and AI status.

3.2 AI Usage Meters Premium

Premium plans include daily and monthly AI usage meters displayed prominently on the dashboard. These meters show how many AI requests you have used and how many remain.

How Limits Work

Each premium plan has a set number of AI requests allowed per day and per month. When a visitor asks a question and the AI generates a response, one request is consumed. FAQ-only responses do not count toward AI limits.

What Happens When Limits Are Reached

When either the daily or monthly limit is reached, Chatyllo automatically switches to FAQ-only mode for the remainder of the period. Visitors will still receive answers from your FAQ database, but AI-generated responses will be paused until the limit resets.

When Limits Reset

• Daily limit: Resets at midnight server time every day.
• Monthly limit: Resets on the 1st of each month at midnight server time.

3.3 Getting Started Checklist

New installations display a Getting Started checklist to help you configure the essential settings. The checklist tracks your progress and marks items as complete when you finish them:

1. Enable Chatbot — Verify the chatbot is turned on (it is enabled by default).
2. Set Welcome Message — Customize the first message visitors see when they open the chat.
3. Add FAQs — Create at least a few FAQ entries to provide immediate answers.
4. Index Content — Enable knowledge base indexing to let AI learn from your content (Premium).
5. Set Privacy Policy — Add your privacy policy URL for GDPR compliance.

4. Settings

The Settings page is organized into tabs, each controlling a specific aspect of the chatbot. Navigate between tabs to configure appearance, behavior, knowledge, branding, messages, display rules, and advanced options.

4.1 Appearance Tab

Controls how the chat widget looks on your website.

Widget Position

Choose where the chat bubble appears on your site: Bottom Right (default) or Bottom Left. The widget will float in the selected corner on all pages where it is displayed.

Primary Color

Sets the main color used for the chat bubble, the header bar of the chat panel, and user message bubbles. Click the color picker to choose any color that matches your brand. The default is Chatyllo's signature indigo (#4F46E5).

Header & User Message Text Color

Sets the text color used in the chat header and inside user message bubbles. Typically white (#FFFFFF) for dark primary colors, or dark for lighter primary colors. Adjust this to ensure readability against your chosen primary color.

Widget Size

Choose from three size presets:

• Small — Compact widget suitable for minimalist designs.
• Medium — The default balanced size for most websites.
• Large — A more prominent widget for sites that prioritize customer support.

Bot Name

The name displayed in the chat header. This is what visitors see as the name of your chatbot assistant. For example: "Support Bot", "Ask us anything", or your brand name. The default value is "Chatyllo".

Bot Avatar Starter+

Upload a custom image to use as the bot's avatar in the chat panel. The recommended size is 80x80 pixels in a square format (JPG or PNG). The avatar appears next to bot messages in the conversation.

Show on Mobile

Toggle whether the chat widget is visible on mobile devices. When disabled, the widget will only appear on desktop and tablet screens. Enabled by default.

Sound Effects

Toggle notification sounds when the chatbot sends a response. A subtle chime plays when a new bot message appears. Useful for alerting visitors who may have scrolled away from the chat.

4.2 Behavior Tab

Controls how the chatbot behaves and processes conversations.

Enable Chatyllo

The master switch for the chatbot. When turned off, the widget is completely hidden from all visitors. Use this to temporarily disable the chatbot without changing any other settings. Enabled by default.

AI Tone Starter+

Sets the conversational style of AI responses. Choose from:

• Professional — Formal, businesslike tone suitable for corporate and B2B sites.
• Friendly — Warm and approachable, ideal for most consumer-facing websites.
• Casual — Relaxed and conversational, works well for creative brands and community sites.

Max Response Length Starter+

Controls the maximum number of tokens the AI uses when generating a response. The range is 100 to 800 tokens. Lower values produce shorter, more concise answers. Higher values allow for more detailed explanations. The default is 300, which provides a good balance between completeness and readability.

Conversation Memory Starter+

The number of previous messages the AI remembers during a conversation. A higher value allows the AI to maintain more context over longer conversations, but uses more tokens per request. The default is 10 messages. Adjust based on the typical length of conversations on your site.

Typing Indicator

When enabled, a visual typing animation (three bouncing dots) is displayed while the AI or FAQ engine is processing a response. This provides visitors with feedback that their message is being handled.

Log Conversations

When enabled, all conversations are saved and can be reviewed in the Chat Logs section. When disabled, no conversation data is stored. Consider your privacy obligations and local regulations before enabling this feature.

Log Retention

The number of days that conversation logs are retained before they are automatically deleted during maintenance. Retention limits vary by plan:

4.3 Knowledge Tab Starter+

Controls what content Chatyllo indexes for AI-powered responses.

Content Type Toggles

Enable or disable indexing for each content type:

• Index Posts — Include your blog posts in the knowledge base.
• Index Pages — Include your WordPress pages (About, Services, Contact, etc.).
• Index WooCommerce Products — Include product data (requires WooCommerce to be active).
• Index Site Info — Include general site information (site name, tagline, menu structure).

Custom Post Types Business+

Business and Agency plans can enable indexing for custom post types registered by your theme or other plugins. This allows the AI to learn from portfolio items, testimonials, team members, events, or any other custom content.

Exclude Posts / Exclude Pages

Use the search-and-pick fields to exclude specific posts or pages from the knowledge base. Start typing a title to search, then click to add it to the exclusion list. This is useful for removing irrelevant content like login pages, cart pages, checkout pages, or internal-only pages.

Auto-Indexing Schedule

Chatyllo automatically re-indexes your content on a regular schedule to keep the knowledge base up to date:

• Starter: Weekly auto-indexing.
• Business / Agency: Every 12 hours.

Manual Reindex Business+

Business and Agency users can trigger a manual knowledge base rebuild at any time from the Dashboard Quick Actions section or the Knowledge Base page. Use this after making significant content changes that you want reflected immediately.

4.4 Branding Tab

Controls the branding displayed at the bottom of the chat widget.

Branding Options

• Powered by Chatyllo (All plans) — Displays the default "Powered by Chatyllo" text with a link. This is the default for all plans.
• Hidden Business+ — Completely removes the branding footer from the widget.
• Custom / White-label Agency — Replace the branding with your own custom footer text. Enter any text you want displayed, such as your company name or a custom message.

4.5 Messages Tab

Customize the text messages displayed by the chatbot in various situations.

Welcome Message

The first message displayed when a visitor opens the chat widget. Use this to greet visitors and let them know what the chatbot can help with. For example: "Hi there! I can help you find information about our products and services. What would you like to know?"

Input Placeholder

The placeholder text shown in the message input field before the visitor starts typing. For example: "Type your question here..." or "Ask me anything about our products".

Off-Topic Response

The message displayed when the AI determines that a question is not related to your site content. This helps redirect visitors back to relevant topics. For example: "I'm designed to help with questions about our products and services. Could you rephrase your question, or would you like to know about something specific we offer?"

AI Offline Message

The message displayed when the AI service is temporarily unavailable and the chatbot switches to FAQ mode. For example: "Our AI assistant is temporarily offline. I'll do my best to answer using our FAQ database. For complex questions, please contact us at support@yoursite.com."

No FAQ Match Message

The message displayed when a visitor's question does not match any FAQ entry and no AI response is available. For example: "I couldn't find an answer to that question. Try rephrasing, or contact us directly at support@yoursite.com for assistance."

4.6 Display Rules Tab

Controls where and for whom the chat widget appears on your site.

Show on All Pages

When enabled (default), the chatbot appears on every page of your site. Disable this to use the whitelist or blacklist options below.

Show Only on Pages (Whitelist)

When "Show on All Pages" is disabled, use this field to specify exactly which pages should display the chatbot. Use the search-and-pick selector to find and add pages by title. Only the listed pages will show the widget.

Hide on Pages (Blacklist)

When "Show on All Pages" is enabled, use this field to exclude specific pages from displaying the chatbot. Use the search-and-pick selector to find and add pages. The widget will appear everywhere except on the listed pages. Common exclusions include checkout, login, and admin pages.

Show for Roles

Restrict the chatbot to specific WordPress user roles. Leave empty to show the widget to everyone (including logged-out visitors). When roles are selected, only logged-in users with those roles will see the widget. This is useful for internal support bots or member-only sites.

How Search-and-Pick Selectors Work

All page selection fields use a search-and-pick interface. Start typing the title of a page or post, and matching results appear in a dropdown. Click a result to add it to the list. Click the remove button next to any item to remove it. The selector searches across pages, posts, and custom post types.

4.7 Advanced Tab

Advanced configuration options for privacy, data management, and maintenance.

Privacy & GDPR

Chatyllo includes comprehensive privacy features to help you comply with GDPR and other data protection regulations.

• Privacy Policy URL — Enter the URL of your site's privacy policy page. This link is displayed in the consent banner and accessible from the chat widget.
• Require Consent Before Logging — When enabled, visitors must explicitly accept the privacy notice before any conversation data is logged. The chat still works without consent, but no data is stored.
• Anonymize IP Addresses — When enabled, visitor IP addresses are masked before being stored (the last octet is replaced with 0). For example, 192.168.1.45 becomes 192.168.1.0.
• Anonymize Browser Info — When enabled, detailed browser and device information is not stored with conversation logs.
• WordPress Privacy Tools Integration — Chatyllo integrates with the WordPress built-in privacy tools (Tools → Export/Erase Personal Data), allowing you to include chatbot conversation data in personal data exports and erasure requests.

Cookie Plugin Compatibility

Chatyllo is compatible with the following popular cookie consent plugins:

• CookieYes
• Complianz
• CookieBot
• iubenda

When one of these plugins is detected, Chatyllo respects the visitor's cookie consent preferences automatically. Conversation logging is only enabled after consent is given through the cookie plugin.

Data Preservation

Keep Data When Plugin Is Deleted — When enabled, all Chatyllo data (settings, FAQs, knowledge base, logs) is preserved in the database even if you delete the plugin. This is useful if you plan to reinstall later. When disabled, all data is removed on plugin deletion.

Export / Import

Export Data (JSON) — Click the Export button to download a complete backup of your Chatyllo configuration and FAQ data as a JSON file. This file can be used for backup purposes or to transfer settings to another site.

Maintenance

Chatyllo performs automatic weekly maintenance to keep your database clean and optimized.

• Auto Maintenance — Runs weekly to clean expired data, optimize database tables, and remove orphan records.
• Manual Maintenance — Click the "Run Maintenance" button to trigger maintenance immediately.

Maintenance performs the following operations:

• Cleans conversation logs older than your retention period
• Removes expired cache entries
• Deletes orphan data (entries without associated sessions)
• Optimizes database tables for faster queries

4.8 Widget Preview & Quick Help

The right sidebar of the Settings page contains two helpful tools:

Live Widget Preview

A real-time preview of the chat widget that updates as you change settings. See how your color, size, name, and avatar changes look before saving. The preview reflects your current unsaved settings so you can experiment freely.

Quick Help Accordion

An expandable FAQ section with answers to the 8 most common configuration questions, including topics like changing colors, hiding the widget on specific pages, and enabling GDPR consent. Click any question to expand and read the answer.

5. FAQ / Smart Q&A

5.1 How FAQ Matching Works

Chatyllo includes a smart keyword matching algorithm that works on all plans, including the Free plan. When a visitor asks a question, the system compares it against your FAQ database using multiple matching strategies:

1. Exact Match — If the visitor's question exactly matches an FAQ question (case-insensitive), that FAQ answer is returned immediately.
2. Contains Match — If the FAQ question text is contained within the visitor's message, it scores high.
3. Keyword Match — The system checks the visitor's message against the keywords you defined for each FAQ entry.
4. Word Overlap Scoring — The algorithm calculates how many significant words overlap between the visitor's message and the FAQ question, producing a relevance score.

The FAQ with the highest combined score above the confidence threshold is returned as the answer. If no FAQ meets the threshold, the "No FAQ Match" message is displayed (or the AI takes over on premium plans).

5.2 Creating Manual FAQs

To create a new FAQ entry, go to Chatyllo → FAQ and click the Add New FAQ button. Fill in the following fields:

• Question — The question text as a visitor would ask it. Write naturally, as if a customer is speaking. For example: "What are your shipping rates?"
• Answer — The response the chatbot will provide. You can use plain text. Keep answers concise but complete.
• Keywords — Comma-separated keywords that help the matching algorithm. For the shipping example: "shipping, delivery, rates, cost, how much, ship". Add variations and synonyms.
• Category — An optional label to organize your FAQs (e.g., "Shipping", "Returns", "General"). Categories are used for filtering in the admin panel.
• Language — The language of this FAQ entry. Used for multilingual sites to match the visitor's language.
• Priority — A numeric value (1-100) that determines which FAQ is shown when multiple entries match. Higher priority FAQs are preferred. Default is 10.
• Active — Toggle to enable or disable this FAQ entry. Inactive entries are ignored by the matching algorithm.

Tips for Writing Effective FAQs

• Write questions in natural language, the way a real customer would ask.
• Add multiple keyword variations including slang, abbreviations, and common misspellings.
• Keep answers under 200 words for best readability in the chat widget.
• Use higher priority for your most important or frequently asked questions.
• Create multiple FAQ entries for the same topic with different phrasings to improve matching.

5.3 AI FAQ Generation Starter+

Premium users can generate FAQ entries automatically using AI. The AI analyzes your indexed content and creates relevant question-and-answer pairs.

How It Works

1. Go to Chatyllo → FAQ.
2. Click the Generate AI FAQs button.
3. Select the language for the generated FAQs.
4. The AI reads your indexed knowledge base and generates Q&A pairs based on the most important topics in your content.
5. Generated FAQs are added to your FAQ list with the source marked as "AI Generated".

Per-Plan Limits

Deduplication

When generating AI FAQs, Chatyllo checks for existing entries that cover the same topic. If a similar FAQ already exists, it is updated rather than duplicated. This means you can safely run AI generation multiple times without cluttering your FAQ list.

5.4 Managing FAQs

The FAQ list page shows all your FAQ entries in a paginated table. You can filter by:

• All Categories — Filter by any category you have defined.
• All Sources — Filter by source type: Manual or AI Generated.

Each entry in the list shows the question, category, source, priority, and active status. Use the action buttons to:

• Edit — Open the FAQ for editing. All fields can be modified.
• Delete — Permanently remove the FAQ entry.
• Activate / Deactivate — Toggle the FAQ on or off without deleting it.

5.5 FAQ as AI Supplement

On premium plans where AI is active, the FAQ database serves as supplementary knowledge for the AI engine. When the AI generates a response, it considers both the indexed knowledge base and your FAQ entries. This means well-written FAQs improve the quality and accuracy of AI responses.

6. Knowledge Base Starter+

6.1 What Gets Indexed

The knowledge base is the AI's primary source of information about your site. When indexing is enabled, Chatyllo processes the following content types:

• Pages — All published WordPress pages including title, content, and excerpt.
• Posts — All published blog posts including title, content, excerpt, and categories.
• WooCommerce Products — Product title, description, short description, regular and sale prices (including variable product price ranges), attributes with labels, weight, dimensions, stock status, and tags.
• Site Info — Your site name, tagline/description, and navigation menu structure.
• Custom Post Types Business+ — Any registered custom post type such as portfolios, testimonials, events, team members, etc.

6.2 Auto-Indexing Schedule

Chatyllo automatically re-indexes your content on a regular schedule to keep the knowledge base current with your latest changes.

Business and Agency plans also include real-time WordPress hooks (save_post, delete_post) that trigger incremental re-indexing when content is published, updated, or deleted.

6.3 Manual Reindex Business+

Business and Agency users can manually trigger a full knowledge base rebuild. This is useful after bulk content changes, theme switches, or initial setup.

To rebuild manually:

• Go to Chatyllo → Dashboard → Quick Actions → Rebuild Knowledge Base, or
• Go to Chatyllo → Knowledge Base and click the Rebuild button.

6.4 Excluding Content

You may have pages or posts that should not be included in the chatbot's knowledge. Examples include login pages, shopping cart, checkout, privacy policy (the chatbot should link to it, not recite it), and internal or draft-like pages.

To exclude content:

1. Go to Chatyllo → Settings → Knowledge.
2. In the Exclude Posts or Exclude Pages field, start typing the title of the content you want to exclude.
3. Select the item from the dropdown results.
4. Click Save Settings.

Excluded content will be removed from the knowledge base at the next indexing cycle.

6.5 WooCommerce Integration

Chatyllo provides deep WooCommerce integration by indexing comprehensive product data.

What Is Indexed Per Product

• Product title and full description
• Regular price and sale price
• Variable product price ranges (e.g., "$19.99 - $39.99")
• Product attributes with their labels (e.g., Color: Red, Blue, Green)
• Weight and dimensions
• Stock status (In Stock, Out of Stock, On Backorder)
• Product tags

Example Questions the Chatbot Can Answer

• "How much does the Blue T-Shirt cost?"
• "What colors is the Classic Hoodie available in?"
• "Is the Wireless Mouse in stock?"
• "What are the dimensions of the Oak Dining Table?"
• "Do you have any products under $50?"

7. Chat Logs

7.1 Session-Based View

The Chat Logs page displays conversations grouped by session. Each row represents a single conversation session between a visitor and the chatbot. The table includes the following columns:

• Started — The date and time the conversation began.
• Session ID — A unique identifier for the session.
• First Message — The first message sent by the visitor, giving you a quick overview of the topic.
• Messages — The total number of messages exchanged in the conversation (both visitor and bot messages).
• Mode — The response mode used: AI (AI-generated responses) or FAQ (FAQ matching only).
• Tokens — The total number of AI tokens consumed by the conversation (0 for FAQ-only sessions).
• Duration — The time between the first and last message in the conversation.

7.2 Conversation Details

Click any session row to expand and view the complete conversation. The detail view shows:

• All visitor messages and bot responses in chronological order
• Timestamps for each message
• The response mode used for each bot message (AI or FAQ)
• Visitor's browser and operating system information (if not anonymized)
• The page URL where the conversation started
• The referrer URL (the page the visitor came from)

7.3 Log Retention

Conversation logs are automatically deleted when they exceed the retention period for your plan. Cleanup occurs during the weekly maintenance cycle.

7.4 Privacy & Consent

When the "Require Consent Before Logging" setting is enabled, the chatbot displays a consent banner before logging begins. Conversations that occur before the visitor accepts the consent notice are not logged. The chat still functions normally, but no data is written to the database.

When anonymization settings are enabled, stored data has IP addresses masked and browser information removed, ensuring that individual visitors cannot be identified from the logs.

8. Statistics

8.1 Period Selection

At the top of the Statistics page, select the time period for data analysis:

• Last 7 days — A quick snapshot of the past week.
• Last 30 days — The default monthly view.
• Last 90 days — A quarterly overview.
• All time — All recorded data since installation.

8.2 Available Metrics

The Statistics page provides a comprehensive view of chatbot performance through several sections:

Summary Cards

• Total Messages — The total number of messages sent and received during the selected period.
• Conversations — The number of unique conversation sessions.
• Average Response Time — The mean time between a visitor sending a message and the bot responding.
• Tokens Used — The total AI tokens consumed (Premium only).

Daily Activity Chart

A visual chart showing the number of conversations per day over the selected period. Use this to identify peak usage days and trends over time.

Response Modes Breakdown

A breakdown of responses by mode (AI vs FAQ), showing the percentage and count for each. This helps you understand how much your chatbot relies on AI versus FAQ matching.

Top Pages

A list of the pages where visitors most frequently start conversations. Use this to identify which pages generate the most questions and may need additional content or FAQ coverage.

Devices and Browsers

A breakdown of conversations by device type (Desktop, Mobile, Tablet) and browser (Chrome, Firefox, Safari, Edge, etc.). This helps you understand your chatbot audience and ensure the widget works well on the most common devices.

Session Quality

Metrics that indicate how well the chatbot is performing, such as the average number of messages per session and the percentage of sessions where the chatbot successfully provided an answer.

8.3 CSV Export

Click the Export CSV button to download all statistics data for the selected period as a CSV file. The export includes all metrics, daily breakdowns, and session data. Use this for offline analysis, reporting, or importing into spreadsheet applications.

9. Service Status

9.1 Current Status

The Service Status page shows the real-time status of the Chatyllo AI service. The status is indicated with a clear visual indicator:

• Operational — The AI service is running normally. All AI features are available.
• Degraded — The service is experiencing slowdowns or intermittent issues. Responses may be delayed.
• Outage — The AI service is currently unavailable. The chatbot has automatically switched to FAQ-only mode.

The status is auto-checked every 5 minutes. You can also click the Refresh button to check the status manually at any time.

9.2 30-Day Timeline

Below the current status, a visual timeline displays the service status for the last 30 days using color-coded bars:

• Green = Operational
• Yellow = Degraded performance
• Red = Service outage
• Gray = No data available

Hover over any day in the timeline to see the specific status details for that day.

9.3 Automatic Fallback

Chatyllo is designed so that visitors always receive answers, regardless of AI service availability. When the AI service is degraded or offline, the chatbot seamlessly switches to FAQ-only mode. Visitors are not informed of the switch; they simply receive answers from the FAQ database instead of AI-generated responses. When the AI service recovers, the chatbot automatically resumes AI responses.

10. The Chat Widget

10.1 How It Looks

The Chatyllo chat widget consists of two main elements:

• Chat Bubble — A floating circular button positioned in the bottom-right or bottom-left corner of the page (configurable). It displays the Chatyllo icon and pulses gently to attract attention. Clicking it opens the chat panel. The Chatyllo icon in the bubble is standard across all plans for brand consistency.
• Chat Panel — When opened, a chat window slides up from the bubble. It contains a header bar (with the bot name and close button), a messages area showing the conversation, and an input field at the bottom where visitors type their questions.

The widget is styled using CSS isolation techniques (scoped styles and !important rules) to prevent conflicts with your theme's CSS. It should look consistent regardless of which WordPress theme you use.

10.2 Conversation Flow

When a visitor sends a message, the following process occurs:

1. The visitor's message appears in the chat panel.
2. A typing indicator is displayed (if enabled).
3. If AI is active (Premium): The message is sent to the Chatyllo proxy service, which processes it against the knowledge base and generates a contextual AI response.
4. If AI is unavailable or on the Free plan: The message is processed by the local FAQ smart matching algorithm.
5. If no FAQ match is found: The configured "No FAQ Match" message is displayed.
6. The bot's response appears in the chat panel.

10.3 Session Management

Each conversation is tracked by a unique session ID stored in the visitor's browser using localStorage. This session ID maintains the conversation context within a single browsing session. If the visitor closes the browser and returns later, a new session is created.

The AI uses conversation memory (configurable in Settings) to maintain context across multiple messages within a session. When the number of messages exceeds the memory limit, the oldest messages are dropped from context to keep within token limits. The session ID is automatically rotated as needed.

10.4 GDPR Consent Banner

When the "Require Consent Before Logging" setting is enabled, visitors see a privacy notice when they first open the chat widget. The notice includes:

• A brief message explaining that the conversation may be logged
• An "Accept & Chat" button to provide consent
• A link to your Privacy Policy (configured in Settings)

The chat is fully functional regardless of whether the visitor accepts. If they do not accept, the conversation works normally but nothing is logged to the database. Once accepted, the consent is stored and the banner does not appear again during the session.

10.5 Mobile Behavior

On mobile devices, the chat panel expands to fill the entire screen when opened, providing a comfortable full-screen chat experience. The chat bubble remains in the corner and is sized appropriately for touch interaction.

If you prefer not to show the chatbot on mobile devices (for example, if your site has a mobile-specific support flow), you can disable it via Settings → Appearance → Show on Mobile.

11. Plans & Pricing

Chatyllo offers four plans to suit businesses of all sizes. All plans include the core chatbot widget and FAQ matching. Premium plans unlock AI responses, knowledge base indexing, and advanced features.

How to Upgrade

You can upgrade to a premium plan directly from your WordPress admin panel:

1. Go to Chatyllo → Account (or click the "Upgrade" link in the Chatyllo menu).
2. Select the plan that best fits your needs.
3. Complete the checkout process through Freemius secure payment.
4. Premium features are activated immediately after payment.

What Happens on Downgrade

If you downgrade from a higher plan to a lower one (or cancel and revert to Free), the following happens:

• AI-generated FAQ entries that exceed the lower plan's limits are deactivated (not deleted). They can be reactivated if you upgrade again.
• Feature limits are enforced immediately for the new plan level.
• Knowledge base entries remain in the database but are not used if the new plan does not support AI indexing.
• Your settings are preserved and will take effect again if you re-upgrade.

Billing

All billing is handled by Freemius. Subscriptions are billed monthly or annually (annual plans offer a discount). You can manage your subscription, update payment methods, cancel, and download invoices from the Freemius account panel accessible via Chatyllo → Account.

12. Use Cases & Examples

The following examples illustrate how Chatyllo works in different types of websites. Each example includes a sample conversation and a practical tip for getting the best results.

12.1 E-Commerce Store (WooCommerce)

Chatyllo excels at handling product-related questions for WooCommerce stores.

Example Conversation:

Visitor: What sizes does the Blue T-Shirt come in?

Chatyllo: The Blue T-Shirt is available in the following sizes:
Small, Medium, Large, and XL. The price ranges from $19.99
to $24.99 depending on the size. It is currently in stock.
Would you like to know anything else about this product?

The chatbot reads the product attributes (Size: S, M, L, XL), pricing data, and stock status directly from WooCommerce and formats a natural answer.

12.2 Service Business

Service businesses can use Chatyllo to answer common questions about offerings, pricing, and availability.

Example Conversation:

Visitor: Do you offer web design services?

Chatyllo: Yes! We offer comprehensive web design services
including custom WordPress development, responsive design,
e-commerce solutions, and website redesigns. Our projects
typically start at a consultation to understand your needs.
You can learn more on our Services page or contact us at
hello@example.com to discuss your project.

The AI pulls information from your Services page and combines it with site info to provide a relevant answer.

12.3 Blog / Educational Site

For content-heavy sites, Chatyllo helps visitors discover relevant articles and resources.

Example Conversation:

Visitor: Do you have articles about SEO?

Chatyllo: Yes, we have several articles about SEO! Here are
some relevant posts: "Beginner's Guide to SEO in 2026",
"10 On-Page SEO Techniques That Actually Work", and
"How to Do Keyword Research Step by Step". Would you like
to know more about any specific SEO topic?

12.4 SaaS / Digital Product

SaaS companies and digital product sellers can use Chatyllo to provide instant support from documentation and help pages.

Example Conversation:

Visitor: How do I reset my password?

Chatyllo: To reset your password, click the "Forgot Password"
link on the login page. Enter your email address and click
"Reset Password". You'll receive an email with a link to
create a new password. The link expires after 24 hours. If
you don't receive the email, check your spam folder or
contact support@example.com for assistance.

13. Tips & Best Practices

Follow these recommendations to get the most out of Chatyllo:

1. Keep FAQs updated. FAQs are the foundation of your chatbot. They serve as the primary response source on the Free plan and as a fallback for premium plans. Review and update them regularly.
2. Use AI FAQ generation monthly. Run the AI FAQ generator each month to automatically create Q&A pairs from your latest content. This catches new topics and keeps your FAQ database current.
3. Customize the welcome message. Set a welcome message that reflects your brand voice and tells visitors what the chatbot can help with. A good welcome message sets expectations and encourages engagement.
4. Configure the Off-Topic Response thoughtfully. Instead of a generic "I can't help with that", guide visitors back to relevant topics or suggest they contact support directly.
5. Include contact information in fallback messages. Add your support email or phone number to the "No FAQ Match" and "AI Offline" messages so visitors always have a way to reach a human.
6. Monitor Statistics weekly. Check the Statistics page regularly to see what visitors ask most. Use this data to create new FAQ entries, improve existing content, and identify gaps in your knowledge base.
7. Exclude irrelevant pages from indexing. Remove login pages, cart, checkout, account pages, and other non-informational pages from the knowledge base. This improves AI accuracy by reducing noise.
8. Enable GDPR consent if you operate in the EU. Turn on the consent banner and configure your privacy policy URL. Enable IP and browser anonymization for maximum compliance.
9. Use the Business plan for WooCommerce stores. The real-time content sync ensures product changes are reflected immediately, and manual reindexing lets you update on demand.
10. Test the widget on mobile before going live. Open your site on a phone or use browser developer tools to check the mobile experience. Ensure the widget does not overlap important content or navigation elements.

14. Troubleshooting

14.1 Widget Not Showing

If the chat widget is not visible on your site, check the following:

• Enable Chatyllo is ON: Go to Chatyllo → Settings → Behavior and verify the "Enable Chatyllo" toggle is turned on.
• Check Display Rules: Go to Settings → Display Rules and verify the page you are testing is not blacklisted. If using the whitelist mode, confirm the page is included.
• Check Show on Mobile: If testing on a mobile device, ensure Settings → Appearance → Show on Mobile is enabled.
• Check for JavaScript errors: Open your browser's developer tools (F12), go to the Console tab, and look for any JavaScript errors. Errors from other plugins or the theme may prevent Chatyllo from loading.
• Theme conflicts: Temporarily switch to a default WordPress theme (such as Twenty Twenty-Four) to determine if the issue is caused by your theme. If the widget appears with the default theme, contact your theme's support for assistance.
• Caching: If you use a caching plugin (WP Super Cache, W3 Total Cache, LiteSpeed Cache, etc.), clear all caches and test again. Cached versions of your pages may not include the chatbot script.

14.2 AI Not Responding Premium

If the AI is not generating responses on a premium plan:

• Check AI Status: Go to Chatyllo → Dashboard and check the AI Status indicator.
• Check Service Status: Visit the Service Status page for detailed availability information.
• Check AI Usage Meters: Review the daily and monthly usage meters on the Dashboard. If limits are reached, the chatbot has automatically switched to FAQ mode until the limit resets.
• Refresh AI Status: Click the refresh button on the Dashboard to re-check the connection to the AI service.
• Wait and retry: If the service status shows degraded or outage, wait 5 minutes and try again. The proxy service may be restarting or undergoing maintenance.

14.3 FAQ Not Matching

If visitors' questions are not matching your FAQ entries:

• Check Active status: Ensure the FAQ entry is marked as Active. Inactive entries are ignored by the matching algorithm.
• Add more keywords: Open the FAQ entry and add more keyword variations, including synonyms, common abbreviations, and alternative phrasings.
• Use natural language: Write the Question field in the way a real customer would ask. The algorithm compares visitor messages against the question text.
• Adjust Priority: If multiple FAQs could match, increase the priority of the most relevant one. Higher priority entries are preferred when scores are close.
• Test different phrasings: Try asking the question in different ways in the chat widget to understand how the matching works for your specific entries.

14.4 Knowledge Base Empty

If the knowledge base shows zero entries:

• Rebuild: Go to the Knowledge Base page and click the Rebuild button (Business+ plans) or wait for the next auto-index cycle.
• Check content type toggles: Go to Settings → Knowledge and ensure at least one content type (Posts, Pages, Products) is enabled for indexing.
• Check for published content: Only published content is indexed. Drafts, private posts, and password-protected content are excluded.
• WooCommerce products: Ensure WooCommerce is active and you have published products. Product indexing requires WooCommerce to be installed and activated.

14.5 Widget Styling Issues

If the chat widget looks incorrect or conflicts with your theme:

• CSS isolation: Chatyllo uses !important rules and scoped selectors to prevent theme conflicts. In most cases, the widget should render correctly regardless of the theme.
• Clear browser cache: If colors or styles look wrong after changing settings, clear your browser cache (Ctrl+Shift+Delete) and reload the page.
• Custom CSS override: If you need to override specific styles, use a CSS selector with higher specificity targeting the #chatyllo-widget container.

14.6 Performance Issues

If the chatbot feels slow or impacts page load:

• Response caching: Premium plans include automatic response caching. Frequently asked questions are served from cache, reducing response time.
• Reduce Conversation Memory: Lowering the memory setting to 5-10 messages reduces the amount of data sent with each AI request, speeding up responses.
• Run Maintenance: Go to Settings → Advanced → Maintenance and click "Run Maintenance" to clean old data and optimize database tables.
• Check other plugins: Use a plugin like Query Monitor to identify if other plugins are causing slow database queries that might affect overall performance.

14.7 Widget Not Updating After Settings Change

If you change a setting but the widget does not reflect the change:

• Clear browser cache: Press Ctrl+Shift+Delete (Cmd+Shift+Delete on Mac) and clear cached files. Then reload the page.
• Clear server-side cache: If you use a caching plugin (WP Rocket, LiteSpeed Cache, etc.), purge all caches from the caching plugin's menu.
• CDN cache: If you use a CDN (Cloudflare, Sucuri, etc.), purge the CDN cache as well.
• Check you clicked Save: Verify you clicked the "Save Settings" button after making changes. The live preview updates immediately, but the front-end widget only updates after saving.

14.8 Export Not Working

If the JSON export or CSV export fails or downloads an empty file:

• Check PHP memory limit: Large datasets may require more memory. Ask your host to increase the PHP memory limit to at least 256 MB.
• Disable output buffering plugins: Some optimization plugins buffer output in ways that interfere with file downloads. Temporarily disable such plugins and retry.
• Check file permissions: Ensure the /wp-content/ directory is writable by your web server.

14.9 Getting Help

If none of the above solutions resolve your issue, contact support with the following information:

• A detailed description of the problem
• Steps to reproduce the issue
• Screenshots of any error messages
• Your System Info from the Chatyllo Dashboard
• Whether the issue occurs with all other plugins deactivated
• Whether the issue occurs with a default WordPress theme

This information helps our team diagnose and resolve your issue much faster. See the Support & Contact section for how to reach us.

15. Multilingual Support

Chatyllo supports 13 languages out of the box, making it suitable for international websites and multilingual audiences.

Built-in Translations

The following languages are included with Chatyllo:

Automatic Language Activation

Chatyllo automatically detects your WordPress site language (set in Settings → General → Site Language) and activates the corresponding translation for the chat widget's interface elements, including button labels, placeholder text, and system messages.

AI Language Detection

On premium plans, the AI automatically detects the language of the visitor's question and responds in the same language. This means a French visitor can ask a question in French and receive a French response, even if your site content is in English, as long as the AI can find relevant content to base its answer on.

Multilingual FAQs

Each FAQ entry has a Language field that allows you to create language-specific FAQ sets. When a visitor asks a question in a specific language, the matching algorithm prioritizes FAQ entries in that language. This allows you to maintain separate FAQ databases for each language you support.

16. Support & Contact

Free Plan Support

Free plan users can get help through the WordPress.org support forum. Post your question and our team monitors the forum regularly to provide assistance.

• WordPress.org Support Forum: Visit the Chatyllo plugin page on WordPress.org and click the "Support" tab.

Premium Support

All premium plans (Starter, Business, and Agency) include dedicated priority support via email. Premium support offers faster response times and direct access to the development team.

• Email: support@wpezo.com
• Response Time: Within 24 hours on business days.

Resources

• Documentation: You are here. Bookmark this page for future reference.
• Website: www.wpezo.com
• Chatyllo Product Page: wpezo.com/chatyllo

When Contacting Support

To help us resolve your issue as quickly as possible, please include:

• Your WordPress version and Chatyllo version (found on the Dashboard → System Info)
• Your active plan
• A description of the issue and steps to reproduce it
• Any error messages or screenshots
• Your site URL (if possible)

Common Support Questions

How do I cancel my subscription?

You can cancel your premium subscription at any time from the Chatyllo → Account page. Click "Manage Subscription" to access the Freemius billing portal where you can cancel, switch plans, or update payment details. Your premium features will remain active until the end of your current billing period.

Can I get a refund?

Chatyllo offers a 14-day money-back guarantee on all premium plans. If you are not satisfied within the first 14 days of your purchase, contact support@wpezo.com to request a full refund.

How do I transfer my license to another site?

You can deactivate your license on the current site and activate it on a new site. Go to Chatyllo → Account, click "Deactivate License", then install and activate Chatyllo on the new site and enter the same license key. Freemius manages per-site licensing automatically.

Is my data shared with third parties?

No. Your site content, FAQ data, and conversation logs are stored in your own WordPress database on your own server. When AI is used, questions are sent to the Chatyllo proxy for processing, but no data is stored on the proxy servers after the response is generated. The proxy service does not retain, sell, or share any of your data.

Release Notes

Stay informed about new features, improvements, and bug fixes by checking the changelog on the WordPress.org plugin page or the WPezo website. Major releases are announced via email to all premium subscribers.

Appendix: Technical Reference

Database Tables

Chatyllo creates the following database tables upon activation (prefixed with your WordPress table prefix):

REST API Endpoints

Chatyllo registers the following REST API endpoints under the chatyllo/v1 namespace for the chat widget to communicate with your server:

Cron Events

Chatyllo schedules the following WordPress cron events:

• chatyllo_auto_index — Runs the automatic knowledge base re-indexing on the schedule defined by your plan.
• chatyllo_maintenance — Runs the weekly maintenance routine (log cleanup, cache cleanup, database optimization).
• chatyllo_status_check — Checks the AI service status every 5 minutes.

Data Storage

Chatyllo stores its settings in the WordPress options table under keys prefixed with chatyllo_. The main settings array is stored as chatyllo_settings. Bot avatar uploads are stored in the standard WordPress uploads directory under /wp-content/uploads/chatyllo/.

Uninstallation

When the plugin is deleted (not just deactivated), the following occurs based on the "Keep Data" setting:

• Keep Data OFF (default): All database tables, options, cron events, and uploaded files created by Chatyllo are removed. This leaves no trace of the plugin in your database.
• Keep Data ON: All data is preserved. If you reinstall Chatyllo later, it will detect the existing data and resume from where you left off.

Browser Compatibility

The Chatyllo chat widget is compatible with all modern browsers:

Hosting Compatibility

Chatyllo is compatible with all standard WordPress hosting providers. It has been tested on:

• Shared hosting (Bluehost, SiteGround, Hostinger, GoDaddy)
• Managed WordPress hosting (WP Engine, Kinsta, Flywheel)
• VPS and dedicated servers (DigitalOcean, Linode, AWS)
• Local development environments (Local by Flywheel, MAMP, XAMPP, DevKinsta)

Plugin Compatibility

Chatyllo is designed to work alongside other WordPress plugins. It has been tested for compatibility with:

• Page builders: Elementor, Beaver Builder, Divi, WPBakery, Gutenberg
• Caching plugins: WP Super Cache, W3 Total Cache, LiteSpeed Cache, WP Rocket
• Security plugins: Wordfence, Sucuri, iThemes Security, All In One WP Security
• SEO plugins: Yoast SEO, Rank Math, All in One SEO
• Cookie/GDPR plugins: CookieYes, Complianz, CookieBot, iubenda
• E-commerce: WooCommerce (all versions 6.0+)
• Multilingual plugins: WPML, Polylang, TranslatePress

If you encounter a conflict with a specific plugin, please report it to support@wpezo.com with details about both plugins and the issue observed.

Performance Considerations

Chatyllo is designed to have minimal impact on your site's performance:

• Script loading: The widget JavaScript and CSS are loaded asynchronously and do not block page rendering. Total script size is under 30 KB (minified and gzipped).
• No external fonts: Chatyllo uses the system font stack, so no additional font files are downloaded.
• Lazy initialization: The widget only initializes its full functionality when a visitor interacts with it. Simply loading the page adds minimal overhead.
• Server-side caching: Premium plans include response caching. Identical questions are served from cache, reducing both response time and server load.
• Database queries: Chatyllo uses indexed queries and avoids full-table scans. The maintenance routine optimizes tables to maintain fast query performance over time.

Security

Chatyllo follows WordPress security best practices:

• All admin AJAX requests are protected with WordPress nonces.
• Input data is sanitized using WordPress sanitization functions before storage.
• Output is escaped using appropriate WordPress escaping functions.
• Database queries use prepared statements to prevent SQL injection.
• File uploads (bot avatar) are validated for type and size before storage.
• The REST API endpoints validate request origins and rate-limit abusive requests.
• Communication with the AI proxy service uses HTTPS encryption.

Frequently Asked Technical Questions

Can I use Chatyllo with a headless WordPress setup?

Chatyllo's widget is designed for traditional WordPress front-ends. If you use a headless setup (e.g., Next.js, Gatsby), you would need to integrate the chat widget manually using the REST API endpoints. The admin panel and configuration work normally in a headless setup.

Does Chatyllo work with multisite?

Yes, Chatyllo can be installed on individual sites within a WordPress multisite network. Each site has its own independent settings, FAQ database, and knowledge base. Network-wide activation is supported, but each site must be configured individually.

What happens if the AI proxy is permanently down?

Chatyllo is designed to be resilient. If the AI proxy is unavailable for an extended period, the chatbot continues to function using the FAQ matching system. Your visitors will always receive answers as long as you maintain a comprehensive FAQ database. When the AI service recovers, AI responses resume automatically.

Can I customize the widget HTML or CSS beyond the settings?

Yes. The widget renders inside a container with the ID #chatyllo-widget. You can add custom CSS rules targeting this container in your theme's customizer or a custom CSS plugin. Use high specificity selectors or !important to override the widget's default styles.

How much server storage does the knowledge base use?

The knowledge base is stored as text in your WordPress database. A typical site with 100 pages/posts uses approximately 1-5 MB of database storage. WooCommerce stores with thousands of products may use 10-20 MB. This is negligible for modern hosting environments.