HowTo: Setup Call Recording

Introduction

This HowTo describes how to configure the Escaux UCS to record selected calls.

How to implement ?

The following configuration steps will be covered:
  • Incoming call recording: How to configure the callflow in order to selectively record the incoming calls of your users through the action RecordCall
  • Outgoing call recording: How to configure an outgoing callflow in order to selectively record the outgoing calls of your users through a specific access code.
  • Call archiving: How to archive all the calls and retrieve them for further analysis.
  • On-demand call recording via the SOP API.

We will describe here how to configure the Escaux UCS in order to record all incoming calls to an extension belonging to the same group (e.g. 1) and all outgoing calls which are called with a specific feature code '*1'.

Incoming call recording

In order to record an incoming call, the RecordCall action must be used in the callflow before the device are called.

For example, the following call flow section tests if the current incoming call is in the group 1 by using the parameter LastUserGroup and Record the call with a specific name (name format: [IN-"Date"-"Time"-"Called Extension"-"Caller Number".wav]) . In this example, the rest of the call treatment is simple a redirection to the *001 call flow through the last action Redirect.

RecordIncomingCallflow.jpg

Outgoing call recording

In order to record an outgoing call, the RecordCall action must also be used in an outgoing call flow.

In order to have detailed information on the 'outgoing call flow' mechanism please refer to the following application notes: "Application Note: Call processing on outgoing calls."

In order to record all calls made when dialing <*1> + destination number as normally dialed:

Step 1: Create the feature code routing *1

DONE Navigate to: Call Routing> Define Routes>

Press 'Add' and fill out the following parameters:
  • Telephony Route: _*1X. (your feature code)
  • Route Group: national
  • Action: MapNumber.1.10

Click on 'Save'.

Click on the corresponding link 'MapNumber.1.10' and fill out the following parameters:
  • Description: Record call prefix
  • Number of front digits to strip: All
  • Prefix applied to the number: *218 (or another call flow which implements the recording scenario. see infra)
  • Variable: NumberToDial (The variable which will be used in the recording call flow. see infra)

Step 2: Create the outgoing call flow

Remark: This call flow should already present on your Escaux UCS by default. If it is not the case, please contact ESCAUX. The root extension of this call flow is *218.

If you want to create this call flow by hand:

DONE Navigate to: Callflows> Define Callflow>

Press 'Add' and fill out the following parameters:
  • Root Extension: *218 (or another root extension if you want to implement another method to record the outgoing calls)
  • Description: Record Outgoing calls
  • First Action: RecordCall.1.00

Click on 'Save':

Click on the corresponding link '*218' which has been created:

Click on the 'RecordCall.1.00' action and fill out the filename parameter

Filename:
OUT-${STRFTIME(${EPOCH}%C%y%m%d%I%M)}-${CALLERID(num)}-${NumberToDial:2}
  • More information about STRFTIME can be found by clicking on the following link.

This will record the call to file which has a filename format of the form: [OUT-"Date"-"Time"-"Calling Extension"-"Called Number".wav]

Add a new 'next' output to the RecordCall.1.00 action and select the Redirect.1.00 action. Fill out the following parameters:

number: ${NumberToDial:2}

The resulting call flow should looks like this:

RecordOutgoingCallflow.jpg

Call Recording Archiving

In order to archive call recording a specific module 'Call recording Support' must be installed. Please refer to the Module reference guide for further information.

On-demand call recording via the SOP API

The SOP API request 'ccRecord' enables to start and stop the recording of an on-going call. Please refer to the SOP API Reference Guide for all details.

Copyright © Escaux SA