DocsGet started

Install the Makli addon for WHMCS

Download the Makli addon, upload it to WHMCS, activate it and connect it to your Makli account with your connection key. About 10 minutes.

This takes about 10 minutes. You need administrator access to WHMCS and a way to upload files to your WHMCS server, such as an FTP client or your control panel's file manager.

Before you start

  • WHMCS 8 or later.
  • PHP 8.1 to 8.4 with the cURL and zip extensions, and the ionCube Loader. WHMCS needs the ionCube Loader too, so your server almost certainly has it.
  • Your WHMCS must be reachable from the internet over HTTPS. Makli calls back to your WHMCS to post replies and run the actions you allow.
  • An approved Makli account. See Create your account.

1. Download the addon

  1. Sign in to the Client Portal and open WHMCS addon in the menu. Setup step 2 links there too.
  2. Choose the build for your WHMCS server's PHP version:
    Your PHPDownload
    8.1 – 8.4PHP 8.1 – 8.4 (ionCube Loader 15). Recommended for current servers.
    8.1 – 8.3PHP 8.1 – 8.3 (ionCube Loader 14)
    8.1 – 8.2PHP 8.1 – 8.2 (ionCube Loader 13)
    Not sure? In WHMCS open Utilities → System → PHP Info and look for PHP Version and ionCube Loader.

The page also lists the latest version, its SHA-256 checksum and what changed.

2. Upload it to WHMCS

Unzip the download. Upload the makli folder into modules/addons/ in your WHMCS installation, so that this file exists:

<your WHMCS>/modules/addons/makli/makli.php

3. Activate and give access

  1. In WHMCS go to Configuration → System Settings → Addon Modules (Setup → Addon Modules in older versions).
  2. Find Makli - AI Support Agent and click Activate.
  3. Click Configure. Under Access Control, tick the admin roles that may use Makli, for example Full Administrator. Then click Save Changes.
Leave Refresh Database unticked. It deletes Makli's data when the addon is deactivated. Enable Module Logs is for troubleshooting only.

4. Connect it to your Makli account

  1. In the Client Portal, copy your connection key. You find it under Setup, step 2 "Connect WHMCS", or under Integrations.
  2. In WHMCS open Addons → Makli - AI Support Agent → Settings → Connection.
  3. Paste the key, click Save, then Test connection.

The test checks both directions. Both must turn green:

  • The Makli server accepts signed requests from this WHMCS: your key is right.
  • The Makli server can reach this WHMCS: Makli can call back to your WHMCS.

The Client Portal then shows your WHMCS as connected, and its Setup moves on by itself.

5. Finish setup

The addon's Setup tab lists what is left before Makli can be switched on. Most of it is done in the Client Portal:

  • describe your business;
  • finish AI Training;
  • set a reply signature;
  • choose the departments Makli works on;
  • review what Makli may do.

Continue with Train Makli.

Troubleshooting

What you seeWhat to do
"The key is not linked to an organisation"Copy the key again from the Client Portal. If the key was rotated, only the newest one works.
"The Makli server rejected the signature"Paste your organization's current connection key. Keys change when they are rotated.
"Makli knows your key, but could not reach this WHMCS from outside"Your WHMCS address must be public over HTTPS. Check that no firewall, security plugin or bot challenge blocks modules/addons/makli/api.php.
"The Makli server did not answer"Your WHMCS server could not reach agent.makli.com. Check its outgoing HTTPS connections, then try again.
A page about the ionCube Loader instead of the addonYou uploaded the build for another PHP or ionCube version. Download the build that matches your server, then upload it again.
Your control panel refuses the zip: "Sanesecurity.Foxhole.JS_Zip … FOUND"The file is not infected. That antivirus rule flags any JavaScript file inside a zip, and the addon ships JavaScript for its screens. Unzip it on your computer and upload the makli folder over FTP or SFTP instead.
No Makli under AddonsYour admin role has no access. Tick it under Access Control in the addon's configuration.

Updates

New versions come from your Makli account. You do not need a licence key.

  • While Settings → Advanced → Install Makli updates automatically is on (the default), the WHMCS daily cron installs new versions by itself.
  • To check now, open the Info tab and click Check for Updates. It shows the latest version, what changed and the last check.
  • To install an update, the web server must be able to write to the modules/addons/makli folder. If it cannot, nothing is changed and the Info tab names the file it could not write.
  • An update never replaces chat uploads or the WhatsApp gateway's own files: its configuration, session and logs.

You can also download the newest version from the Client Portal at any time and upload it over the old one.

Remove the addon

  1. To delete Makli's data from WHMCS, tick Refresh Database in the addon's configuration first. Otherwise your data is kept.
  2. Go to System Settings → Addon Modules → Makli - AI Support Agent → Deactivate.
  3. Delete the modules/addons/makli folder.

Last updated 17 November 2026