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_