#WHMCS & Sirportly Integration

This module allows you to fetch data from your WHMCS installation to display within Sirportly, it also allows clients to view, open and reply to support tickets from within the WHMCS clientarea.

To install you need to download the files within the repo and upload them to;

WHMCS_ROOT/modules/addons/sirportly

Once the files have successfully uploaded navigate to the WHMCS administration area and click (Setup > Addon Modules)

Here you will see a list of modules that have been uploaded, within this list you will see Sirportly. Click the 'Activate' link to begin setting up the module.

API URL this is the end point for the API. If you are using the cloud version you should leave this value to the default 'api.sirportly.com' otherwise you should enter the URL of your installation.

API Token This must be generated by an account administrator within the Sirportly user interface.

API Secret This must be generated by an account administrator within the Sirportly user interface.

Use SSL Connect to the API via SSL?

Within WHMCS navigate to (Addons > Sirportly), here you will see a list of columns that you may select that will be passed to Sirportly. To setup the Data Source within Sirportly navigate to the Automation & API section of the admin page and click 'Data Sources' then the 'Add New Data Source' button. Here you will be presented a form;

Name Enter a memorable name for the datasource, 'WHMCS' is a good start.

URL Here you need to enter the URL of WHMCS plus /modules/addons/sirportly/api.php For example http://www.example.com/modules/addons/sirportly/api.php

Username The username for a WHMCS administrator.

Password The password for the above administrator.

The module also allows Sirportly to takeover the support ticket area within the clientarea so all new tickets are submitted to Sirportly, to enable this option navigate to (Addons > Sirportly) within the WHMCS administration area and click the 'Support Tickets' link. You will now be presented with three options;

Brand Firstly you need to select the brand.

New Ticket Status This is the status of the ticket when it is first opened.

Default Ticket Priority The client can still choose the priority when submitting a ticket.

Once all three options are saved all support tickets will be added to Sirportly, not WHMCS.

'SSO' allows you to integrate your public interface with WHMCS, all you need to do is navigate to your Sirportly administration area > Public Interfaces > click the link > SSO

SSO URL This is the URL to your WHMCS installation and the following /modules/addons/sirportly/sso.php

The rest of the fields are optional

To show a Sirportly knowledge base instead of the built-in version you need to navigate to the WHMCS admin area, Setup > Addon Modules and enter the ID of a knowledge base from within Sirportly in to the field Knowledge Base ID