PortaOne Recording interface

This is the Datatex Porta One Donwload software.
Requirements

  • HTTPS Address for the PortaOne
  • Recording must be enabled for the tenants that you require to download.
  • API Key for the tenants that you want to download.

API Endpoints used:
These are the endpoints that the API requires READ access.

  • /rest/Account/get_account_list
  • /rest/Account/get_xdr_list
  • /rest/CDR/get_call_recording
  • /rest/Customer/get_customer_list
  • /rest/Customer/get_customer_xdrs
  • /rest/Session/login

Location
/opt/datatex/portaone/

Main INI File
dtxportaone.ini

[SETTINGS]
#Location where all the tenant files will be stored. 
TENANTPATH=/opt/datatex/portaone/tenant/
WORKPATH=/opt/datatex/portaone/work/

#Recording file prefix
SERVERID=SKY4_

NOTIFICATIONURL=https://notifications.datatex.co.za/webservice/error/

#Recorded Device Prefix. Leave blank if you do not want an extension prefix. 
PREFIX=SKYWIRE_
TIMEZONESECONDS=7200

#Print Verbose logs 
VERBOSE=1
#Download all the CDR data, not just the recorded devices. 
DOWNLOADALLCDR=1

[IRECALL]
TENANTID=SKYWIRE
SOFTWAREID=DTXPORTAONE
PABXID=

Tenant Setup
Create a tenant folder within the location specified in the Main INI TENANTPATH

E.g. /opt/datatex/portaone/tenant/my_client/

and then create a tenant.ini file like this
Run ./dtxportaone --verbose and if the file doesn’t exist, it will create it with blank values.

The port for the API can be different, depending on the API key that was generated.

[TENANT]
PABXIP=porta.myporta.co.za
ENABLED=1
PABXAPIPORT=8444
PABXLOGIN=My_Client_Login
#If there is a password filled into this field when he software runs, it will encrypt the value and remove the unencrypted value. 
PABXPASSWORD=

#If there is a password filled into this field when he software runs, it will encrypt the value and remove the unencrypted value. 
APIKEY=
#Do not download files shorter than this amount of seconds. 
MINIMUMDURATION=0
TENANTNAME=My_client_name
AUTORECORDDID=0
AUTORECORDIVR=0
#Download recordings for all devices. 
RECORDALL=1
#Download all the device's CDR
DOWNLOADALLCDR=1
ENCAPIKEY=DTX4x31lmh+acmR+M1+233+rcgbs61eyzBv1O7954qg9M7efIbRtw8kCxJEE7eS0fR2QtLtk/ATn7KgX+x6pLarEw==
#The PortaOne Customer Number 
CUSTOMERNUMBER=5807
TENANTID_OVERRIDE=MYREFIX_MYCOMP
#If you require a prefix to make the extensions stand out from other clients on the same system, you can add an extension prefix. Leave blank and it will use the MAIN prefix. 
EXTENSIONPREFIX=EXTPREF_