Contact UsGet started
© 2025 Direct Cursus Technology L.L.C.

SpeechSense integration with amoCRM

Written by
Updated at November 6, 2025

To set up SpeechSense integration with amoCRM:

  1. Get your cloud ready.
  2. Set up export from amoCRM to SpeechSense.
  3. Check the result.

Get your cloud ready

  1. Navigate to the management console and log in to Yandex Cloud or sign up if not signed up yet. For information on how to get started with Yandex Cloud, see Getting started with Yandex Cloud.

  2. Accept the user agreement.

  3. In Yandex Cloud Billing, make sure you have a billing account linked and its status is ACTIVE. If you do not have a billing account yet, create one. If your billing account has the TRIAL_ACTIVE status, activate its paid version.

  4. Assign the speech-sense.spaces.creator role to your Yandex Cloud account.

    Note

    If you are unable to manage roles, contact your cloud or organization administrator.

Create a service account

Create a service account with the speech-sense.data.editor role for amoCRM access to the SpeechSense project.

  1. In the management console, select the relevant folder.
  2. In the list of services, select Identity and Access Management.
  3. Click Create service account.
  4. Name the service account: speechsense.
  5. Click Add role and select speech-sense.data.editor.
  6. Click Create.

Create an API key for the service account

Create an API key for the service account.

  1. In the management console, select Identity and Access Management.

  2. In the left-hand panel, select Service accounts.

  3. Select the speechsense service account.

  4. In the top panel, click Create new key and select Create API key.

  5. In the Scope field, click Select all.

  6. Click Create.

  7. Save the ID and secret key for later.

    Alert

    After you close this dialog, the key value will no longer be available.

Create a space and link a billing account

  1. Open the SpeechSense home page.

  2. Click Create space.

  3. Enter a name for the space.

  4. Click Create.

  5. Link a billing account to the space to pay for SpeechSense.

    Note

    The user must have the billing.accounts.editor, billing.accounts.admin, or billing.accounts.owner role for the billing account to manage it.

Add the service account to the space

Add the service account to the SpeechSense space.

  1. Navigate to the new space in the SpeechSense interface.
  2. Click Add participant → Add from organization.
  3. Copy the ID of the speechsense service account you created earlier and paste it to the search bar.
  4. Select the speechsense service account and specify the Data editor role. This role will allow the service account to upload data to SpeechSense.
  5. Click Add.

Create a connection

  1. In the SpeechSense UI, go to the space of your choice.

  2. In the top-right corner, click More → Create connection.

  3. Enter the connection name.

  4. Select the Two-channel audio data type.

  5. Under Agent and Customer, specify:

    1. Channels with the agent's and customer's voices.
    2. 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.

    To specify additional metadata for the agent and the customer, click Add key.

  6. Under Shared metadata, provide the keys from the metadata file that are not related to the agent or the customer:

    • In the Key field, enter the field name to use when mapping fields in the exchange module settings. For example: Call date → call_date. Also, specify the name used in the system and add a description to display in SpeechSense forms and reports.
    • Currently, the Type field only supports the String value.

    By default, connections include keys with the date, direction, and language of the call. In addition, you can specify the keys you want to receive from the external system. In the Name in the system field, enter the name the key will have in SpeechSense.

    To provide additional metadata, click Add key.

  7. Click Create connection.

  8. Click ID in the top-left corner of the connection page to copy the connection ID. Save it as you will need it later.

Create a project

  1. In the SpeechSense UI, go to the space of your choice.
  2. Click Create project.
  3. Enter a name for your project.
  4. Under Connection, click Add connection and select the connection you created earlier.
  5. Click Create project.

Set up export from amoCRM to SpeechSense

Install the app in amoCRM

  1. Navigate to amoMarket in your amoCRM account.

  2. In the search bar, enter Export to SpeechSense.

  3. Click Install for free.

  4. Check the I agree to the collection of personal data... box.

  5. Click Install.

  6. In the Description tab, click Save.

    The app will be displayed in the Installed tab in amoMarket.

Set up export from amoCRM

  1. Navigate to Settings in your amoCRM account.

  2. Go to the SpeechSense export settings tab.

  3. Set up a connection:

    1. Language: Select the language for recognition.

    2. SpeechSense connection ID: Enter the ID of the connection you created previously.

    3. API key: Enter the secret part of the API key you created previously.

    4. Click Check connection.

      If the API key and connection ID are correct, you will see the following message:

      Successful request to SpeechSense

  4. Configure other settings:

    • Specify the period to export the calls for.

      Note

      The export will include the start and end dates.

    • User list: Specify the amoCRM users whose calls you want to export (a list of your agents). To export calls for all users, leave the list empty.

    • Call direction:

      • All: Export calls of all types.
      • Outgoing: Export only outgoing calls.
      • Incoming: Export only incoming calls.

    • Re-export calls: Enable this option if you need to re-export calls that were previously exported, e.g., to a new SpeechSense connection or workspace. When this option is on, the system will not check if the calls were previously exported and will export all calls once again.

    • Set the minimum and maximum conversation duration in seconds. To export all calls, leave the 0 values.

    • Configure field mapping in amoCRM and SpeechSense:

      1. In the amoCRM column, select the field key in amoCRM.
      2. In the SpeechSense column, enter the key of the field from the SpeechSense connection you created earlier.

      To add a new mapping, click Add.

      Note

      Calls can be associated with different amoCRM entities. Depending on the entity, i.e., a deal, contact, company, or call, the metadata provided with each call may vary. The associated entities are grouped into separate blocks.

  5. Click Save settings.

  6. Click Start export.

    Wait for the export to complete.

    Tip

    To force stop the export, click Stop export.

Check the result

  1. In the SpeechSense UI, go to the space of your choice.

  2. Select the project you created earlier.

    On the project panel, you will see the imported calls and transcripts. After that, you will be able to configure reports.

If you have any problems, contact Yandex Cloud.

Previous
SpeechSense integration with Bitrix24
Next
All tutorials