Recordings Addon

From Kolmisoft Wiki

Jump to: navigation, search

Contents

[edit] Description

Recordings functionality can be used to record selected users' calls for Monitoring purpose.

[edit] Functionality

Recording Addon provides this functionality:

  • Record User Calls.
  • Send a Recording to email.
  • Limit space Users' space for Recordings.
  • Record Calls without User knowledge.
  • Let Users manage their Recordings (send to email/listen/download/delete).
  • Convert recordings from WAV to MP3 format and store them on an external server, to ease the load on the main server.

NOTE: Resellers is able to have the same functions as an administrator if Allow to use recording functionality option is checked by Admin in resellers settings. In order for the calls to be recorded for resellers users the "Record calls for this Device:" option (located in the device edit window, "Recordings" block) has to be enabled by the reseller for the devices for which the calls should be recorded.

[edit] Limitations

  • Recordings will not be saved on the server if there will be left less then 10% of free space. Such recordings will be sent directly to the Email (if email is specified in GUI Interface) and will be completely removed from the server.
  • Currently it is not possible to record Calls that are made between local extensions, but it is possible to record calls if a local device has a DID assigned to it and the call is made dialing the DID number, so the call would go like this: local extension > DID > local extension.
  • Calling Cards calls cannot be recorded.



[edit] Sound file format

Recordings are saved into mp3 format. 1mb can save around 4min of recordings.

[edit] Configuration

In order to use Recording, you have to set up which Users' Calls you want to record.

Go to ADDONS –> Recordings –> Users and you will see this window:

Image:recordings1.png

Here you can check the Forced record calls for this User field for the Users you want to record. By checking Allow to use recording functionality option you can authorize the User to use the Recordings Addon functionality. Click Update at the bottom for the changes to take effect. To allow particular Reseller to use Recordings functionality, "Allow to use recording functionality" option must be checked in his details.

If you leave Server space (Mb) 0 - there will be no limitations in data usage (HDD will fill up after some time).

NOTE Recordings are NOT available in Calls between 2 SIP Devices in MOR.

SETTINGS –> Users –> Edit (on selected user)

The Recordings section has the following options:

  • Allow to use recording functionality - can this user use the Recording addon functionality?
  • Forced record calls for this User - record calls for this user (all devices) without user knowledge. This option has the highest priority.

when enabled - records for all User devices will be recorded regardless of other options (value in Device settings: Record calls for this Device: - will be ignored, Server space - dedicated for User will be ignored ant etc )

  • Server space - how much HDD space to reserve for recordings of this user. Takes effect only if Admin has not enabled recordings for User himself. Such options should be set on appropriate User/Device by Admin in order to enable this function for User:

User settings

   Forced record calls for this User: NO

Device settings:

   Record calls for this Device : NO
   Keep Recordings on Server after sent to Email: NO
  • Send deleted recordings to this email. If HDD space is exceeded, the new recordings will not be saved and will be sent to this email instead. If this email is empty, the recording will be sent to the default user email. Recordings will be kept in server if email sending fails.



Device –> Edit window

The following options are available for Device:

  • Record calls for this Device - record calls for this Device (without user knowledge). If this option is enabled, recordings must be deleted manually. If this option is set to YES, then server space - dedicated for User will be ignored and records will be placed on server regardless of this value
  • Show Recordings to the User for this Device - allows User to see such recordings
  • Send Recording to Email - when recording is completed, send to it email. Recordings will be kept in server if email sending fails.
  • Recordings Email - send to this email address.
  • Keep Recordings on Server after sent to Email - should the recording be left on the server after being sent to email? If this option is set to YES, then server space - dedicated for User will be ignored and records will be placed on server regardless of this value



File:device_recordings_settings.png

[edit] Setup User so he could see his recorded Calls

1. As admin, go to User Edit settings Image:icon_edit.png and check Allow to use recording functionality. User will be able to use Recording addon functionality.

2. Log in as this User and in PERSONAL MENU –> Details –> Devices, click Image:icon_edit.png for Device and in the Recordings section check Record calls for this Device: YES.

3. Now the user will be able to see his calls in PERSONAL MENU –> Call –> Recordings.

[edit] User settings

The Administrator must authorize the User to use the Recording Addon functionality before User can use its functions. This can be done by checking Allow to use recording functionality in the User Edit window.

PERSONAL MENU –> Details

  • Server space - shows used/reserved HDD space for recordings.
  • Email for deleted Recordings - to which email recordings should be sent if there is not enough space for them.



PERSONAL MENU –> Details –> Devices –> Edit

  • Record calls for this Device - user can set to record calls for this device or not.
  • Send Recording to Email - should recording be sent to email? Recordings will be kept in server if email sending fails.
  • Recordings Email - the email address email to which recordings should be sent.
  • Keep Recordings on Server after sent to Email - should recordings be left on the server after being sent to email?



