Reference13r3:Concept App Service Recordings: Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
(New page: Apps == Description == Recordings is an application running on the App platform which allows capturing the audio streams during a telephone call. The user's phone can...)
 
mNo edit summary
Line 156: Line 156:
*Check URL for PCAP Recording provided on the IP-Phone or VoIP-Interface of a VoIP Gateway
*Check URL for PCAP Recording provided on the IP-Phone or VoIP-Interface of a VoIP Gateway
*A Trace with enabled HTTP-Client option should show a successful HTTP PUT Request towards URL of the Recordings Service PCAP interface (e.g. <code>HTTPCLIENT WEBDAV_FILE_HTTP.2: PUT http://ap.company.com/company.com/recordings/Files/f9e5956e47d460010630009033302ab1-009033302ab1-11--username.pcap</code>)
*A Trace with enabled HTTP-Client option should show a successful HTTP PUT Request towards URL of the Recordings Service PCAP interface (e.g. <code>HTTPCLIENT WEBDAV_FILE_HTTP.2: PUT http://ap.company.com/company.com/recordings/Files/f9e5956e47d460010630009033302ab1-009033302ab1-11--username.pcap</code>)
== Related Articles ==
[http://wiki-intern.innovaphone.com/index.php?title=HowTo_Recordings_V13r3 Howto:V13r3 Recordings App configuration]


== Known Problems ==
== Known Problems ==
=== Test Mode ===
=== Test Mode ===
The App Licenses are not supported in the [[Reference12r1:General/License|Test Mode]] at the moment, instead a [https://wiki.innovaphone.com/index.php?title=Reference:My_Innovaphone#Download_test_licenses Test License] should be used.
The App Licenses are not supported in the [[Reference12r1:General/License|Test Mode]] at the moment, instead a [https://wiki.innovaphone.com/index.php?title=Reference:My_Innovaphone#Download_test_licenses Test License] should be used.
== Related Articles ==
[[HowTo_Recordings_V13r3]]

Revision as of 11:45, 9 November 2022


Description

Recordings is an application running on the App platform which allows capturing the audio streams during a telephone call. The user's phone can be configured to send bidirectional audio streams to the Recordings App and store them into the database.

Requirements

  • innovaphone PBX
  • innovaphone Application Platform
  • Firmware V13r3xx
  • Recordings App
  • Recordings App licenses (per User)
  • Device with PCAP Recording Interface:
    • innovaphone deskphones
    • innovaphone SoftphoneApp
    • innovaphone gateway interfaces
  • Reporting App

Apps

recordings

Usrrecord.png

User version of the App allow you to:

  • Access to the user specific records
  • Access to the user specific logs
  • Filter records by name, by date
  • Play, Listen or Download the recording as a .WAV file
  • Protect against deleting or delete a recording

recordingsadmin

Adminrecord.png

Admin version of the app allow you to:

  • Access to all records
  • Access to all logs
  • Set up the records auto deletion retention time in days
  • Set the PBX name
  • Set specific trace levels
  • Filter records by name, by date
  • Play, Listen or Download the recording as a .wav file
  • Protect against deleting or delete a recording

PBX Manager Plugin

With the Recordings PBX Manager Plugin, an App Object can be created, edited and deleted on the PBX.


Configuration

  • Download the Recordings App via App Store.
  • Install the App on the App Platform Manager.
  • Create an instance for the Recordings App on the App Platform Manager.
  • Create a new PBX recordings APP-Object with the PBX Manager Plugin.
  • Create a new PBX recordingsadmin APP-Object with the PBX Manager Plugin.
  • Assign recordingsadmin App to authorized (admin) users, which will be allowed to open the Admin UI of the Recordings App.
  • Assign recordings App to users who will use the Recordings App.
  • Start recordingsadmin App and configure the name of the PBX in the settings via upright option
  • assign Record to (URL) to recording devices/objects in format
http://ap.domain.tld/domain.tld/recordings/Files
at deskphones or gateway interfaces.
At innovaphone deskphones, enable recording via Phone/User-X/Recording by setting Mode to transparent and Recorder to HTTP Server.

Access List

Unlike Recordings Admin App, which lists recordings of all users, Recordings App for users limits the listing of recordings to those made by the using user himself.

A possibility to extend the listing of the recordings to other extensions/users is provided by the Access List. In the Access List, additional extension can be defined, which will be listed to the Users of the App. This way the Recordings App Service can be accessed via different App Objects, with different Access Lists.

This way scenarios, like sharing recordings between team members or supervisor access to recordings of call agents are possible.
For the configuration, see : Howto:V13r2 Recordings App configuration#Access_list_configuration_through_the_Recordings_Plugin

Deletion of recordings

In the PBX Manager plugin, it can be configured how a deletion of a recording is processed. There are 2 modes selectable: "Recoverable" and "Permanent". If "Recoverable" is selected, the users attached to this app object will transfer a recording to the recycle bin upon a delete operation, otherwise the recordings will be permanently deleted.


Scheduled deletion of old recordings

You can configure a time period between 1 and 11000 days (in maximum round about 30 years), after which recordings are automatically removed. You can enter 0 days here to disable the scheduled deletion.

Call Information

A new method of acquiring the call information is implemented. It requires an installed and running App Service "Reports". "Reports" does not need own licenses to be run with recordings. With this new method, it is possible to provide detailed call flow information for each recording. Furthermore, the previously used CDR slot on the PBX for recordings is not needed anymore.


Licensing

An appropriate license App(innovaphone-recorder) must be installed on the PBX to enable Recordings App functionality for specified users.

The Recorder App License can be assigned directly to a specific User Object or via a Config Template.

The recordings for users without an assigned Recorder App License will be unrecoverable deleted if the Recordings App is restarted.

Recording on Special Interfaces

  • Trunk Interface/Gateway

The Trunk Interface acts as a substitute for the user's phone. For outgoing calls the call initiator is the owner of the recording and for him a license is required. With incoming calls, the first user answering the call owns the recording and a license for this user is required.

  • Waiting Queue

The user answering the call is the owner, a license for this user is required.

Upgrade from V13r2 to V13r3 Recordings App

Compatibility

A V13r3 Recordings App can not be used in the V13r2 PBX and App Platform environment.

License Changes

Licensing is the same as version 13r2

Database Conversion

Databases from previous versions (13r1,13r2) will be converted automatically

Removing CDR slot on PBX

The CDR slot that was used by previous installations of recordings can be freed.

Update App Object configuration

If upgrading from a previous version, the app object configuration in the PBX Manager must be invoked. Each app object configuration must be selected and "Ok"-ed for the new interoperation with App Service "Reports" to be set up. In detail these are: the websocket connection, the "reporting" app usage and the usage of the "Admin" and "Services" API.

Download recording

Once a recording is converted to .wav format, it can be downloaded. In version 13r3, this is done in a zip archive containing the wave audio file and a .csv file containing the call information.

Troubleshooting

Recordings App Service

The App Service for Recordings App provides a log output on the App instance, after the Diagnostics option "App" is activated for the selected instance.

Additional Trace Level Options for the App Service are configurable via Recordings Admin App. These settings are available via an additional Menu in the upper right corner of the Recordings Admin UI:

  • Recording - PCAP interface related traces, useful on issues with IP-Phone and Interface Media transmission from Endpoint to the App Service
  • Call Information - traces related to the CDR information
  • Converting - traces for conversion process from VoIP codecs to WAV
  • License - traces for on licensing issues
  • UI - traces related to the user interface of the Recordings App

The name of the Master PBX must be configured via the Recordings Admin App, otherwise a message PBX Name missing will be displayed.

PBX Configuration

  • WebSocket connection from App Object to the Recordings App should show connected
  • A correct configuration of the CDR interface is required for transmission of metadata to the App Service "Reports". In case the connection between recordings and App Service "Reports" is not successful, a red "broken link" is shown on top of the recordingsadmin and an entry in the event log will be added.

PCAP Recording Interfaces

Known Problems

Test Mode

The App Licenses are not supported in the Test Mode at the moment, instead a Test License should be used.

Related Articles

HowTo_Recordings_V13r3