Zendesk For WHMCS
Article update is ongoing on this page, watch out for broken links and unclear descriptions!
We are sorry for the inconvenience caused.
Contents |
About Zendesk For WHMCS
Zendesk For WHMCS allows your customers to use a complex support system solution in your own WHMCS. With our module your clients will be able to manage Zendesk tickets as if they were a part of your system. |
- Client Area Features:
✔ View Zendesk Departments |
✔ Open New Ticket |
✔ Manage Existing Tickets |
✔ Fill Out Zendesk Ticket Fields |
✔ Attach Files To Ticket |
✔ List Recent Tickets |
- Admin Area Features:
✔ Configure And Test Server Connection |
✔ Disable SSL Verification |
✔ Define Module Behavior |
✔ Define Ticket Status Colors |
- Integration Features:
✔ Single Sign On (SSO) Integration |
✔ Synchronize User Accounts Between WHMCS And Zendesk |
✔ Transfer Ticket Fields Settings |
✔ Transfer Attachments Settings |
✔ Convert Markdowns To HTML |
- General Info:
✔ Custom Templates Support |
✔ Multi-Language Support |
✔ Supports WHMCS Templates Five and Six |
✔ Supports WHMCS V5 and V6 |
Installation and Configuration
This tutorial will show you how to successfully install and configure Zendesk For WHMCS. We will guide you step by step through the whole installation and configuration process. |
Installation
1. Log in to your client area and download Zendesk For WHMCS. |
2. Upload and extract the module into the main WHMCS directory. Files in your WHMCS directory should look like on the following screen. |
3. When you install Zendesk For WHMCS for the first time you have to rename 'license_RENAME.php' file. File is located in 'modules/addons/Zendesk/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'. |
4. In order to configure your license key, you have to edit the previously renamed 'license.php' file. Enter your license key between quotation marks as presented on the following screen. You can find your license key in your client area → 'My Products'. |
Activation
5. Now, you have to activate the module in your WHMCS system. Log in to your WHMCS admin area and proceed to 'Setup' → 'Addon Modules'. |
6. In the next step you need to permit access to this module. To do so, click on 'Configure' button, tick checkboxes to assign desired admin roles. |
7. You have just successfully installed Zendesk For WHMCS! |
Configuration
Now you have to configure your newly installed module. Before we proceed to the configuration itself, you have to generate your API details to connect with your Zendesk account. |
API Connection
Firstly, log in to your Zendesk admin area in order to enable API access. |
Go to 'Admin' → 'Channels:' 'API'. There, in 'Settings' section find 'Token Access' and enable it. Add new token or use existing one. Copy an active API token. |
Now go to 'Settings' → 'Security' section and enable 'Single-Sign On'. Here you can also check your remote login URL and remote logout URL. |
Copy and keep your 'shared secret' in a safe place. We will need it in the next step. Note that Shared secret is not required for Zendesk module to work itself. It is needed for SSO only. |
Server Configuration
Now, that you have safely stored API and Shared Secret tokens, you may move to the second part of configuration. Proceed to 'Addons' → 'Zendesk' → 'Server Configuration', here you have to enter any data required to connect your WHMCS with Zendesk server. |
Enter your Zendesk details:
Finally, test connection, if it is successful save the changes. |
Finally, move to 'Setup' → 'General Settings' → 'Support'. There choose 'Zendesk' support module form dropdown menu. Save changes. |
Good job! Now your WHMCS is connected with Zendesk support system. |
Management
Once Zendesk For WHMCS is installed and connection configured, you can create/update your ticket departments and begin using it. Each ticket department you create in the Zendesk will be available for your customers in WHMCS client area. |
Settings
WHMCS
Before you start your actual work on support tickets with Zendesk For WHMCS, move again to 'Addons' → 'Zendesk' → 'Ticket Settings'. This section of the addon allows easy and comfortable management of the way tickets are displayed in your client are, their visibility, sorting etc. |
In the first box 'Options', you may enable some basic settings that will be applied to tickets view in the client area. Let's now discuss their functionality in details:
|
Next to the 'Options' box you will find a box where you can assign some colors to a specific ticket status. Click on the field to choose a color from the palette of colors or type in the number of the color you like. |
Tickets of each status are now marked with selected colors on homepage. |
Zendesk
You can also manage ticket fields, that are available in WHMCS on a new ticket form, directly in Zendesk. Move to 'Zendesk' → 'Admin' → 'Manage' → 'Ticket Fields'. On this site you can activate/deactivate/edit any system and custom fields or add new ones. |
As you can see on the screen below, a new field appeared in WHMCS client area. Edit/add ticket fields to adjust the ticket form perfectly to your needs. |
Support Tickets
Move to your Client Area. There, on your homepage, is a 'Recent Support Tickets' box. You will find the latest tickets available in your system. The visible tickets are marked with colors related to their current status. |
Now, we will create a ticket message to show the flow. Just like in case of standard WHMCS support ticket, choose department, then enter subject, type in the ticket message and fill out any additional ticket fields that you feel are useful and will help you get a satisfactory answer faster. Submit the ticket. |
A new ticket, sent with Zendesk For WHMCS module, is immediately visible in Zendesk admin area. |
Do not hesitate and send a reply to this ticket. |
Client has received an answer. Note that the ticket status has been updated as well. |
Tips
1. If you create a custom field in Zendesk, it will be also visible in WHMCS. Custom fields need to be enabled/visible/editable_by_client. |
2. When you add ' |clientservice' at the end of the custom field title, a select with list of products and domains will show up. |
3. Since Zendesk does not fully support WHMCS option to reopen closed tickets, 'Close ticket 4 days after status is set to solved' option is currently the only possibility to get around it. To enable configure this option proceed to Zendesk → Business Rules → Automations. Find there the option and edit it. |
Here you can configure the time until when tickets can be reopened by an answer from the client. Maximum possible time is now 672 hours (28 days). |
Common Problems
1. When you have problems with connection, check whether your SELinux or firewall does not block ports. |
2. When you try to open a new ticket and you get error 'Unable to authenticate' , this means that the user's email is already registered in Zendesk, but it's not verified yet. To solve the problem log in to your Zendesk admin area and verify the email through clicking 'Verify now' as presented on the screen below. |