Voice File Tagging

Estimated reading time: 8 minutes | Target users: Supervisors

Voice file tagging is a powerful function that allows agents to mark specific parts of a conversation during a phone call. You can then download the marked parts of the call recording separately using the archiver.label software.

Read more about the archiver software in the VCC Live Archiver tutorial.

In this lesson, you will learn:

• How to implement voice file tags into a datasheet or script

Recommended knowledge:

• Basic knowledge of agent script management
• Basic knowledge of archiver.label

1. Adding Voice File Tag Buttons to a Datasheet or Script

You need to add two button controls (one for adding a start tag, and one for adding an end tag) to an existing datasheet or script. These buttons will be used by agents to mark the beginning and end of voice file extracts.

Let’s start by opening a datasheet or script for editing.

1. Log in to productname.label as an admin user.
2. Select a project from the project list, then select script_editor.menu.label > tabs.menu.label or script.tab.label.
3. Press to expand the list, then select a datasheet or script for editing.

   We’ll add a button control and edit its code, so that an agent can use it to add a start tag during the conversation. The start tag indicates the beginning of a voice file extract.

4. Drag and drop a controllerType.c-button.label control from the toolbar to the required location.
   
5. Select the button control you just added to view the control’s properties located on the right.
6. Enter “Add start tag” in the buttonLabel.label text field. This will be the button’s label.
7. Enter “start_tag_button” in the name.label.value text field. This will be the button’s identifier.
8. Press the launchCode.button.label button. A text editor software will open. This is where you add the function code to the button. Insert the following code:

   $('page_name','start_tag_button').afterSetData = function() {
    vcc.addVoicefileTag('start_tag',-1, true);
   };
   

9. Save changes, then close the text editor software.

   Let’s add another button control, but this time to add an end tag. The end tag indicates the end of a voice file extract.

10. Drag and drop a Button control from the toolbar to the required location.
11. Select the button control you just added to see the control’s properties located on the right.
12. Enter “Add end tag” in the Label text field. This will be the button’s label.
13. Enter “end_tag_button” in the Indetifier for code editor text field. This will be the button’s identifier.
14. Press the Edit code button. A text editor software will open. This is where you add the function code to the button. Insert the following code:

    $('page_name','end_tag_button').afterSetData = function() {
    vcc.addVoicefileTag('end_tag',0, true);
    };
    

15. Save changes, then close the text editor software.
16. Press upload.button.label to save and activate your datasheet or script.

2. Modifying Voice File Name Settings for Tagged Voice Files

You need to add a {part} parameter to your voice file name setting. Otherwise, the archiver won’t download the tagged voice file extracts.

1. Log in to productname.label as an admin user.
2. From the productname.label menu, select call_center.menu.label > settings.menu.label, then select the project.tab.label tab.
3. Insert {part}/ at the beginning of the default_filename.label.value text field.
   
4. Press field_change.button.label.

Tip: Read about voice file name settings in the Downloading and Listening to Call Recordings section.

3. Downloading Voice File Extracts Using VCC Live Archiver

You need to use the “–parts” switch when executing the archiver to download tagged voice files.

Note: If you don’t use this switch, voice file extracts won’t be downloaded. Only complete voice files will be downloaded to the “Complete” folder.

1. Use archiver.label to download voice file extracts. See Using VCC Live Archiver.
2. To let the application know that you want to download only the tagged voice file extracts, you need to use the –parts switch. Read more about switches in the Using Switches section.

For example, to download voice file extracts, from between the “start_tag” and “end_tag” tags to the “VoiceFileExtracts” folder:

vccla-windows-386.exe --download --parts VoiceFileExtracts:start_tag-end_tag

Congratulations!

You’ve just learned how to use voice file tagging in productname.label.