Joomla
Integrate AI SmartTalk with your Joomla website to add an intelligent chatbot and automatically sync your content to your knowledge base.
1. Prerequisites
Before you begin, ensure you have:
- An active AI SmartTalk account
- Administrator access to your Joomla website (version 6.x)
- cURL enabled on your server
- For e-commerce: HikaShop component installed (optional)
2. Downloading the Plugin
- Log in to your AI SmartTalk account
- Navigate to Integration in the main menu
- Find the Joomla section
- Click the Download button to save the plugin ZIP file to your computer
3. Installation on Joomla
- Log in to your Joomla administrator dashboard
- Go to Extensions > Manage > Install
- Click on the Upload Package File tab
- Select the AI SmartTalk ZIP file you downloaded
- Click Upload & Install
- Wait for the installation confirmation message
4. Configuring the Plugin
4.1 Enable the Plugin
- Go to Extensions > Plugins
- Search for System - AI SmartTalk
- Click on the plugin name to open settings
- Set Status to Enabled
4.2 Enter API Credentials
- In your AI SmartTalk account, go to Integration > Joomla
- Copy the Chat Model ID and Chat Model Token
- Return to the Joomla plugin settings
- Paste the Chat Model ID in the corresponding field
- Paste the Chat Model Token in the corresponding field
4.3 Choose Content Types to Sync
Select which content you want to sync to your chatbot:
- Products: Sync HikaShop products (requires HikaShop)
- Articles: Sync Joomla articles
- Categories: Sync Joomla categories
4.4 Configure Auto-Sync
- Enable Auto Sync to automatically update your chatbot when content changes
- When disabled, you can manually sync from the plugin settings
4.5 Customize Chatbot Display (Optional)
- CDN URL: Default is
https://cdn.aismarttalk.tech(change only if using whitebranded version) - Iframe Position: Choose where the chatbot appears on your site
5. Data Synchronization
Initial Sync
- In the plugin settings, click Save & Close
- The plugin will automatically sync all published content:
- Published articles with public access
- Published categories with public access
- Published HikaShop products with stock (if enabled)
Automatic Sync
Once configured, the plugin automatically syncs:
- When you save an article: Syncs immediately if published
- When you update a product: Syncs if published and in stock
- When you change status: Removes from chatbot if unpublished
Manual Re-sync
To force a complete re-sync:
- Open the plugin settings
- Click Save & Close
- All unsynced content will be synced automatically
6. Verifying the Integration
Check the Chatbot Display
- Visit your Joomla website frontend
- Look for the chatbot bubble in the bottom-right corner
- Click to open the chat window
- The chatbot should load with your configured settings
Check Synced Content
- Log in to your AI SmartTalk account
- Go to Knowledge section
- Verify that your Joomla content appears:
- Articles should show with their full text
- Products should include descriptions and details
- Categories should be listed
Test the Chatbot
- Ask a question about your Joomla content
- The chatbot should respond with accurate information
- Test queries about articles, products, or categories you've synced
7. Content Sync Behavior
What Gets Synced
Articles:
- Published articles only (
state = 1) - Public or registered access levels (
access = 1 or 5) - Full article content including intro text
Products (HikaShop):
- Published products only
- Products with stock (quantity > 0 or unlimited stock)
- Product descriptions, prices, and details
Categories:
- Published categories only
- Public or registered access levels
- Category descriptions
What Gets Removed
Content is automatically removed from the chatbot when:
- An article is unpublished
- A product goes out of stock
- A product is unpublished
- A category is unpublished
8. Troubleshooting
The chatbot doesn't appear on the site
- Check that the plugin is Enabled
- Verify Chat Model ID is correctly entered
- Clear your Joomla cache: System > Clear Cache
- Check browser console for JavaScript errors
Content is not syncing
- Ensure Auto Sync is enabled in plugin settings
- Check that content is published and has public access
- For products, verify they have stock available
- Check server error logs for cURL or connection issues
Product sync not working
- Verify HikaShop is installed and activated
- Check that products are published and in stock
- Ensure the "Products" content type is selected in settings
API connection errors
- Verify Chat Model Token is correct
- Check that your server allows outbound HTTPS connections
- Ensure cURL extension is enabled in PHP
- Test API connectivity from server command line
9. Plugin Uninstallation
If you need to remove the plugin:
- The plugin will automatically clean up:
- Remove sync tracking columns from database tables
- Delete all synced content from AI SmartTalk
- Go to Extensions > Manage > Manage
- Search for AI SmartTalk
- Click the checkbox and click Uninstall
10. Conclusion
You have successfully:
- Installed the AI SmartTalk plugin on Joomla
- Connected your site to your AI SmartTalk chatbot
- Configured automatic content synchronization
- Added an intelligent chatbot to your website
Your visitors can now get instant answers about your content, products, and services 24/7 through the AI-powered chatbot.
For support, contact us at contact+support@aismarttalk.tech