PERSONAL MENU –> Calls –> Recordings

On this page, the User can manage his recordings.

User Owner can decide:

  • Whether or not the user can use Recording Addon functionality (set to record calls, send recordings to email, etc).
  • Which user calls should always be recorded (without User knowledge).



[edit] Record not answered calls

In order to enable this functionality few changes a needed:

1) Edit /etc/asterisk/mor.conf

vi /etc/asterisk/mor.conf

and set record_not_answered_calls = 1

This option record_not_answered_calls - save audio to the file while the channel is not answered (not bridged), default 0 (by default records only answered calls).

2) Option Show Recordings with zero billsec should be enabled in GUI.

To enable it go to SETTINGS –> Setup –> Visual and check option Show recordings with zero billsec.


Image:recordingams.png

Now system records not answered calls for all users which are using recording functionality.

Recordings are located in ADDONS –> Recordings.

In recording list you will be able to see recordings without duration.

Such calls were not answered but recorded.

Image:recordingams2.png

[edit] Delete recordings after sending it via e-mail

1. As admin, go to User Edit settings Image:icon_edit.png and check Allow to use recording functionality. User will be able to use Recording addon functionality. Do not check Forced record calls for this User because it this way recordings will NOT be deleted.

2. Log in as this User and in PERSONAL MENU –> Personal Details –> Devices, click Image:icon_edit.png for Device and in the Recordings section check Keep Recordings on Server after sent to Email: NO.

3. Now recordings will be deleted immediately after they will be sent via e-mail.

[edit] Recordings on external server

Manage settings for recordings upload to external server go to ADDONS –> Recordings –> Settings

File:recordings_settings_path.png

you will reach settings page

File:recordings_addon_settings.png

  • Use external Server - should system send recordings to External Recordings Server?
  • Recordings server - details such as IP/Port/Login where port is SSH default port 22 and Login is default root.
  • By default recording files in remote server will be placed at /tmp directory

P.S. SSH keys must be configured without password in order scp command could transfer the recordings to other server. If this functionality is not enabled - the recordings are stored in local server

[edit] Recordings on additional HDD

If you want to save recordings on additional HDD, please follow this instrucction Recordings on additional HDD.

[edit] Usage

To view/listen/download/delete recorded Calls go to ADDONS –> Recordings. You will see something like this:

Image:recordings2.png

If a Call was made from Device to DID that is connected with another Device, you will see such information:

Image:RecordingsExt.png

Here Admin/Reseller can see all recordings, search Recordings by:

  • Period.
  • Source (CallerID).
  • Destination (Dialed number).
  • User.
  • Device.

With each recording, it is possible to:

  • Check its details.
  • Check Call details.
  • Add comment to it (note that User and Admin have different comment fields)
  • Listen to it.
  • Download it.
  • Delete it.


NOTE: It is available to use recordings 15 minutes after call was made. Till then you may see the message Recording was not found locally. When listening to a recording its row will turn green as an indicator that the recording was listened.

Image:Recordig_listened_indicator.png

[edit] Recordings bulk management

This feature allows an administrator to quickly delete Recordings for selected period or selected Device

[edit] Who can use this functionality?

  • This feature is only available for MOR administrator



[edit] How to use this functionality

To delete by device:
Go to ADDONS –> Recordings

File:Recordings_menu_path.png

Click on image:icon_edit.png Bulk management link.

File:Recordings_bulk_management.png

Here you can check an option to delete by device, select device and click Delete.

File:Recordings_bulk_management_confirm.png

Confirm that you really want to delete recordings of selected device.

To delete by date:
Go to ADDONS –> Recordings

File:Recordings_menu_path.png

Click on image:icon_edit.png Bulk management link.

File:Date bulkmanagement.png

Here you can check an option to delete by date, select date and click Delete.

File:Date recorddelete.png

Confirm that you really want to delete recordings of selected period.

[edit] Recordings Quality Test

This feature allows to record Calls for specified Destination Group with desired quantity and send Recordings' links via e-mail.

[edit] Who can use this functionality?

  • This feature is only available for MOR administrator and accountant (Manage Recordings Permission)


[edit] How to use this functionality

To setup new Quality Test:
Go to ADDONS –> Recordings –> Quality Test

File:Recordings_quality_test_menu_path.png

File:Recordings_quality_test_list.png

Set desired E-mail address, Destination Group, Calls Quantity and click on image:icon_add.png icon.

File:Recordings_quality_test_list_input.png

After Quality Test is created, MOR will collect Recordings with required Destination Group. Once Recordings quantity is met, shortly after links with Recordings will be sent to Email.

File:Recordings_quality_test_list_input_success.png

Once email is sent, corresponding Quality Test row will not be shown in list.

[edit] See also

Personal tools

Try MOR

Try M2