How to Add Asyntai AI Chatbot to Joomla
Step-by-step guide for Joomla websites
Step 1: Get Your Embed Code
First, go to your Asyntai Dashboard and scroll down to the "Embed Code" section. Copy your unique embed code which will look like this:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Note: The code above is just an example. You must copy your own unique embed code from your Dashboard as it contains your personal widget ID.
Step 2: Add Code Using Custom HTML Module (Recommended)
The easiest way to add the chatbot to all pages is using a Custom HTML module:
- Log in to your Joomla Administrator panel
- Go to Content → Site Modules
- Click "New" to create a new module
- Select "Custom" (Custom HTML module)
- Enter a title like "Asyntai Chatbot" (you can hide this later)
- Click the "Toggle Editor" button to switch to raw HTML mode
- Paste your Asyntai embed code
- In the "Position" field, select a footer position (e.g., "footer" or "debug")
- Set "Show Title" to "Hide"
- Under the "Menu Assignment" tab, select "On all pages"
- Click "Save & Close"
Tip: If your code gets stripped, go to System → Global Configuration → Site and temporarily set the Default Editor to "None", add your code, then switch back.
Alternative: Edit Template Files
You can add the code directly to your template's index.php file:
- Go to System → Site Templates
- Click on your active template name
- Find and click on "index.php" in the file list
- Scroll down to find the closing
</body>tag - Paste your Asyntai embed code just before the
</body>tag - Click "Save"
Important: Changes to template files will be lost when you update your template. Consider using a child template or the Custom HTML module method for a more permanent solution.
Alternative: Using an Extension
You can also use a free extension to add custom scripts:
- Go to the Joomla Extensions Directory
- Download the "Add Custom Javascript" extension
- In your Joomla admin, go to System → Install → Extensions
- Upload and install the extension
- Go to Components → Add Custom Javascript
- Add your Asyntai embed code
- Configure it to load on all pages
Step 3: Verify Installation
After saving your changes, visit your website in a new browser tab or incognito window. You should see the chat widget button in the bottom right corner. Click it to make sure it opens and works correctly.
Not seeing the widget? Clear your Joomla cache by going to System → Clear Cache and clicking "Delete All". Also try clearing your browser cache or viewing in an incognito window.