Creating a connection

You can upload the following to a SpeechSense connection:

• Two-channel audio.
• Single-channel audio.
• Chat with text messages.

To create a connection, you need either the Admin or Editor role for the space.

Creating a connection for two-channel audioCreating a connection for two-channel audio

1. Open the SpeechSense home page.

2. Go to the space of your choice.

3. Go to the Connections tab and select a template to create a connection or click Create connection.

   • Blank form: Connection that allows adding your own keys for metadata.
   • Bitrix24: Connection with a pre-installed set of keys for Bitrix24. Additionally, you can add your own keys.
   • AmoCRM: Connection with a pre-installed set of keys for amoCRM. Additionally, you can add your own keys.

4. Specify a name of the connection and, if needed, add a description.

5. Select the Two-channel audio data type.

6. Under Agent, Customer:

   1. 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.

   2. 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.

7. 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 as per the template you select. In the Name in the system field, enter a 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, provide language: 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.

8. Click Create connection.

Creating a connection for single-channel audioCreating a connection for single-channel audio

1. Open the SpeechSense home page.

2. Go to the space of your choice.

3. Go to the Connections tab and select a template to create a connection or click Create connection.

   • Blank form: Connection that allows adding your own keys for metadata.
   • Bitrix24: Connection with a pre-installed set of keys for Bitrix24. Additionally, you can add your own keys.
   • AmoCRM: Connection with a pre-installed set of keys for amoCRM. Additionally, you can add your own keys.

4. Specify a name of the connection and, if needed, add a description.

5. Select the Single-channel audio data type.

6. 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.

7. 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 as per the template you select. In the Name in the system field, enter a 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, provide language: 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.

8. Optionally, under Additional, enable 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.

9. Click Create connection.

Creating a connection for a chatCreating a connection for a chat

1. Open the SpeechSense home page.

2. Go to the space of your choice.

3. Go to the Connections tab and select a template to create a connection or click Create connection.

   • Blank form: Connection that allows adding your own keys for metadata.
   • Bitrix24: Connection with a pre-installed set of keys for Bitrix24. Additionally, you can add your own keys.
   • AmoCRM: Connection with a pre-installed set of keys for amoCRM. Additionally, you can add your own keys.

4. Specify a name of the connection and, if needed, add a description.

5. Select the Сhat data type.

6. 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.

7. 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, provide language: 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.

8. Click Create connection.