Emoji Picker For WHMCS
Contents |
About Emoji For WHMCS
Emoji For WHMCS xxxxxxxxxxxxxxxxxxxxxxxx
xxxxxxxxxxxxxxxxxxxxxx |
- Client Area Features:
✔ xxxxxxxxxxxxxxx |
✔ xxxxxxxxxxxx |
✔ xxxxxxxxxxxxxx |
✔ xxxxxxxxxxxxxxx |
✔ xxxxxxxxxxxxxxx |
- Admin Area Features:
✔ xxxxxxxxxxxxxxx |
✔ xxxxxxxxxxxxxxx |
✔ xxxxxxxxxxxxxxx |
✔ xxxxxxxxxxxxxxx |
✔ xxxxxxxxxxxxxxx |
✔ xxxxxxxxxxxxxxx |
- Integration Features:
✔ xxxxxxxxxxxxxxx |
✔ xxxxxxxxxxxxxxx |
✔ xxxxxxxxxxxxxxx |
✔ xxxxxxxxxxxxxxx |
- General Info:
✔ Emoji Artworks Provided By EmojiOne |
✔ Custom Templates Support |
✔ Multi-Language Support |
✔ Supports PHP 5.6 Up To PHP 7.2 |
✔ Supports WHMCS Template Six |
✔ Supports WHMCS V7 |
Installation and Configuration
This tutorial will show you how to successfully install and configure Emoji For WHMCS. We will guide you step by step through the whole installation and configuration process. |
Installation
1. Log in to our client area and download the module. |
File:EM2 1.png |
2. In the downloaded file you will find two packages that support different PHP versions. As presented on the screen below, the first one is dedicated to PHP 5.6 up to PHP 7.0, while the second one is aimed at PHP 7.1 up to PHP 7.2. It does not apply to open source versions. Note: You can check the current PHP version in your WHMCS. To do so, proceed to 'Utilities' › 'System' › 'PHP Info'. |
3. Extract the downloaded file and choose the one with the right PHP version. Upload and extract the PHP file into the main WHMCS directory. The content of PHP version files should look like this. |
File:EM2 2.png |
4. When you install Emoji For WHMCS for the first time you have to rename 'license_RENAME.php' file. File is located in 'modules/addons/Emoji/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'. |
File:EM2 3.png |
5. 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 our client area → 'My Products'. |
File:EM2 4.png |
Activation
6. Now, you have to activate the module in your WHMCS system. Log in to your WHMCS admin area and proceed to 'Setup' → 'Addon Modules'. |
File:EM2 5.png |
7. In the next step you need to permit access to this module. To do so, click on the 'Configure' button and tick the checkboxes to assign desired admin roles. |
File:EM2 6.png |
8. You have just successfully installed Emoji For WHMCS! |
Configuration
Now you have to configure your newly installed module. Before we proceed to the configuration itself, you have to log in to your Emoji account to find your API details. |
API Connection
Firstly, log in to your Support Portal in order to find the API key. |
File:EM2 8.png |
Find your way to the 'Administration' section by clicking the cogwheel symbol at the bottom of the page. |
File:EM2 81.png |
Now, scroll down a bit the menu on the left to see the 'SECURITY' heading at the bottom. You should also be able to spot the 'Authentication' category, click it. Once there, go to the 'Customers' tab. Make sure Single sign-on (JWT) is selected. |
File:EM2 91.png |
Remember to save the settings when ready. |
Server Configuration
Now, that you have safely stored your API, you can move to another part of the configuration. Proceed to 'Addons' → 'Emoji' → 'Server Configuration', here you have to fill in the data required to connect your WHMCS with Emoji server. |
File:EM2 13.png |
Enter your Emoji details:
Finally, test connection and if it is successful save changes. |
File:EM2 14.png |
Finally, move to 'Setup' → 'General Settings' → 'Support'. Then choose the 'EmojiSupport' module from the drop-down list and save changes. |
File:EM2 6 1.png |
Good job! Now your WHMCS is connected to Emoji support system. |
Management
Once Emoji For WHMCS is installed and connection configured, you can create/update your ticket departments and begin using them. Each ticket department you create in the Emoji will be available for your customers in the WHMCS client area. |
Settings
WHMCS
Before you start your actual work on support tickets with Emoji For WHMCS, move again to 'Addons' → 'Emoji' → 'Ticket Settings'. This section of the addon allows an easy and comfortable management of the way the tickets are displayed in your client area, their visibility, sorting etc. |
File:EM2 15.png |
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:
|
File:EM2 16.png |
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. |
File:EM2 17.png |
Tickets of each status are now marked with selected colors in client area. |
File:EM2 18.png |
Export
Our module allows to export data gathered in your WHMCS, more specifically, all the users and tickets generated before the installation of the product. Read the below points to learn what data can be synchronized with Emoji and what are the possible means of such synchronizations. |
Users
The first option offered by our module is the export of users from WHMCS to Emoji, proceed to 'Clients Export' . Here you will find a list of all the users who exist in your WHMCS and have not been synchronized with Emoji yet. |
File:EM19.png |
Now, you can either manually export all of them from the list or choose only a few. Check boxes next to the users you wish to export and press 'Export' button as presented on the screen. |
File:EMD20.png |
If some users have been already exported from WHMCS to Emoji, they will be marked as Exported on the list. All users newly added to WHMCS will be automatically synchronized with Emoji. |
Tickets
The next option offered by our module is the export of tickets from WHMCS to Emoji, proceed to 'Tickets Export'. You will see here a list of all tickets which exist in your WHMCS and have not been synchronized with Emoji yet. |
File:EM23.png |
Now, you can manually export all of the tickets available on the list or choose only some of them. Check boxes next to the tickets you are going to export and press the 'Export' button as marked on the screen. |
File:EM24.png |
If a ticket has already been exported from WHMCS to Emoji, it will now have the Exported status. All tickets newly created to WHMCS will be automatically synchronized with Emoji. |
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. |
File:EM2 21.png |
Now, we will create a ticket message to show the flow. Just like in case of standard WHMCS support ticket, choose department, fill out the form and submit the ticket. |
File:EM2 22.png |
A new ticket, sent with Emoji For WHMCS module, is immediately visible in the Emoji admin area. |
File:EM2 23.png |
Do not hesitate and send a reply to this ticket. |
File:EM2 24.png |
Client has received an answer. Note that the ticket status has been updated as well. |
File:EM2 25.png |
Tips
1. Exporting clients or tickets in the current module version may seem a bit slow. This is due to the Emoji API limitations, for this reason a more efficient export method could not be implemented. |
2. Once the module is configured, support team can manage new tickets only from the Emoji panel. They will no longer appear in the WHMCS administration support section. |
3. The module does not support 'Emoji Classic' . Only Emoji cloud-based platform is supported. |
Update Instructions
Essential guidance through the process of updating the module is offered here. Keep in mind there is a quick and easy option in our client area that will let you upgrade the license of your module to an open source version at any time - and at a lower price! |
Common Problems
1. When you have problems with connection, check whether your SELinux or firewall does not block ports. |
2. The module supports only the WHMCS built-in ticket system. Separate ticketing systems such as Zendesk, Kayako or Freshdesk are not supported. |