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.
What It Can Do
| Capability | How it helps support |
|---|---|
| Client lookup | Match tickets to the right WHMCS customer account |
| Service and product context | Explain what plan, product, domain, or service the customer has |
| Invoice context | Answer billing-status questions such as unpaid invoice or renewal context |
| Ticket linking | Keep generated replies connected to the original WHMCS ticket |
| Response grounding | Combine WHMCS data with Knowledge Base and server integration context |
What It Cannot Do
| Not supported by default | Why this matters |
|---|---|
| Replace staff review | Replies are drafts unless your team enables automation rules |
| Change products, invoices, services, or client records | Customer-impacting WHMCS changes stay in your normal admin workflow |
| Reveal passwords, API secrets, or private notes | Sensitive internal data should not be included in customer replies |
| Guarantee good answers without content | Knowledge Base and Tweaking still determine response quality |
Security / Permissions
WHMCS uses an API token and webhook token generated during connection. Copy them once, save them in the WHMCS addon module, and regenerate the connection if a token is lost or exposed. Auto-replies are controlled separately in Konrado.AI Automation; connecting WHMCS does not mean every AI draft is sent automatically.
Ticket Examples
- "Why was my invoice generated?"
- "Which service is connected to this domain?"
- "Is this customer's hosting package active?"
- "Can you include the unpaid invoice context before replying?"
- "Does this ticket match the same client as the WHMCS account?"
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.