KissAi WordPress Plugin – User Manual

KissAi WordPress Plugin – User Manual

Plugin Version: 1.7.102 Requires: WordPress 6.8+ PHP 8.0+

Table of Contents

  1. About KissAi Plugin
  2. Register
  3. Settings
  4. Assistants
  5. Training
  6. Threads
  7. Front-End Widgets & Shortcodes
  8. Glossary & FAQ
  9. Release Notes

1. About KissAi Plugin

Menu: KissAi Admin → About KissAi

1.1 Welcome

The KissAi WordPress plugin integrates OpenAI‑powered chat, knowledge‑base search, and conversation analytics directly into your WordPress site.

Typical Use‑Cases:

  • AI concierge on e‑commerce stores
  • Documentation or help‑centre bot
  • Internal knowledge assistant for staff intranets

What is “KissAi Hub”? KissAi Hub is the customer portal (https://hub.kissai.io) where you manage your profile, plan, credits, transactions, and password. The plugin uses an API key issued by KissAi Hub or, if you prefer, your own OpenAI API Key.

1.2 Key Features

  • Assistants: Create & manage unlimited OpenAI Assistants.
  • Training: Upload PDFs, DOCX, or free‑text to extend your Assistant’s knowledge.
  • Widgets: One‑click chat widget & public thread viewer.
  • Credits: Use KissAi credits (billed via Hub) or your own OpenAI usage.
  • Threads: Review every visitor conversation for quality and insight.

1.3 Environment Requirements

  • WordPress
    • Minimum: 6.2
    • Recommended: 6.8+
  • PHP
    • Minimum: 8.0
    • Recommended: 8.2+
  • Database
    • Minimum: MySQL 5.7 / MariaDB 10.4
    • Recommended: MariaDB 10.6+

1.4 Quick Links

2. Register

Menu: KissAi Admin → Register

2.1 Why Register?

Registration creates your KissAi Hub account, issuing a KissAi API Key and starter credits. Without an active key, the plugin cannot communicate with the KissAi backend or OpenAI.

2.2 Step‑by‑Step Registration

  1. In WordPress admin, go to KissAi → Register. The form (First Name, Last Name, E‑mail) appears. (screenshot)
  2. Fill the form and click Verify Email. A new browser tab opens to KissAi Hub to create a pending account.
  3. Click Submit on the Hub Sign‑Up page. You’ll see a message that a verification email was sent. (screenshot)
  4. Open your mailbox. Look for “KissAi Hub – Verification Email” (check spam/promotions). (screenshot)
  5. Click the verification link. You will be redirected to Hub and see “Email Verification Successful.” (screenshot)
  6. Read the success page. It confirms a Welcome Email with your KissAi API Key has been sent.
  7. Open the Welcome Email. Copy your key (e.g., ka-api‑…). (screenshot)
  8. Return to WordPress → KissAi → Settings. Select KissAi API Key, paste your key, and click Save Settings. (screenshot)
  9. Done! The plugin is now authorized—proceed to create an Assistant (Chapter 4). (screenshot)

2.3 Troubleshooting

  • No verification email — Check spam; click Resend on the sign‑up page.
  • Verification link expired — Re‑submit the registration form to receive a new link.
  • No Welcome Email with key — Log in to https://hub.kissai.io → My Account → Plan, or use Reset Password to gain access.

3. Settings

Menu: KissAi Admin → Settings

3.1 Overview

This page is the control center for your KissAi setup. Choose which AI service handles requests (KissAi billing or your own OpenAI account) and whether to enable Debug Mode for diagnostics.

3.2 Fields

  • KissAi API Key — Paste the key from your Welcome Email. A link to the Register page is provided if you need a key.
  • OpenAI API Key — Provide your personal OpenAI key. Note: Assistants, Training data, and Threads are isolated to the key they were created with.
  • Debug Mode — Sends extra diagnostic output via error_log(). If WP_DEBUG_LOG is true, output goes to wp-content/debug.log. Enable only for troubleshooting.

Click Save Settings to commit changes. Only users with manage_options can alter these settings.

3.3 Best Practices

  1. Treat API keys like passwords—never expose them on the front‑end.
  2. Enable Debug Mode only on staging/dev sites.
  3. Limit KissAi admin access to trusted roles.

4. Assistants

Menu: KissAi Admin → Assistants

4.1 Concept

An Assistant is a named wrapper around an OpenAI model that includes a persona, instructions, and an optional knowledge base. Tailor each Assistant for a specific purpose on your site.

4.2 Interface

Assistant List — Columns: Assistant Name, Assistant ID, Model, Actions (Edit). Bulk Actions: Import, Export, Refresh.

Assistant Editor — Fields include Assistant Name, Model, System Prompt / Settings (upcoming), and buttons for Update, Cancel, Export, Delete.

5. Training

Menu: KissAi Admin → Training

Training is where you feed knowledge into an Assistant and fine‑tune how it replies. The page has three stacked panels after you pick an Assistant:

  • Assistants table — shows every Assistant (ID · Name · Assistant ID · Action). Click Train to activate.
  • Train Your AI — drag‑and‑drop knowledge files, paste free‑text, or tweak the system Instructions.
  • Manage Suggested Questions — curate up to 50 quick questions shown in the widget.

5.1 Detailed Walk‑through

  1. Pick an Assistant — Click Train next to the target Assistant; the row turns blue.
  2. Upload Knowledge Files — Drag & drop or browse. Accepted: PDF, DOCX, TXT, Markdown up to 512 MB each.
  3. Add Free‑text Knowledge — Provide an optional name and paste up to 2,000,000 characters; click Upload.
  4. Edit System Instructions — Adjust the pre‑filled boilerplate to control tone and behaviour; click Update.
  5. Manage Suggested Questions — Add, review, or delete suggestions. Auto‑generated from live queries.
  6. Real‑time Testing — Test via any page that hosts This KissAi Widget is not currently associated with any OpenAI Assistant.

    These are AI AGENT generated suggested questions
     for this Assistant—no rebuild needed.

5.2 Authoring Tips

  • Upload focused documents (topic‑specific beats entire manuals).
  • Split large docs into 5–7 page chunks to improve recall and reduce token cost.
  • Remove Personal Information (PII) — content is visible to site admins.
  • Prefer text‑based PDFs (scans process slower).
  • Keep instructions concise—the model follows them verbatim.
  • Use consistent terminology for better semantic matches.
  • Prune old Suggested Questions periodically.

6. Threads

Menu: KissAi Admin → Threads

Review conversations, search for patterns, and refine responses. The interface has a left navigation/search column and a right message viewer.

Page overview

  • Assistant list — Click View Threads for that assistant.
  • Search bar — OR‑based search (e.g. procedure main matches either word). Matches are highlighted.
  • Thread toolbar — Sort: Newest→Oldest / Oldest→Newest.
  • Thread list — Sidebar of thread IDs and start times.
  • Message viewer — Visitor = light‑blue; Assistant = white. Highlights persist as you scroll.

Typical workflow

  1. Choose an Assistant → View Threads.
  2. Search for keywords (complaints, feature requests).
  3. Sort to scan newest or earliest chats.
  4. Read highlights to spot patterns.
  5. Refine your Assistant: return to Training.

Tips & best practices

  • Use distinctive keywords (product names, error codes).
  • Combine the search bar with Newest→Oldest for daily reviews.

7. Front‑End Widgets & Shortcodes

7.1 Chat Widget: This KissAi Widget is not currently associated with any OpenAI Assistant.

These are AI AGENT generated suggested questions

Embed a chat widget on any page or post.

Example:

These are AI AGENT generated suggested questions

AttributeDefaultDescription
assistant_id(empty) requiredID of the Assistant to power the chat.
modeclientclient for visitor chat, admin exposes training tools.
button_classbutton-flat fusion-button-default-size button-defaultCSS classes for the floating button when mode=client.
textarea_stylewidth:100%;padding:10px;Inline styles for the message textarea.
form_stylewidth:100%;Inline styles for the surrounding form element.
titleNew titleHeader text shown at top of widget.
user_nameYouLabel used for user messages.
ai_nameKissAiLabel for assistant replies.
suggested_questions_enabledonon to show the suggested‑question bar.
suggested_questions_textThese are AI AGENT generated suggested questionsHeader text above suggested questions.
suggested_questions_labelQ:Prefix before each suggested question.
suggested_questions_styleButtonPresentation style (Button, Link, etc.).
suggested_questions_auto_loadoffon auto‑generates questions on widget load.
suggested_questions_trigger_textGenerate questions I can askText on the trigger control if auto‑load is off.
admin_titleTrain Your AIHeader when widget is used in admin‑mode.
admin_file_list_titleKnowledgeLabel above uploaded knowledge files in admin‑mode.
admin_file_text_divider_textOr, enter text data below.Divider text between file zone and textarea in admin‑mode.

7.2 Thread Viewer:

Display a public view of conversations.

Example:

AttributeDefaultDescription
thread_list_headerThreadsHeading above the sidebar thread list.
user_nameYouLabel for user posts.
ai_nameKissAiLabel for assistant replies.

8. Glossary & FAQ

Glossary

  • KissAi API Key: Secret token from KissAi Hub for billing and auth.
  • Assistant: Wrapper around an OpenAI model, its settings, and knowledge base.
  • Thread: A single conversation session between a visitor and an Assistant.
  • Credit: Billing unit used in KissAi Hub.

Frequently Asked Questions

How do I create and train my AI assistant?
Go to KissAi → Assistants → Add New and upload knowledge files.

Can I manage multiple assistants?
Yes. Create and configure assistants under KissAi → Assistants—each with separate knowledge.

What AI models does KissAi Widget support?
Currently OpenAI’s GPT‑4o and o3, with future updates planned for Grok, Claude, and Gemini.

How do I display my AI assistant on my website?
Use the shortcode

These are AI AGENT generated suggested questions
. Integrates with Elementor and AVADA.

Is it secure to use my OpenAI or KissAi API key?
Yes. The plugin securely manages keys to protect your data and interactions.

Can I update the assistant’s knowledge base over time?
Absolutely. Upload and refine knowledge files continuously; updates are incorporated into the vector store.

Does KissAi Widget store my chat history?
Yes. It can store each user’s conversation in WordPress (thread‑based) for persistence and review.

9. Release Notes (Excerpt)

  • 1.7.102 — Reset Database button in Settings disabled.
  • 1.7.101 — Fix: Messages not being saved. • Fix: Uploaded training material could not be downloaded.
  • 1.7.100 — Security hardening (input sanitization, parameterized DB calls, nonce checks).
  • 1.7.81 — Added SSE support, threaded conversation storage, vector‑store management, suggested questions, improved logging.
  • 1.0.0 — Initial plugin release.

For the full changelog, see the plugin’s readme.txt.