Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The system permits manual obfuscation of calls using a DTMF key sequence at the user's handset. When a user enters a specified sequence of digits, the obfuscation begins, and any audio will be immediately and irreversibly overwritten with the tone specified in the

Referencemacro
Label /audio/obfuscation/tones/
section of the
Keywordmacro
Labelsettings.xml
file. To stop obfuscation, the 
Referencemacro
Labelstop
key sequence must be entered, whereupon the audio will be written normally to the call's stream.

 The

Referencemacro
Labelstart
and 
Referencemacro
Labelstop
 key sequences can be defined in the 
Keywordmacro
Labelsettings.xml
file located in 
Referencemacro
Label{app}\ProgramData\Tri-Line\Echo
, using the
Keywordmacro
LabeldtmfStart
and
Keywordmacro
LabeldtmfStop
attributes elements. The following 
Keywordmacro
Labelsettings.xml
snippet is an example of a configuration to enable manual call obfuscation when a user enters
Keywordmacro
Label**

Code Block
languagehtml/xml
<audio>
    <obfuscation>
        <dtmfStart>**</dtmfStart>
        <dtmfStop>##</dtmfStop>
        <dtmfTimeout>2000</dtmfTimeout>
        <stopTimeout>5000<<stopTimeout>50000</stopTimeout> 
        <toneFile>
            <default>{app}/tones/alaw.wav</default>
            <codec id="0">{app}/tones/ulaw.wav</codec>
            <codec id="8">{app}/tones/alaw.wav</codec>
        </toneFile>
    </obfuscation>
</audio>

The 

Keywordmacro
LabeldtmfTimeout
attribute element was provided to prevent a situation where extra digits have been erroneously entered, and therefore making it impossible to enter the correct sequence. After the specified DTMF timeout has passed, all the digits previously entered will be cleared. This also ensures that obfuscation does not occur during normal negotiation of DTMF telephone selection menus (inbound or outbound). To set a DTMF entry timeout, specify the value (in milliseconds) using the
Keywordmacro
LabeldtmfTimeout
element.

Additionally, an obfuscation timeout can be specified to automatically stop the obfuscation after a specified period of time, to prevent the entire remaining call from being obfuscated in case the user forgets to manually stop the obfuscation. This timeout period can be specified (in milliseconds) using the

Keywordmacro
LabelstopTimeout
element.

Info

For the changes to take effect, access the Windows Services and restart the Echo service.

Custom tones

Custom tones can be added to the call recorder in order to obfuscate part of a call recording. Since the tones are raw byte data that replace portions of the original WAV audio, they must respect the codec of the original file, e.g. a-law, u-law, etc., and use the same sample size and rate, e.g. 16-bit, 8 KHz.

Once the files have been encoded accordingly, they should be copied to the following location:

Referencemacro
Label{app}\ProgramData\Tri-Line\Echo\tones
.

To enable the system to use these custom tones during the obfuscation, open the

Keywordmacro
Labelsettings.xml
file, located in
Referencemacro
Label{app}\PrgramData\Tri-Line\Echo
and add the following snippet, specifying the filename of the custom tone using the 
Keywordmacro
Labelcodec
element. The
Keywordmacro
Labelid
attribute determines the codec type, e.g. "0" = u-law, "8" = a-law, as per RFC3551 (page 32). A 
Keywordmacro
Labeldefault
element can also be added as the fall-back tone to use.

Code Block
languagehtml/xml
<audio>
    <obfuscation>
        <toneFile>
            <default>{app}/tones/alaw.wav</default>
            <codec id="0">{app}/tones/ulaw.wav</codec>
            <codec id="8">{app}/tones/alaw.wav</codec>
        </toneFile>
    </obfuscation>
</audio>    
Info

A <default> element can be added as the fall-back tone to use.