Connect WHMCS
Install the Konrado.AI WHMCS module and connect it to the Konrado.AI platform
This guide installs the Konrado.AI addon module in WHMCS, generates the connection tokens, and verifies the integration in one flow.
Estimated time: 10 minutes
Compatibility
The Konrado.AI WHMCS module is supported on:
- WHMCS 7.10 or newer
- PHP 7.4 or newer
Before You Start
- A WHMCS instance that meets the compatibility requirements.
- WHMCS admin access with permission to manage addon modules.
- Access to Konrado.AI Integrations.
- If WHMCS is behind a firewall, allow the Konrado.AI static IP addresses.
What This Connects
Konrado.AI reads WHMCS clients, services, products, invoices, and ticket links so AI replies can include billing and service context.
Install the Module
After upload, this directory must exist in your WHMCS installation:
modules/addons/KonradoAI/In WHMCS, open System Settings > Addon Modules, find Konrado.ai, click Activate, then click Configure.
Select the admin roles that can access the module and save the configuration. Leave the token fields empty until the next step.
Generate Tokens
In Konrado.AI, open Integrations, find WHMCS, and click Connect. The modal shows one-time values for:
- API Token
- Webhook Token
Copy both values before closing the modal.
Tokens are shown only once. If you close the modal before copying them, generate a new connection instead of trying to reuse the old values.
Paste Tokens in WHMCS
Return to System Settings > Addon Modules in WHMCS, click Configure next to Konrado.ai, paste the API Token and Webhook Token, then click Save Changes.
Configure the WHMCS URL
Back in the Konrado.AI modal, enter the WHMCS module endpoint. Replace yourdomain.com with your WHMCS domain:
https://yourdomain.com/modules/addons/KonradoAI/api/index.phpIf the modal offers Apply to configuration, use it to fill the generated token fields and confirm they match the values saved in WHMCS.
Verify
Click Test Connection. When the test passes, save the integration. The WHMCS card should show Connected.
Troubleshooting
| Issue | What to check |
|---|---|
| Connection test fails | Confirm the WHMCS URL is public and points to /modules/addons/KonradoAI/api/index.php |
| Tokens were lost or mismatch | Generate a new WHMCS connection in Konrado.AI and paste the new tokens into WHMCS |
| Module not found | Confirm modules/addons/KonradoAI/ exists in the WHMCS root directory |
| 403 Forbidden | Confirm the module is activated and your WHMCS admin role has access |
| Connection times out | Check firewall rules and allow the Konrado.AI static IP addresses |
Remove
To disconnect WHMCS, delete or disable the WHMCS integration in Konrado.AI, then remove the Konrado.ai addon module from WHMCS if you no longer need it.