Skip to main content

Joomla

Integrate AI SmartTalk with your Joomla website to add an intelligent chatbot and automatically sync your content to your knowledge base.

Joomla Integration

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​

  1. Log in to your AI SmartTalk account
  2. Navigate to Integration in the main menu
  3. Find the Joomla section
  4. Click the Download button to save the plugin ZIP file to your computer

3. Installation on Joomla​

Joomla Extension Installation

  1. Log in to your Joomla administrator dashboard
  2. Go to Extensions > Manage > Install
  3. Click on the Upload Package File tab
  4. Select the AI SmartTalk ZIP file you downloaded
  5. Click Upload & Install
  6. Wait for the installation confirmation message

4. Configuring the Plugin​

4.1 Enable the Plugin​

Joomla Plugin List

  1. Go to Extensions > Plugins
  2. Search for System - AI SmartTalk
  3. Click on the plugin name to open settings
  4. Set Status to Enabled

4.2 Enter API Credentials​

Joomla Plugin Configuration

  1. In your AI SmartTalk account, go to Integration > Joomla
  2. Copy the Chat Model ID and Chat Model Token
  3. Return to the Joomla plugin settings
  4. Paste the Chat Model ID in the corresponding field
  5. Paste the Chat Model Token in the corresponding field

4.3 Choose Content Types to Sync​

Content Type Selection

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​

  1. In the plugin settings, click Save & Close
  2. 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:

  1. Open the plugin settings
  2. Click Save & Close
  3. All unsynced content will be synced automatically

6. Verifying the Integration​

Check the Chatbot Display​

Chatbot on Joomla Site

  1. Visit your Joomla website frontend
  2. Look for the chatbot bubble in the bottom-right corner
  3. Click to open the chat window
  4. The chatbot should load with your configured settings

Check Synced Content​

Joomla Knowledge Base

  1. Log in to your AI SmartTalk account
  2. Go to Knowledge section
  3. 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​

  1. Ask a question about your Joomla content
  2. The chatbot should respond with accurate information
  3. 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:

  1. The plugin will automatically clean up:
    • Remove sync tracking columns from database tables
    • Delete all synced content from AI SmartTalk
  2. Go to Extensions > Manage > Manage
  3. Search for AI SmartTalk
  4. 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

Ready to elevate your
user experience?

Deploy AI assistants that delight customers and scale with your business.

GDPR Compliant
Start Free TrialAccess Backoffice