The PortaOne add-on is used to import customers' calls from the PortaOne software system into Splynx.
Individual calls and their prices (CDRs) can be shown in Splynx as Statistics within the customer profile and their Customer Portal. These calls can also be included in a customer’s PDF invoices.
The add-on can be installed via one of two methods: via CLI or the Web GUI.
To install the PortaOne add-on via CLI, the following commands should be used:
apt-get update apt-get install splynx-portaone
To install the addon via the Web GUI:
Navigate to Config → Integrations → Add-ons.
Locate or search for the "splynx-portaone" add-on and click on the install icon in the Actions column:
- Click on the OK, confirm button to begin the installation process:
Navigate to Config → Integrations → Modules list and search for splynx_addon_portaone.
Then click the Edit (Config) button to perform the basic configuration:
PortaOne API settings
- API URL - PortaOne API URL;
- Login - your login to access the PortaOne API;
- Password - your password to access the PortaOne API;
- Token - your token to access the PortaOne API.
The PortaOne software system:
- Import CDR from date - the date (in 'yyyy-mm-dd' format) used as the start date for the CDR import for newly paired PortaOne customers. If left empty, the start date will be one day before the first import date;
- Import CDR by cron - import PortaOne CDRs using cron. CDRs will be imported from PortaOne to Splynx daily at 01h00. If disabled, no CDRs will be imported from PortaOne.
Customer account settings
The PortaOne customers ids field will automatically appear after the add-on installation under the customer's Additional information.
When the basic configuration is done, add the PortaOne ID for each customer that should import calls:
The customer’s phone number should also be set in the relevant voice service:
Voice processing configuration
The next step is to configure the Auto CDR processing.
An import data source should be created in Config → Voice → Import data source.
- Set a relevant name.
- Select “Local” as the Data source type.
- Use the following default path: /var/www/splynx/addons/splynx-portaone/data/files
Then navigate to Config → Voice → Auto CDR processing and create an Auto CDR processing entity where we should define the data source to import from as well as the PortaOne handler (auto-created by the addon):
The system will now auto-process voice calls from the addon local folder using the defined interval.
Splynx PortaOne Integration
Under Config → Integrations → Splynx PortaOne Integration, you can import CDRs and logs, as well as manually pair customers.
To import CDRs, click on the gear button at the top right corner of the page and choose
To import the log, click on the gear button at the top right corner of the page and choose
Customers manual pairing
To perform the customers manual pairing, click on the gear button at the top right corner of the page and choose
Customers manual pairing:
Then, select Pair next to the customer name. The status will change from Not paired to Paired, indicating a successful pairing: