Documentation · Smart Chatbot
Smart Chatbot Documentation
How to install, connect, train and configure the Team JUH Smart Chatbot WordPress plugin, and what a Pro licence changes.
Last updated: 18 November 2026 · AI Chatbot Privacy Policy
1. What this plugin does
TeamJUH Smart Chatbot with ChatGPT and Claude adds an AI chat widget to a WordPress site. It answers from your own posts and pages rather than from general knowledge, collects name, email and phone when you want it to, and hands the conversation to a person when the visitor asks for one.
Every AI model your provider account can reach is available in the free version. A Pro licence removes usage limits; it does not unlock models. Section 12 sets out exactly what differs.
This page documents version 1.2.3. The plugin is published on WordPress.org.
2. Requirements
- WordPress 5.8 or higher.
- PHP 7.4 or higher.
- An API key from OpenAI or Anthropic. The plugin does not include one and does not resell credits.
- HTTPS is recommended, so that keys and conversations are not sent in the clear.
3. Install and activate
From the WordPress dashboard: go to Plugins > Add New, search for "TeamJUH Smart Chatbot", click Install Now, then Activate.
Manual upload: download the ZIP from the plugin page, then go to Plugins > Add New > Upload Plugin, choose the file, install and activate.
A new AI Chat menu appears in the admin sidebar once the plugin is active. Everything in this guide lives under it.
4. Connect an AI provider
Go to AI Chat > Settings > General, choose OpenAI or Anthropic, and paste the API key from that provider's dashboard.
- Refresh Models pulls the current model list for your key, so newly released models appear without a plugin update.
- Test API Connection confirms the key works before any visitor sees the widget. Run it after every key change.
You are billed by OpenAI or Anthropic for usage, not by us. Smaller models such as GPT-4o Mini or Claude Haiku cost a fraction of the large ones and are usually enough for answering questions about a website. Start there and move up only if answers are weak.
5. Train the chatbot on your content
Open AI Chat > Settings > Content Training and select the posts and pages the chatbot is allowed to answer from. The plugin indexes them and refreshes automatically when you edit that content, so replies track what you have actually published.
Train on fewer, better pages. Services, pricing, policies, shipping and contact details answer most real questions. Feeding it every archive page makes answers vaguer, not smarter.
If a visitor asks something your content does not cover, the chatbot should say so rather than guess. Check this yourself after training by asking it a question you know is not answered anywhere on the site.
6. Customise the widget
Under AI Chat > Settings you can set the widget position, colours, theme, open and close animation, avatar, branding and sound notifications, and add your own CSS for anything the settings do not reach. The widget is responsive and is designed to sit on top of any theme.
Test on a phone before launch. A chat bubble that covers a sticky call button or a cookie banner is the most common layout problem, and it only shows up at small widths.
7. FAQ quick buttons
FAQ buttons appear when the chat opens and let a visitor ask a common question in one tap. The free version supports up to four. Pro removes the limit.
Use them for the questions your inbox already receives every week, phrased the way a customer would phrase them, not the way your website words them.
8. Capture leads
Lead capture collects name, email and phone. It can be switched off entirely, offered during the conversation, or required before the visitor can chat at all.
Requiring details before the first message gets you more rows and fewer conversations. Asking inside the conversation, once the chatbot has been useful, is usually the better trade for a small business.
9. Hand over to a live agent
A Transfer to Agent button lets the visitor ask for a person. The plugin emails your team with the conversation so far, and an agent picks it up from the Live Chat dashboard with the full history in view.
The free version handles up to five active live conversations at once. Pro removes that cap.
Point the notification email at an address somebody actually watches during business hours. A handover nobody answers is worse than no handover button.
10. Chat schedule and offline behaviour
Set the hours the chat is available, with the timezone it should follow, and choose what happens outside them: hide the widget, or keep it available and tell the visitor when somebody will reply. Set this to your real hours rather than aspirational ones.
11. The AI notice bar
A customisable notice tells visitors they are talking to AI. Keep it on. It is honest, several jurisdictions are moving towards requiring it, and it lowers the chance of a visitor treating a generated answer as a binding quote.
12. Conversations and history
The Conversations screen stores past chats so you can see what people ask and where your content falls short. The free version shows the five most recent. Pro keeps the full history.
Read them weekly for the first month. The questions the chatbot answers badly are a list of pages your website is missing.
13. Free compared with Pro
Pro lifts limits. It does not restrict AI models, providers, training, lead capture, scheduling or widget customisation, all of which are in the free version.
- FAQ buttons: four in free, unlimited in Pro.
- Conversation history: five most recent in free, unlimited in Pro.
- Live chat conversations: five at once in free, unlimited in Pro.
- Support: the WordPress.org forum in free, priority support in Pro.
14. Activate a Pro licence
Go to AI Chat > Settings > License, paste the licence key you were sent, and click Activate. The Pro limits lift straight away; you do not need to reinstall the plugin or retrain your content.
Each site needs its own installation and its own API key. How many sites one licence key covers depends on the licence you bought, so check your purchase confirmation before activating a second site.
15. Privacy and GDPR
Conversations are stored in your own WordPress database, not on our servers. Messages are sent to whichever AI provider you configured in order to generate a reply. You can delete conversations one at a time, in bulk, or automatically after a set number of days.
The plugin gives you the controls; the compliance obligation is yours, because on your site you are the data controller. The full detail is in the AI chatbot privacy policy, which you are free to link from your own site.
16. Troubleshooting
- The widget does not appear: confirm the plugin is active, that the current time is inside your chat schedule, and that a caching or optimisation plugin is not stripping the script. Clear every cache layer, including the host and CDN.
- Replies fail or time out: run Test API Connection. The usual causes are an expired key, an account with no credit left, or a model your key cannot reach.
- A model is missing from the list: click Refresh Models. The list comes from your provider account, so a model you have not been granted access to will not appear.
- Answers are wrong or invented: retrain under Content Training and narrow the selection. An answer that is not supported by a trained page is a training problem, not a model problem.
- Handover emails do not arrive: WordPress sends them with the site's mailer. Check spam, then confirm the site can send mail at all, using an SMTP plugin if it cannot.
17. Get support
Free users can post in the WordPress.org support forum. Pro licence holders get priority support at support@teamjuh.com. Include your WordPress version, PHP version, plugin version and the provider you are using, which answers the first three questions we would otherwise have to ask.
Frequently asked questions
Do I need my own API key?
Yes. The plugin connects to your own OpenAI or Anthropic account, and that provider bills you for usage. Both offer trial credit to start with.
Are any AI models locked behind Pro?
No. Every model your API key can reach is available in the free version, including the cheaper small models. Pro lifts usage limits, not model access.
How much does the API cost to run?
It depends on the model and your traffic. Small models such as GPT-4o Mini and Claude Haiku cost a small fraction of the large ones and handle website questions well, which is what keeps a chatbot on a business site affordable.
What is the difference between Free and Pro?
Pro removes the four-button FAQ limit, the five-conversation history limit and the five-concurrent live chat limit, and adds priority support. Everything else is in the free version.
Will it work with my theme?
Yes. The widget is injected on the front end and styled independently of the theme, with colour, position and custom CSS controls if it needs adjusting.
Where are conversations stored?
In your own WordPress database. Messages are sent to your chosen AI provider to generate replies, and you control how long conversations are kept.
Can I use one licence on several sites?
Each site needs its own installation and its own API key. How many activations a licence key allows depends on the licence you purchased.