Creating a connection
You can upload two-channel audio, single-channel audio, or a chat with text messages to a SpeechSense connection. To create a connection, you need either the Admin
or Editor
role for the space.
Note
You cannot delete a connection from a project, but you can delete a project or delete a space.
Creating a connection for two-channel audio
-
Open the SpeechSense home page
. -
Go to the space of your choice.
-
In the top-right corner, click More →
Create connection. -
Specify a name of the connection and, if needed, add a description.
-
Select the Two-channel audio data type.
-
Under Agent, Customer:
-
Specify the channels with the agent's voice and customer's voice. The left channel corresponds to audio track 0, while the right channel corresponds to audio track 1.
-
Specify agent and customer keys from the metadata file. This file contains the call information collected from CRM systems, PBXs, or other sources.
By default, connections include keys with the name and ID of the agent and the customer. In the Name in the system field, enter the name the key will have in SpeechSense. You can also add a description, if required.
To specify additional metadata for the agent and the customer, click Add key. Make sure to enter the new key name and select a metadata type.
-
-
Under Shared metadata, provide the keys from the metadata file that are not related to the agent or the customer.
By default, connections include required keys with the date, direction, and language of the call. In the Name in the system field, enter the name the key will have in SpeechSense. You can also add a description, if required.
To specify additional metadata, click Add key. Make sure to enter the new key name and select a metadata type.
SpeechSense can analyze audio recordings in Russian and Kazakh. First it recognizes your recording in Kazakh and then translates the transcript into Russian for further analysis. Each audio metadata must contain a string indicating the languages supposedly used in the conversation. When uploading an audio file in Kazakh, provide the
language: ru-RU, kk-KZ
string in the metadata. For Russian, providelanguage: ru-RU
. Language codes are case-insensitive.To upload related dialogs into the connection, add the
ticket_id
string key. The dialogs will be linked by this key. Enter the name the key will have in SpeechSense, e.g.,Task number
. You can also add a description, if required. -
Click Create connection.
Creating a connection for single-channel audio
-
Open the SpeechSense home page
. -
Go to the space of your choice.
-
In the top-right corner, click More →
Create connection. -
Specify a name of the connection and, if needed, add a description.
-
Select the Single-channel audio data type.
-
Under Agent, Customer:
Specify agent and customer keys from the metadata file. This file contains the call information collected from CRM systems, PBXs, or other sources.
By default, connections include keys with the name and ID of the agent and the customer. In the Name in the system field, enter the name the key will have in SpeechSense. You can also add a description, if required.
To specify additional metadata for the agent and the customer, click Add key. Make sure to enter the new key name and select a metadata type.
-
Under Shared metadata, provide the keys from the metadata file that are not related to the agent or the customer.
By default, connections include required keys with the date, direction, and language of the call. In the Name in the system field, enter the name the key will have in SpeechSense. You can also add a description, if required.
To specify additional metadata, click Add key. Make sure to enter the new key name and select a metadata type.
SpeechSense can analyze audio recordings in Russian and Kazakh. First it recognizes your recording in Kazakh and then translates the transcript into Russian for further analysis. Each audio metadata must contain a string indicating the languages supposedly used in the conversation. When uploading an audio file in Kazakh, provide the
language: ru-RU, kk-KZ
string in the metadata. For Russian, providelanguage: ru-RU
. Language codes are case-insensitive.To upload related dialogs into the connection, add the
ticket_id
string key. The dialogs will be linked by this key. Enter the name the key will have in SpeechSense, e.g.,Task number
. You can also add a description, if required. -
Optionally, under Additional, enable these options:
-
Split dialog text by speaker: Splits the dialog text between speakers.
Note
If you disable this option, the dialog text will be presented as only the agent's. All tags and report parameters will be applied exclusively to the agent channel.
-
Split dialogs by slices and select the dialog splitting option:
-
By duration: Dialog is divided into segments of specified duration.
- Slice length: Specify the segment length in minutes and seconds.
-
By phrases: Dialog is divided into segments based on key phrases.
-
Start of dialog, End of dialog: List the key phrases for the beginning and the end of the dialog.
Each phrase can contain no more than 10 words, the total limit is 20,000 phrases.
-
-
-
-
Click Create connection.
Creating a connection for a chat
-
Open the SpeechSense home page
. -
Go to the space of your choice.
-
In the top-right corner, click More →
Create connection. -
Specify a name of the connection and, if needed, add a description.
-
Select the Сhat data type.
-
Under Agent, Customer, Bot, specify the keys from the metadata file. This file contains the dialog information collected from chats, CRM systems, or other sources.
By default, connections include keys with agent's, customer's, and bot's names and IDs. In the Name in the system field, enter the name the key will have in SpeechSense. You can also add a description, if required.
To specify additional agent, customer, and bot metadata, click Add key. Make sure to enter the new key name and select a metadata type.
-
Under Shared metadata, provide the keys from the metadata file that are not related to the agent, customer, and bot.
By default, keys with date, direction, and dialog language are added to the connection. In the Name in the system field, enter the name the key will have in SpeechSense. You can also add a description, if required.
To specify additional metadata, click Add key. Make sure to enter the new key name and select a metadata type.
SpeechSense can analyze dialogs in Russian and Kazakh; it translates the transcript into Russian for further analysis. Each dialog metadata must contain a string indicating the languages supposedly used in the conversation. When uploading dialogs in Kazakh, provide the
language: ru-RU, kk-KZ
string in the metadata. For Russian, providelanguage: ru-RU
. Language codes are case-insensitive.To upload related dialogs into the connection, add the
ticket_id
string key. The dialogs will be linked by this key. Enter the name the key will have in SpeechSense, e.g.,Task number
. You can also add a description, if required. -
Click Create connection.