Setup guides, settings explained, and fixes for the most common problems. For the free plugin and the Pro add-on. Written for Smarto AI Customer Support 1.0.0 and Pro 1.0.0. Updated 2026-11-03.
An AI support assistant that answers visitors from your own content, helps with orders and courses, and passes the rest to your team.
The assistant answers from your published pages, posts, products, courses and the knowledge you add, reads live store and course data, and hands questions it cannot answer to your team as a ticket. The free plugin is complete on its own, with no account, license or time limit.
Online stores (WooCommerce): products, live prices and stock, variations, shipping, store policies, and the customer's own orders and tracking.
Course sites (Tutor LMS, LearnPress): the catalog, what a course covers, and a logged-in student's own enrollment and progress. Never lesson or quiz content.
Business and service sites: services, opening hours ("are you open now?"), location, service area, quotes and bookings.
Blogs, docs and membership sites: answers from your content, with links to the source pages.
Any language: it replies in the visitor's language, including mixed styles such as Banglish or Hinglish.
Support only: coding help, homework, essays, general knowledge and attempts to change its rules are refused politely.
Good to knowRequires WordPress 6.6 or newer and PHP 8.0 or newer. You need an API key from OpenAI, Anthropic (Claude), Google Gemini, OpenRouter or an OpenAI-compatible server.
Start here
Install and the setup guide
A short guide opens after the first activation and gets the chat live in a few minutes.
1Install Smarto AI Customer Support from Plugins > Add New Plugin and activate it.
2Plan: continue with Free, or read what the separate Pro plugin adds.
3Business: choose the kind of site, then add your business name, what you do and a public email.
4Assistant: name and tone, your AI provider, API key and model. Click Test connection, then enter the email that receives requests for your team.
5Go live: pick a brand color and position, set the welcome heading and switch on Show the chat on my site. The live preview shows what visitors see.
Each step saves when you click Save and continue. The guide uses the same settings as AI Support > Settings, so both always show the same values.
Used the plugin before? The guide first shows what is already set and what is missing (AI connected, business description, team email, chat switched on), with Review or Fix for each item.
Activated several plugins at once, or came back later? A Start the setup guide notice shows on the Plugins screen and the Dashboard, and a Setup guide link sits in the plugin row until you finish or dismiss it.
Good to knowReopen the guide any time from AI Support > Dashboard, "Open the setup guide" in the Finish setting up card.
Settings
Connect your AI provider
Bring your own key. You pay the provider directly and keys are stored encrypted.
1Open AI Support > Settings > AI provider.
2Choose OpenAI, Anthropic (Claude), Google Gemini, OpenRouter or Custom (OpenAI-compatible). Custom needs a Server address, usually ending in /v1.
3Paste your API key. Saved keys show masked, with Replace and Remove.
4Pick a model in the searchable picker: type to filter, switch between All and Recommended, or type any model id.
5Click Test connection. It checks the key and loads every model your key can use.
6Click Save changes.
Scope check: "Model for the scope check" is optional. A cheaper model from the same provider labels each message before the full answer is written. Leave it empty to use the main model.
Good to knowFast, low-cost models work well for support answers.
Settings
Assistant and business profile
Who visitors talk to, how it sounds, and the facts it may share.
Setting
What it does
Name
Shown in the chat header.
Tone
Friendly, Professional or Casual.
Answer length
Short (1 to 3 sentences) or Medium.
Extra instructions
Rules the assistant always follows. It still stays on support topics.
Kind of site
Business, Online store, Courses, Services or bookings, Blog or docs, A mix.
Business profile
Name, what you do, phone, public email, address, service area and other short facts.
Opening hours
Per day in the site timezone, so it can answer "are you open now?".
The assistant only shares facts from the business profile, your knowledge and live data. It never invents details.
Settings
Chat widget
Brand it, place it and decide where it shows. Every change appears in the live preview.
Show the chat on your site: the main switch. The test chat works while it is off.
Look: brand color (text on it stays readable automatically), avatar (five icons or your own image), position (Bottom left or Bottom right), round icon or icon with text.
Text: status under the name, welcome heading and message, up to four suggested questions, message box placeholder.
Greeting bubble: a short note next to the chat button, shown once per visitor after the delay you set.
Where it shows: only for logged-in users, hide on content types or page IDs, or place it in a page with [smartoaics_chat].
Consent and credit: ask visitors to agree before chatting, show the "AI + human support" note, show "Powered by WP Smarto" (off by default).
The AI + human support note is on by default. The chat footer reads "AI + human support. AI can make mistakes." and visitors tap it to message your team. Turn it off to show "Message the team" instead.
Good to knowYour own buttons can open the chat: link to #smartoaics-open or add the class smartoaics-open. Add data-smartoaics-message="Your question" to send a question right away.
Knowledge
Add knowledge
The assistant answers only from what is in AI Support > Knowledge, plus live store and course data.
Site content: per content type choose All of them, Only ones I tick in the editor, or None. Custom post types are included, with their categories, tags and custom fields (ACF, Meta Box, Pods and similar).
Upload a document: Markdown, text, CSV, HTML or Word (.docx), up to 5 MB. Only the text is kept.
Paste text: policies, price lists or service descriptions. Start lines with # to split topics.
Questions and answers: best for what visitors ask most. Answered questions always count as on topic.
Only published, public content is used. Drafts, private and password protected pages, lessons and quizzes are always left out. To leave out one page, tick Do not use this content in the AI Customer Support box in the editor.
Content updates automatically when you save a post. Use Rebuild the index after a big import or migration.
Knowledge
Unanswered questions and skills
Close the gaps once, and teach the assistant your processes.
Unanswered questions (Knowledge tab) lists what your knowledge did not cover. Answer each one once and the assistant uses your answer from then on.
Skills (AI Support > Skills) are plain language playbooks the assistant loads only when a visitor needs one. Built in: Course help, Human handoff, Order help, Quote request, Returns and refunds, Troubleshooting. Edit them, use Restore original, or write your own with "When to use it" and numbered instructions.
Your team
Tickets and emails
When the assistant cannot help, it creates a ticket and your team replies by email.
The visitor confirms the handoff with one tap and gets a reference number and your reply time promise. Your team gets an email for each new ticket.
Inbox (AI Support > Tickets): Waiting for your team, Waiting on customer and Closed, search, bulk actions, reply by email, private notes and the full chat behind each ticket.
Settings > Tickets: first ticket number (for example 90001) and reply time promise.
Customer ticket page: every email has a private "View and reply" link. Guests on a new browser confirm a 6-digit code; account holders log in.
My support requests: a page where logged-in customers see all their requests ([smartoaics_tickets]), plus an optional tab in WooCommerce My Account.
Settings > Notifications: where new tickets go, confirmation and closed emails to customers, and email template previews.
CarefulEmails use your site's mail setup. If they do not arrive, install an SMTP plugin.
Your team
Store and courses
WooCommerce, Tutor LMS and LearnPress help, with private data kept private.
Store help: products, live stock and prices, shipping and policies.
Guest order lookup: order number, billing email and a one-time code sent to that email.
Show exact stock numbers: off shows only in stock or out of stock.
Coupons the assistant may share: one per line as CODE | details. No other code is ever shared.
Course help: course search, details and a student's own progress.
The assistant cannot change orders, give refunds or apply coupons. Order details never include addresses, phone numbers, emails or payment details.
Safety and privacy
Safety and limits
Keep the assistant on topic and your AI costs under control.
Setting
What it does
Scope check
Refuses off-topic messages before a full answer is written.
Off-topic messages allowed before a pause
Visitors see a warning with the count.
Pause length (minutes)
How long the visitor cannot chat. "Message the team" stays available.
Message and rate limits
Longest message, messages per conversation, per minute and new conversations per day.
Chat memory
How many messages it remembers word for word, and earlier ones in short.
Daily and monthly token limit
0 means no limit.
Other sites the assistant may link to
Links to your own site always work.
Test it in AI Support > Test chat. The Scope tester sends common misuse prompts: misuse should be refused and support questions answered. A paused visitor can be released on their conversation page.
Safety and privacy
Privacy and data
Chats stay in your WordPress database and are only sent to the AI provider you choose.
Delete conversations after (days): closed tickets are deleted after the same time. 0 keeps everything.
Delete all plugin data when the plugin is deleted: off by default, so a reinstall keeps your setup.
Chats are included in the WordPress personal data export and erase tools.
No tracking and no data sent to WP Smarto.
Troubleshooting
Fix common problems
Most problems come down to the AI key, the widget switch or missing knowledge.
Problem
What to do
"AI not connected" in the top bar
Add a key and model in Settings > AI provider and click Test connection.
The chat does not show
Check Show the chat on your site, Only for logged-in users, hidden content types and page IDs.
Answers miss facts
Add documents, text or questions and answers, and check Unanswered questions.
Normal questions are refused
Answer them in Knowledge, or describe the topic in your business profile.
Ticket emails do not arrive
Install an SMTP plugin; the plugin uses your site's mail setup.
A visitor is paused
Open the conversation and click Release pause, or relax Safety and limits.
Troubleshooting
Frequently asked questions
Short answers to what site owners ask most.
Does it work with page caching?+
Yes. Pages hold no nonce or session data. The chat gets a signed session when a visitor opens it.
Will my theme change how the chat looks?+
No. The chat is drawn in its own isolated layer (Shadow DOM), so theme styles cannot change it.
Can it change orders or give refunds?+
No. It reads information and creates tickets for your team. It only shares coupon codes you list.
Which LMS plugins are supported?+
Tutor LMS and LearnPress. Developers can add more with the smartoaics_lms_drivers filter.
Can developers control the chat?+
Yes. Call SmartoaicsWidget.open(), SmartoaicsWidget.close() and SmartoaicsWidget.ask( text ).
What does Pro add?+
Live chat with your team, customer files and email replies into tickets, saved replies, assignment, team reports, CSV export, page greetings and editable widget text. The free plugin works fully without it.
Start here
What Pro adds
A separate plugin that installs next to the free one and adds the tools a support team needs.
Live chat: when a visitor asks for a person and someone is online, the chat moves to AI Support > Live chat and the AI steps back.
Helpdesk: customer email replies and files into tickets, saved replies, assignment with email alerts, first reply time and time to close.
Reports: reply times, tickets per day, busiest hours, ticket types, team, ratings and top unanswered questions.
Export: CSV of tickets and conversations, and transcript downloads.
Chat widget: a different greeting on chosen pages, and every visitor-facing text can be changed or translated.
Start here
Install Pro
Pro needs the free plugin, installed and active.
1Install and activate the free Smarto AI Customer Support plugin.
2Download Smarto AI Customer Support Pro from your account dashboard on wpsmarto.com.
3Upload it in Plugins > Add New Plugin > Upload Plugin and activate it.
4Activate the license (next section). Until then Pro features stay locked and the free plugin works as before.
Start here
Activate the license
One click and an approval on wpsmarto.com. There is no key to copy.
1Open AI Support > Pro License and click Activate license.
2Log in to wpsmarto.com and approve the site.
3Back in WordPress, click I approved it, check again. You see "License activated. Pro features are unlocked."
Button
What it does
Verify license
Checks the license with WP Smarto. Without an active license, Pro features lock until you activate again.
Check for updates
Shows the latest version. Update on the Plugins page.
Deactivate
Frees the site slot and keeps your settings.
Good to knowIf WP Smarto could not be told about a deactivation, remove the site under Manage in your wpsmarto.com dashboard to free its slot.
Live chat
Set up live chat
AI Support > Settings > Live chat.
1Turn on Turn on live chat.
2Choose Who is on the support team: everyone with chosen roles, or add people one by one.
3Under What visitors see, show each person's first name or one name for everyone.
4Keep wp-admin open and set yourself to Available on the Live chat screen.
Team members count as online while they have wp-admin open and are not set to Away. When nobody is online, the AI offers to leave a message for the team instead.
Live chat
The Live chat screen
AI Support > Live chat.
Waiting, Mine, Active and Recent tabs.
Accept, take over or join a chat, transfer to a colleague, or hand it back to the AI.
Private notes, typing indicators, saved replies and create a ticket from the chat.
Sound, admin bar count and desktop alerts. Available or Away status.
Helpdesk
Saved replies, assignment and files
Faster answers and clear ownership on every ticket.
Saved replies (Tickets > Saved replies): insert them in tickets and live chats. {name} becomes the customer's name.
Assignment: assign a ticket to a team member, who gets an email alert.
Customer files: on their private reply page customers add up to 5 screenshots, photos or PDF files, 10 MB each. Files are stored privately and only your team can open them.
Response times: first reply time and time to close on the Tickets screen.
Export CSV on Tickets and Conversations, and Download transcript on a conversation.
Helpdesk
Email replies into tickets
Customers simply reply to your emails, attachments included. Optional, in Settings > Notifications.
1Turn on Bring email replies into tickets.
2Enter the Address customers reply to, for example support@reply.yourdomain.com.
3Copy the private Address for your email service into Postmark (Inbound stream, Webhook URL), Mailgun (Receiving, Create route, Forward to this address) or SendGrid (Inbound Parse, Destination URL, leave "raw" off).
Good to knowReplies are matched by the ticket number in the subject and only accepted from that ticket's customer.
Helpdesk
Reports
AI Support > Reports, for 7, 30 or 90 days.
Report
What it shows
Ticket numbers
New, closed, median first reply, share answered within a day, median time to close.
Tickets per day
New and closed side by side.
Busiest hours
Conversations by hour in your timezone, to plan live chat cover.
What tickets are about
Tickets by type.
Team
Tickets, closed and average first reply per person.
Ratings
Star breakdown and the latest low ratings with feedback.
Top unanswered questions
With a link to answer them in Knowledge.
Chat widget
Page greetings and widget text
Fit the chat to each page and to your language.
Different greeting on some pages (Chat widget > Greeting bubble): one per line as part of the address | greeting. The first match wins, for example /checkout | Questions about payment or delivery? Ask me.
Widget text (Settings > Widget text): change or translate every text visitors see, including the replies the server sends such as off-topic warnings, the pause notice, rate limits and ticket confirmations. Leave a field empty to keep the default, shown in grey.
CarefulKeep placeholders such as %s and %d in your text. A text with placeholders that do not fit falls back to the default.
Troubleshooting
Fix Pro problems
Live chat, email replies and the license.
Problem
What to do
Visitors never reach a person
Turn on live chat, add yourself or your role to the team, keep wp-admin open and set yourself to Available.
No sound or desktop alerts
Allow notifications for the site in your browser and keep a wp-admin tab open.
Email replies do not reach tickets
Check the inbound address in your email service and that the subject keeps the ticket number.
Pro features are locked
Open AI Support > Pro License and activate or verify the license.
Troubleshooting
Pro questions
Licenses, data and the free plugin.
Does Pro replace the free plugin?+
No. Pro needs the free plugin active and adds to it.
What happens if my license ends?+
Pro features lock, your data and settings stay, and the free plugin keeps working.
Does Pro send data to WP Smarto?+
Only for license activation, verification and update checks: a random site key, the product name and, on activation, the site address and name. Chats and tickets stay on your site.
Still stuck?
Ask our assistant, it knows these docs. If it cannot solve it, it passes your question to the team, who reply by email.