Asterisk VoIP Center For WHMCS
|Asterisk VoIP Center For WHMCS will allow you to integrate Asterisk server with your own WHMCS to remotely monitor, replay and originate all the VoIP calls.
The module offers connection owing to which you will be able to view detailed listing of calls and filter them, configure extensions and call in/out pop-up templates, and much more.
- Admin Area Features:
|✔ View Call Logs With Detailed Information|
|✔ Playback Call Records|
|✔ Filter Call Logs|
|✔ Create Notes For Each Call Record|
|✔ Display Pop-ups For Incoming And Outgoing Calls|
|✔ Originate Call From Addon Module Pop-up|
|✔ Originate Call From Widget|
|✔ Originate Call With One Click From Clients Profile Or Custom Field At Client's Product|
|✔ Set Up Custom Field To Be Used As Phone Number|
|✔ Assign Extensions To Admin Accounts|
|✔ Configure Internal Extensions|
|✔ Access Control List To The Module Settings|
|✔ Edit Incoming And Outgoing Calls Pop-up Templates|
|✔ Access Call Logs Tab At Clients Profile|
|✔ Add New Call Record In Call Log Tab At Clients Profile|
- General Info:
|✔ Integrated With SMS Center For WHMCS - Receive SMS Notifications About Missed Calls (read more)|
|✔ Multi-Language Support|
|✔ Supports PHP 5.4 Up To PHP 7|
|✔ Supports WHMCS V6 and V7|
Installation and Configuration
|This tutorial will show you how to successfully install and configure Asterisk VoIP Center For WHMCS. |
We will guide you step by step through the whole installation and configuration process.
|1. Log in to your client area and download the module.|
|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 7, while the second one is aimed at PHP 5.4 up to PHP 5.6.
It does not apply to open source versions.
Note: You can check 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.
|4. When you install Asterisk VoIP Center For WHMCS for the first time you have to rename 'license_RENAME.php' file.|
File is located in 'modules/addons/AsteriskVoipCenter/license_RENAME.php' . Rename it from 'license_RENAME.php' to 'license.php' .
|5. In order to configure your license key, you have to edit a previously renamed 'license.php' file.|
Enter your license key between quotation marks as presented on the following screen. You can find your license key at your client area → 'My Products' .
|6. Now you have to activate the module in your WHMCS system.|
Log in to your WHMCS admin area. Go to the 'Setup' → 'Addon Modules' . Afterwards, find 'Asterisk VoIP Center' and press 'Activate' button.
|7. In the next step you need to permit access to this module.|
To do so click on 'Configure' button, tick 'Access Control' near desired admin role groups and press 'Save Changes' .
|8. Now, set up a cron job (each 5 minutes suggested).|
Remember to replace 'your_whmcs' with your WHMCS root directory.
'php -q /you_whmcs/modules/addons/asteriskVoipCenter/cronjob.php' .
|9. Proceed to the 'Addons' → 'Asterisk VoIP Center ' → 'Base Settings' .|
|10. Now, fill out 'Server Settings' panel to configure connection with Asterisk server.|
The credentials that must be used here are Asterisk Manager User Details.
|11. Proceed to 'Base Settings' panel to define additional configuration.|
|12. 'Access Control List' allows you to define who (besides Full Administrators) can access 'General Settings' page.|
You can allow access for a specific admins or admin roles.
|13. Last step of configuration is editing templates used as call in/out pop-up templates.|
As you can see on the following screen, default pop-up templates are installed automatically during activation of the module.
|14. Screen below presents pop-ups which are using default templates.|
FreePBX Server Configuration
|This section describes additional configuration allowing you to replay recorded calls from WHMCS system.|
15. Upload 'getrecord.php' file located in the Asterisk VoIP Center package into root public folder of your Asterisk server.
|16. Edit previously uploaded file, fill in your WHMCS server IP and previously generated 'Call Recording API Key'.|
|17. Afterwards, force call recording, to do so proceed to 'Applications' → 'Extensions' and edit extension you wish to enable call recording for.|
Force call recording for each extension as shown on the following screen.
|18. You have just successfully installed Asterisk VoIP Center For WHMCS!|
|At this section we will show you possibilities of Asterisk VoIP Center For WHMCS.|
Our module allows you to view log of all calls with their details and originate new calls both with client and custom numbers.
|At the 'Call Logs' tab you can find list of all calls made through your Asterisk server.|
You can find there a lot of useful information such as caller, destination, call duration and time.
|Press 'Call Details' as shown on the following screen to view more information about a call.|
|The pop-up with detailed information about the call will show up. You can also playback the call record at any time here.|
|This tab allows you to assign extension to each administrator account existing on your WHMCS server.|
|This feature extends possibilities of your Asterisk server.|
At the 'Originate Call' tab you are able to originate a call between two numbers.
|Test call allows you to view extended information about call origination.|
Asterisk Manager Call Out Widget
|Along with our module you will receive 'Asterisk Manager Call Out Widget' .|
This widget allows you and any of yours administrators to easily create new call from your WHMCS system.
Client Profile Integration
|As soon as you install your Asterisk VoIP Center For WHMCS, new functionality will appear at the admin area → Client Profile.|
Owing to our module you are now able to originate a call with your client through one click as shown on the following screen.
|Please note that a 'Phone Number' field on 'Products/Services' page is only for the client op keep data.|
|You can easily access call logs of a client and view all details of a call.|
Furthermore, you can add here calls which was made outside of your system.
SMS Center For WHMCS Integration
|If you have SMS Center For WHMCS in your system, you can configure it to send unanswered call notification to an administrator who missed a call.|
Firstly, create an e-mail template to send such notification. Then move to SMS Center addon, configure the equivalent text message and enable it.
|Secondly, go to Asterisk VoIP Center → 'Base Settings' page.|
Proceed to panel 'SMS Center integration' and choose a previously created SMS template from 'Unanswered Call SMS Template'.
|1. List of variables supported by templates. 'Addon' → 'Base Settings' → 'Templates'.|
<%= id %> -Id of log in the database <%= channel %> - connection channel (http://www.voip-info.org/wiki/view/Asterisk+channels) <%= extension %> - extension in Asterisk <%= callerid %> - Id number of the caller <%= callername %> - username of the caller <%= connectedlinename %> - name of the channel line <%= connectedlinenum %> - number of the channel line <%= uniqueid %> - ID of a single action saved in Asterisk <%= linkedid %> - linking action ID <%= destuniqueid %> - id of a receiving side of the call <%= timestamp %> - time the call was logged <%= hangupstamp %> - time the call was interrupted <%= hangupcause %> - the reason the call was interrupted <%= notes %> - any notes made by admin <%= clientid %> - id of a client is such has been found on the basis of the number <%= clientname %> - username of a client is such has been found on the basis of the number <%= isCallOut %> - defines if the call is of a call-out type
|1. When you have problems with connection, check whether your SELinux or firewall does not block ports.|