Supervision
Description (v1.3.3)
This action supervise a device.
Name of the resource [Resource]
Supervision mode [Options]
Release notes
Version 1.3.3 - Early deployment
- Bugfix: Be quiet, don't say SIP (M18042)
Version 1.3.2 - Early deployment
- Improvement: can be used to record call on another sop
Version 1.3.1 - Early deployment
- Improvement: corrected field description
Version 1.3 - General deployment
- Improvement: Compatibility with the Communication Server module
Version 1.2 - General deployment
- Bugfix: the SIP/ prefix will now be added correctly for all types of phones
Version 1.1 - General deployment
- Feature: possibility to whisper to the supervised agent
- No longer needed to specify the technology (e.g. SIP)
Version 1.0 - General deployment
Version 0.0 - Deprecated
Supervision
Action parameters
- Resource: name of the device that need to be supervised
- Options:
- Supervise: enable to hear the conversation
- Supervise and whisper: enable to hear the conversation and talk to the supervised person without the other party of the converstation hearing it
Example of use
The steps of a typical supervision callflow are the following:
- Control the access to the service via the CheckPinCode action.
- Use GetDigits action to save the extension you want to supervise in a parameter. Choose an appropriate name for this parameter, for example "ExtensionToSupervise".
- You can then use GetExtensionInfo to get the phone associated with this extension, for example ExtPrimaryPhone.
- Finally the Supervision action can be used to supervise the right phone
Dependencies
- Module Asterisk-1.2 v2.23+ (support of the whisper mode)
Important notes
To be able to supervise a phone, this one should not work in re-invite mode for which the voice is directly sent from one phone to another.
Prior to version 1.1, resource name had to be prefixed by the technology name, for example SIP/${ExtPrimaryPhone}}. This is not mandatory any more.
Be aware that listening to calls may be subject to freedom of information and privacy legislation in your jurisdiction. As a matter of professional practice you should know the terms under which it is lawful to eavesdrop on telephone calls. In most jurisdictions it is illegal to eavesdrop on a call without the knowledge of the participants.