Quick Search
Browse
Pages
Blog
Labels
Attachments
Mail
Advanced
What’s New
Space Directory
Feed Builder
Keyboard Shortcuts
Confluence Gadgets
Log In
Dashboard
TIM Plus
Copy Page
You are not logged in. Any changes you make will be marked as
anonymous
. You may want to
Log In
if you already have an account. You can also
Sign Up
for a new account.
This page is being edited by
.
Paragraph
Paragraph
Heading 1
Heading 2
Heading 3
Heading 4
Heading 5
Heading 6
Preformatted
Quote
Bold
Italic
Underline
More colours
Strikethrough
Subscript
Superscript
Monospace
Clear Formatting
Bullet list
Numbered list
Outdent
Indent
Align left
Align center
Align right
Link
Table
Insert
Insert Content
Image
Link
Attachment
Symbol
Emoticon
Wiki Markup
Horizontal rule
tinymce.confluence.insert_menu.macro_desc
Info
JIRA Issue
Status
Gallery
Tasklist
Table of Contents
Other Macros
Undo
Redo
Find/Replace
Keyboard Shortcuts Help
<p>Throughout this guide, we will adopt the <img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e3JlZmVyZW5jZW1hY3JvOkxhYmVsPVBDSS1EU1N9&locale=en_GB&version=2" data-macro-name="referencemacro" data-macro-parameters="Label=PCI-DSS"> example above, where telephone calls that contain spoken credit card information need to be masked out by an audible tone, but only during those parts of the call when the card details are being spoken, leaving intact the rest of the call audio.</p><p>In this scenario, we will assume that agents (employees that make or receive telephone calls) utilise an in-house or third-party data entry system into which credit card detailed are entered using a computer.</p><h4>How it works</h4><p class="reference">Considering TIM Plus (in conjunction with one or more Magic boxes) records the call audio at strategic boundaries in your telecom infrastructure - usually your organisation's telephone lines, rather than each user's telephone handset - some reconciliation is normally required between those boundaries and the actual agent that handled the call.</p><p>By default, this reconciliation occurs automatically in TIM Plus, which is how the agent-centric calls that you see in call reports are able to be associated (matched) with each call, as seen from the point of view of a telephone line which delivers calls to many agents.</p><p>During obfuscation, it is necessary that a user or device sends at least two signals to TIM Plus. Together, these two signals allow TIM Plus to mask out the audio between the two points in time that each signal was received.</p><p><img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e3NjcmVlbnNob3RtYWNybzpCb3JkZXI9ZmFsc2V8VVJMPS9kb3dubG9hZC9hdHRhY2htZW50cy8xNjcxMzAwL29iZnVzY2F0aW9uLnBuZ30&locale=en_GB&version=2" data-macro-name="screenshotmacro" data-macro-parameters="Border=false|URL=/download/attachments/1671300/obfuscation.png"></p><p>At the point in time during an agent's call when obfuscation is necessary - e.g. <em>"Can I have your CVV number please?"</em> is spoken by the agent - a signal is sent by the agent to TIM Plus, which records the event along with the exact time it was sent. Similarly, when the sensitive part of the call has completed, a further signal is sent by the agent to TIM Plus, which is also being recorded.</p><p>A single telephone call can contain more than one obfuscation and the number of signals required is always twice the amount of obfuscations in a call.</p><h4>Assumptions</h4><p>This guide assumes the following statements are true:</p><ul><li>You have a licensed copy of TIM Plus that includes voice recording</li><li>Your installation is at least version 3.0.0.55<span class="reference"><br /></span></li></ul><h4>Common solutions</h4><p>Taking the example of masking out some digits of a phone call when a credit card number is being quoted, most solution providers modify the data entry system that an agent uses.</p><h2>Implementation</h2><h4>HTTP request</h4><p>To send a start or stop signal, a simple <img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e3JlZmVyZW5jZW1hY3JvOkxhYmVsPUhUVFAgR0VUfQ&locale=en_GB&version=2" data-macro-name="referencemacro" data-macro-parameters="Label=HTTP GET"> request must be sent to the TIM Plus web server.</p><p>Every request to the web server requires authentication, therefore you need to ensure that the relevant HTTP authentication headers are sent with your request and that the username and password combination match an existing web user object in the Directory.</p><p>The response status code will indicate success or failure.</p><h4>Request format</h4><p>The request should be a <img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e3JlZmVyZW5jZW1hY3JvOkxhYmVsPUdFVH0&locale=en_GB&version=2" data-macro-name="referencemacro" data-macro-parameters="Label=GET"> request and take the following URL- encoded parameters, as per the following example:</p><table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&locale=en_GB&version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>http://192.168.0.1/signal.js?cmd=set&cat=4&type=1&objtype....</pre></td></tr></table><p>Valid parameters are described in the table below:</p><table class="confluenceTable"><tbody><tr><th class="confluenceTh">Parameter</th><th class="confluenceTh">Description</th></tr><tr><td class="confluenceTd"><span class="keyword">cat</span></td><td class="confluenceTd">Signal category. For audio masking, this value is always <span class="keyword">0x04</span></td></tr><tr><td class="confluenceTd"><span class="keyword">type</span></td><td class="confluenceTd">The type of signal. Valid values for <span class="keyword">0x04-category</span>signals are:<ul class="table"><li><span class="keyword">0x01 Mute On</span></li><li><span class="keyword">0x02 Mute Off</span></li></ul></td></tr><tr><td class="confluenceTd"><span class="keyword">objtype</span></td><td class="confluenceTd">The type of object that this signal relates to. This can be one of two values:<ul class="table"><li><span class="keyword">user</span> (a user object)</li><li><span class="keyword">channel</span> (a channel object)</li></ul></td></tr><tr><td class="confluenceTd"><span class="keyword">objid</span></td><td class="confluenceTd">The unique ID of the object type as specified by the <span class="keyword">objtype</span>parameter (above). This is used to locate the object in the Directory<p>The region of the Directory to search in is specified by the <span class="keyword">key</span> parameter (below) and governed by the access implied by the placement of the web user whose credentials are used to effect the web request</p></td></tr><tr><td class="confluenceTd"><span class="keyword">key</span></td><td class="confluenceTd">Specifies the key relating to a container object in the directory (or blank, implying the whole directory) whereby a search on the object specified by <span class="keyword">objtype</span> and <span class="keyword">objid</span> is performed below</td></tr></tbody></table><p>Return values are specified as <img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e3JlZmVyZW5jZW1hY3JvOkxhYmVsPUhUVFB9&locale=en_GB&version=2" data-macro-name="referencemacro" data-macro-parameters="Label=HTTP"> response status code. Although the body of some responses may contain informational text, you should not rely on this text to make any decisions as to whether the request was successful or not.</p><p>Valid status codes are as follows:</p><table class="confluenceTable"><tbody><tr><th class="confluenceTh">Parameter</th><th class="confluenceTh">Description</th></tr><tr><td class="confluenceTd"><span class="keyword">200</span></td><td class="confluenceTd">The signal was received and stored successfully</td></tr><tr><td class="confluenceTd"><span class="keyword">400</span></td><td class="confluenceTd">The request was not acceptable for one of the following reasons:<ul class="table"><li>An invalid <span class="keyword">type</span> parameter was specified. The <span class="keyword">type</span> parameter is specific to the category specified by the <span class="keyword">cat</span> parameter. Further, the <span class="keyword">type</span> value (e.g. 0x01) can be used in multiple categories</li><li>The <span class="keyword">objid</span> was missing. Specify the ID of the object you want the signal to relate to</li><li>The <span class="keyword">cat</span> and <span class="keyword">type</span> parameters - category and signal type, respectively - must be specified and cannot be zero</li><li>The version of TIM Plus you are running does not understand the <span class="keyword">signal.js</span> script</li></ul></td></tr><tr><td class="confluenceTd"><span class="keyword">404</span></td><td class="confluenceTd">The object specified by the combination of the <span class="keyword">objtype</span> and <span class="keyword">objid</span> parameters - and optionally the <span class="keyword">key</span> parameter - could not be found</td></tr><tr><td class="confluenceTd"><span class="keyword">500</span></td><td class="confluenceTd"><img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e3JlZmVyZW5jZW1hY3JvOkxhYmVsPUludGVybmFsIFNlcnZlciBFcnJvcn0&locale=en_GB&version=2" data-macro-name="referencemacro" data-macro-parameters="Label=Internal Server Error"> prevented the signal from being stored successfully. This may be due to a badly-configured database, or the lack of a <img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e3JlZmVyZW5jZW1hY3JvOkxhYmVsPXNpZ25hbHN9&locale=en_GB&version=2" data-macro-name="referencemacro" data-macro-parameters="Label=signals"> table in the TIM Plus database</td></tr></tbody></table>
Attachments
Labels
Location
< Edit
Preview >
Loading…
Save
Cancel
Next hint
search
attachments
weblink
advanced