You're browsing the documentation for an old version of SupportPal. Consider upgrading to the latest version.
WHMCS Integration
Replace WHMCS support components (tickets, announcements, knowledgebase, downloads) with those of SupportPal. The integration also provides a login share between the applications, and mirrors user information.
Download & Requirements
The WHMCS integration is compatible with WHMCS v6 and v7. SupportPal 2.3.0 or later is required.
Please find the latest version of the integration at the downloads page, account login required.
Installation Guide
If you were running the ArcticDesk version of the integration, you will need to delete those files before uploading this version.
- Take a backup of your WHMCS installation (we recommend both files and database).
- Copy all files under the
modules
andtemplates
folders included to your WHMCS installation root folder. - Visit Setup -> Addon Modules in your WHMCS admin area. Locate the SupportPal module and click Activate. This will reload the page, now click the Configure button and tick the access control option for your admin group and save.
- Now visit Addons -> SupportPal Integration, and fill in the values for the configuration options. Each option should have a description that will explain the option further. Only the 'Help Desk URL' and 'API Token' are required options, and you can use the 'Validate Authentication' button to confirm the details are correct.
- Once you have saved the configuration, the page should reload with the status showing as Active - this is when you know that the integration is working.
- Update the presales form destination in WHMCS (Setup -> General Settings -> Mail) to an email address that is linked with a department used in SupportPal. Also enable the 'Prioritise Reply-To' setting in SupportPal (Settings -> Ticket -> Channels -> Email Settings).
- If you are using any custom fields for users within WHMCS, please set up the same fields within SupportPal using the same name. These will be used for mirroring user information between WHMCS and SupportPal.
- Optionally, unpublish/hide all your existing WHMCS announcements so they do not show in the client area.
Please note that the SupportPal template for WHMCS has been created to be compatible with the 'six' WHMCS template. You may need to adjust the template files if you are using another template.
Upgrade Guide
- Take a backup of your WHMCS installation (we recommend both files and database).
- Copy all files under the modules and templates folders included to your WHMCS installation root folder.
- Visit Addons -> SupportPal Integration, and verify that the status is showing as Active. We recommend to check for any new configuration options that may be included in the new version of the integration.