Add Olotalk to Joomla

Joomla installs site-wide scripts through a Custom module published to a footer position.

You’ll need your Assistant ID (ast_oltk_…) from your assistant’s Install step. This guide covers Joomla 4 / 5. New here? Start with the Quick start.

Install via a Custom module

Go to System → Manage Panel → Site Modules, click New and choose the Custom module type. In the editor, click Toggle editor to switch to code / source view — the visual editor strips <script> tags — and paste:

<script
  src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
  data-olotalk-assistant-id="YOUR_ASSISTANT_ID"
  async
></script>

Then:

In the module’s Advanced options, set Prepare Content to No so content plugins don’t rewrite the markup.
Set the module Position to a footer position in your template.
Under Menu Assignment, assign it to all pages, set Status to Published, and save.

If Toggle editor doesn’t switch to code view, set your editor to None under Users → Manage → (your profile) → Basic Settings → Editor, paste the script, save, then switch the editor back. Clear the site cache if the launcher doesn’t appear.

Allow your domain

Joomla is self-hosted, so add the exact hostname(s) where your site runs — production and any staging hostname — under your assistant’s Install domains.

Verify

Open your site and look for the chat launcher in the bottom-right. Then check your dashboard: the Install step’s Install status card shows Seen on yourdomain.com once the snippet loads — with a one-click fix if the domain isn’t allowed yet. Nothing there? See Troubleshooting.