This page describes how to configure the recording feature.
To configure recording there are two steps to follow on XiVO PBX:
- Add link towards Recording Server,
- and then enable recording, which can be done either:
- in the Queue configuration
- or via subroutines
2. Enable recording¶
Enable recording in the Queue configuration¶
Steps to be done on XiVO PBX
To enable recording on a queue, go toand edit the queue.
Then, in the recording section:
- Recording mode set it to Recorded or Recorded on demand
- Recorded: call will be recorded
- Recorded on demand: recording starts in paused state and can be activated by the agent (see agent recording configuration)
- Activate check it for the recording mode to be active
- You need to check the Activate parameter for the recording to be enabled. When Activate is checked, the recording will be enabled according to the mode selected.
Enable recording via subroutines¶
Steps to be done on XiVO PBX
To enable the recording you have to configure one of the shipped subroutines.
xivocc-recording (see recording installation section) ships the following dialplan subroutines :
||Records incoming calls|
||Records incoming calls, but record starts in paused state and can be activated by the agent (see agent recording configuration)|
||Records outgoing calls|
||Records outgoing calls, but record starts in paused state and can be activated by the agent (see agent recording configuration)|
These subroutines are to be configured on the following XiVO PBX objects (either globally or per-object):
They MUST be configured only on the following objects. Other configuration are not supported.
- and/or Users,
- and/or Outcall
Here is an example if you want to enable recording for:
- All outbound calls but started in pause state,
- And only on incoming call 0123456789
Then you would have to:
custom_global_subr.conffile in the
If not already defined elsewhere define the global subroutine:
[xivo-subrgbl-outcall] exten = s,1,NoOp(=== Recording outbound calls in pause ===) same = n,Gosub(xivocc-outcall-recording-paused,s,1) same = n,Return()
Enable the call recording for incall 0123456789 by editing it via the XiVO PBX web interface and set the fieldto
Stop recording upon external transfer¶
By default recording is stopped when both parties of the call are external.
This can be deactivated by adding
STOP_RECORDING_UPON_EXTERNAL_XFER environment variable to the xuc section of your
xuc: image: ... environment: - ... - SECURED_KRB5_PRINCIPAL - STOP_RECORDING_UPON_EXTERNAL_XFER
STOP_RECORDING_UPON_EXTERNAL_XFER=false value to your
XIVO_HOST=192.168.1.1 XUC_HOST=192.168.1.2 XUC_PORT=8090 ... STOP_RECORDING_UPON_EXTERNAL_XFER=false
and then relaunch the xivocc services with
xivocc-dcomp up -d command.
Recording filtering configuration¶
Steps to be done on XiVO CC
After having followed above paragraphs, you can also configure the recording filtering.
- Add a user with Administrateur rights for Recording Server:
- Connect to the Config Management interface : http://<XIVO_CC_IP>:9100 (login avencall/superpass),
- Add one of the XiVO PBX user giving him Administrateur rights,
- Configure excluded numbers on Recording Server
- Then, connect with this user to the Recording Server interface : http://<XIVO_CC_IP>:9400
- Navigate to the page
Contrôle d'enregistrementand add the numbers to be excluded from the recording.
In listdeclare the:
- XiVO Incalls numbers,
- XiVO Queues numbers,
- or XiVO Users numbers
to be excluded from the recording on incoming or internal call. These numbers will be checked by the
numbers must be entered as they first appear in dialplan (check is made against XIVO_DSTNUM dialplan variable).
In listdeclare the:
- XiVO Users internal numbers
to be excluded from recording on outgoing calls. These numbers will be checked by the
check is made against XIVO_SRCNUM dialplan variable.
Recording on gateway¶
Recording can be enabled on a gateway instead of the XiVO PBX where the users, queues and other objects are configured. This architecture will allow to off-load the recording process to a gateway server. To configure recording on a gateway, you need to follow the process to enable recording via subroutines (see Enable recording via subroutines).
In order to allow agents to control the recording of their current call, you need to perform the following steps:
- Copy the following file /etc/asterisk/manager.d/02-xivocc.conf from the XiVO PBX to the same folder on the gateway.
- On your XiVO gateway, configure your operators’ trunks and the trunk to your XiVO .
- On your XiVO PBX, configure the gateway as a media server in Configuration/Media servers
- On your XiVO PBX, configure your operators’ trunks of your gateway and assign it to the media server configured for your XiVO gateway .
- Disable the feature to stop recording upon external transfer (see Stop recording upon external transfer, STOP_RECORDING_UPON_EXTERNAL_XFER=false)
- Configure recording as per Enable recording via subroutines
|||(1, 2) Please note that you need to do this configuration both on the XiVO PBX and on your gateway as no synchronization mechanism exists at the moment.|