Configure S3 Browser to access call recordings from your CommPeak Cloud PBX or Dialer instance or connect using the AWS CLI V2, configure access rules, and view access log in CommPeak Portal.
You can create accounts for your Cloud PBX or CommPeak Dialer to access files with call recordings via the S3 or FTP protocol.
👍
TIP
We recommend using the S3 protocol to access the Cloud PBX or Dialer bucket and download the call recording files.
Creating Access Accounts
To create an access account:
In the CommPeak Portal expand Dialer and click Dialer Instances.
Dialer Instances page
Alternatively, expand Cloud PBX and click PBX Instances.
PBX Instances page
Locate the needed Dialer or PBX instance, click the corresponding three-dot icon on the right of this instance, and select the Recording Access Accounts option:
Recording Access Accounts option
In the Recordings Access Accounts sidebar that opens, click Add Account.
Recordings Access Accounts sidebar
Choose S3 or FTP protocol, then choose the access type:
View Only to allow downloading the recording files or
View and write to enable downloading , uploading, and deleting the recording files.
Creating an account for accessing recordings
🚧
NOTE
You can create a maximum of two accounts per protocol: one with View Only (Download access) role and one with View and write (Full access) role.
If you try to create a second account of the same access type, the system blocks the action and displays an "Only 1 account allowed of this access type" message.
Only 1 account allowed of this access type message
This limit applies independently to S3 and FTP, so you can have up to 4 accounts in total per instance: 2 S3s (1 View Only + 1 View and write) and 2 FTPs (1 View Only + 1 View and write).
Click Create Account.
A message box with a new S3 token and secret or FTP account credentials will appear on the screen.
❗️
IMPORTANT
Before closing the message box, make sure to copy the FTP password or S3 secret because it will not be shown again.
You will be able to reset your FTP account password later. Resetting the S3 secret is not possible.
When added, the new account appears in the sidebar list:
The sidebar with added account for accessing recordings
To remove an account, click the delete icon.
❗️
IMPORTANT
Note that this action is irreversible!
Connecting via S3 Browser
📘
NOTE
Ensure that the public IP address of your remote server or PC is whitelisted in the Access Control List.
Once you've downloaded and installed the S3 browser, go to Accounts > Add New Account at the top left. Fill in the following information:
Display name (alias only): enter your PBX or Dialer name
ensure that you select the Use secure transfer (SSL/TLS) checkbox
Adding an account in S3
Click Add new account.
In the advanced settings of your S3 browser, select the following options:
Signature version: Signature V2 or Signature V4
Addressing model: Path style
👍
TIP
If your recordings bucket contains a large number of files or directories, consider using the Pagination feature. This allows you to divide large bucket listings into manageable pages.
Please refer to the S3 Browser page for information on bucket pagination.
Connecting via AWS CLI V2
Those who prefer command-line tools can use the AWS Command Line Interface (AWS CLI), a unified tool to manage AWS services. It allows you to control multiple AWS services and automate them through scripts.
Run the following commands to connect to your recordings storage via AWS CLI V2:
To begin, open your computer's command line interface (CLI). This can typically be found by searching for "command prompt" or "terminal" in the search bar.
Enter the following command:
$ aws configure --profile "your PBX or Dialer name"
This will create a new profile for your PBX or Dialer in AWS CLI V2.
Next, you will be prompted to enter your AWS Access Key ID (your S3 account token) and Secret Access Key (your S3 account secret). These can be found in your S3 account settings. Enter them when prompted.
You will also be asked for your Default region name and Default output format; feel free to leave these blank for now.
Now that you have configured your new profile, you can use it to connect to your recordings storage. Enter the following command:
$ aws s3 ls s3:// --endpoint-url https://recordings.commpeak.com/ --profile "your PBX or Dialer name"
This will list the bucket name for your recordings storage. Please note that the bucket name will be a long string of numbers and letters, such as
a123465-7891-4234-9c5c-9a1231322ea
To sync your recording files to your local directory, use the following command:
Please replace "your PBX or Dialer name" with the real name and your bucket name with the one you obtained in the previous step.
If you encounter any issues or need more information about AWS CLI V2 commands, you can use the --debug flag in your commands to view a full debug report. You can also refer to the AWS CLI V2 documentation.
Storage Directory Structure
_/{year}/{month}/{day}/{hour}/"audio file with outgoing or incoming call recording.flac"
To access your storage, you must configure access rules for your FTP and S3 accounts.
To set IP ACL:
Go to the IP ACL tab in the Recordings Access Accounts sidebar.
Enter an IP address with a subnet mask for an account.
Click the Add button.
Repeat the steps to add more IPs.
ACL rule settings for accessing the recordings' storage
If the CommPeak system blocks your FTP username for violating the maximum concurrent connections, you can unblock it in Current Blocks.
Access Log
You can view a summary for the selected date range or download a log file with more detailed information.
To view access details:
Go to the Access Summary tab in the Recordings Access Accounts sidebar.
Viewing the access summary
Select a date range in the interactive calendar or use presets.
Click Search.
You will see how many files were opened or deleted and the amount of uploaded and downloaded data during the selected period.
Click the download icon to save a .csv file with the access log. The log contains more details, such as IP address, exact time, action, downloaded file path, and errors, if any.
