[Документация Yandex Cloud](../../../index.md) > [Практические руководства](../../index.md) > [Машинное обучение и искусственный интеллект](../index.md) > Речевая аналитика > Интеграция SpeechSense с amoCRM

# Интеграция SpeechSense с amoCRM

Чтобы настроить интеграцию SpeechSense с [amoCRM](https://www.amocrm.ru/):

1. [Подготовьте облако к работе](#before-you-begin).
1. [Настройте выгрузку из amoCRM в SpeechSense](#amocrm-export).
1. [Проверьте результат](#check-result).

## Подготовьте облако к работе {#before-you-begin}

1. Перейдите в [консоль управления](https://kz.console.yandex.cloud), затем войдите в Yandex Cloud или зарегистрируйтесь, если вы еще не зарегистрированы. Подробнее в документе [Начало работы с Yandex Cloud](../../../getting-started/index.md).
1. Примите пользовательское соглашение.
1. В сервисе [Yandex Cloud Billing](https://kz.console.yandex.cloud/billing) убедитесь, что у вас подключен [платежный аккаунт](../../../billing/concepts/billing-account.md) и он находится в статусе `ACTIVE`. Если платежного аккаунта нет, [создайте его](../../../billing/quickstart/index.md#create_billing_account), если платежный аккаунт находится в статусе `TRIAL_ACTIVE`, [активируйте платную версию](../../../billing/operations/activate-commercial.md) аккаунта.
1. [Назначьте](../../../iam/operations/roles/grant.md) вашему аккаунту в Yandex Cloud роль `speech-sense.spaces.creator`.

    {% note info %}
    
    Если вы не можете управлять ролями, обратитесь к администратору вашего облака или организации.
    
    {% endnote %}

### Необходимые платные ресурсы {#paid-resources}

В стоимость инфраструктуры для интеграции с внешними системами входит плата за сервис SpeechSense: длительность каждого двухканального аудиофайла ([тарифы SpeechSense](https://aistudio.yandex.ru/docs/ru/speechsense/pricing)).

### Создайте сервисный аккаунт {#create-sa}

Создайте сервисный аккаунт с [ролью](https://aistudio.yandex.ru/docs/ru/speechsense/security/#speechsense-data-editor) `speech-sense.data.editor` для доступа amoCRM к проекту SpeechSense.

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) выберите нужный каталог.
  1. Перейдите в сервис **Identity and Access Management**.
  1. Нажмите **Создать сервисный аккаунт**.
  1. Введите имя [сервисного аккаунта](../../../iam/concepts/users/service-accounts.md): `speechsense`.
  1. Нажмите ![image](../../../_assets/console-icons/plus.svg) **Добавить роль** и выберите `speech-sense.data.editor`.
  1. Нажмите **Создать**.

{% endlist %}


### Создайте API-ключ для сервисного аккаунта {#create-key}

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором был создан сервисный аккаунт.
  1. Перейдите в сервис **Identity and Access Management**.
  1. На панели слева выберите ![FaceRobot](../../../_assets/console-icons/face-robot.svg) **Сервисные аккаунты**.
  1. Выберите сервисный аккаунт `speechsense`.
  1. На панели сверху нажмите ![image](../../../_assets/console-icons/plus.svg) **Создать новый ключ** и выберите **Создать API-ключ**.
  1. В открывшемся окне в поле **Область действия** выберите [область действия](../../../iam/concepts/authorization/api-key.md#scoped-api-keys) `yc.speech-sense.use`.
  1. Нажмите **Создать**.
  1. Сохраните идентификатор и секретный ключ — они понадобятся позднее.

      {% note alert %}

      После закрытия диалога значение ключа будет недоступно.

      {% endnote %}

{% endlist %}


### Создайте пространство и привяжите платежный аккаунт {#create-space}

{% list tabs group=instructions %}

- Интерфейс SpeechSense {#speechsense}

  1. Откройте [главную страницу](https://speechsense.yandex.cloud/) SpeechSense.
  1. Нажмите кнопку **Создать пространство**.
  1. Введите название [пространства](https://aistudio.yandex.ru/docs/ru/speechsense/concepts/resources-hierarchy#space).
  1. Нажмите кнопку **Создать**.
  1. [Привяжите платежный аккаунт](https://aistudio.yandex.ru/docs/ru/speechsense/operations/space/link-ba) к пространству для оплаты SpeechSense.

      {% note info %}
      
      Для управления платежным аккаунтом у пользователя должна быть [назначена](../../../billing/security/index.md#set-role) роль `billing.accounts.editor`, `billing.accounts.admin` или `billing.accounts.owner` на нужный платежный аккаунт.
      
      {% endnote %}

{% endlist %}


### Добавьте сервисный аккаунт в пространство {#add-sa-to-space}

{% list tabs group=instructions %}

- Интерфейс SpeechSense {#speechsense}

  1. В [интерфейсе](https://speechsense.yandex.cloud/) SpeechSense перейдите в [новое пространство](#create-space).
  1. Нажмите кнопку ![image](../../../_assets/console-icons/person-plus.svg) **Добавить участника** → ![image](../../../_assets/console-icons/persons.svg) **Добавить из организации**.
  1. Скопируйте идентификатор [созданного ранее сервисного аккаунта](#create-sa) `speechsense` и вставьте в строку поиска.
  1. Выберите сервисный аккаунт `speechsense` и укажите роль [Data editor](https://aistudio.yandex.ru/docs/ru/speechsense/security/#speechsense-data-editor). Эта роль позволит сервисному аккаунту загружать данные в SpeechSense.
  1. Нажмите кнопку **Добавить**.

{% endlist %}


### Создайте подключение {#create-connection}

{% list tabs group=instructions %}

- Интерфейс SpeechSense {#speechsense}

  1. В [интерфейсе](https://speechsense.yandex.cloud/) SpeechSense перейдите в нужное пространство.
  1. Перейдите на вкладку **Подключения** и выберите шаблон для создания подключения, либо нажмите кнопку **Создать подключение**:

     * **Пустая форма** — подключение с возможностью добавить ваши собственные ключи для метаданных.
     * **Bitrix24** — подключение с предустановленным набором ключей для Битрикс24. Дополнительно можно добавить собственные ключи.
     * **AmoCRM** — подключение с предустановленным набором ключей для amoCRM. Дополнительно можно добавить собственные ключи.
 
  1. Укажите название подключения.
  1. Выберите тип данных `Двухканальное аудио`.
  1. В блоках **Оператор** и **Клиент** укажите:

      1. Каналы, в которых записаны голос оператора и голос клиента.
      1. Ключи из файла метаданных для оператора и клиента. Этот файл содержит информацию о звонке, полученную из CRM-систем, АТС или других источников.

        По умолчанию в подключение добавлены ключи с именем и идентификатором оператора и клиента. В поле **Название в системе** введите название, под которым ключ будет отображаться в SpeechSense.

        Чтобы указать дополнительные метаданные для оператора и клиента, нажмите **Добавить ключ**.

  1. В блоке **Общие метаданные** укажите не связанные с оператором и клиентом ключи из файла метаданных:

      * В поле **Ключ** укажите транслитерированное название поля — оно понадобится при сопоставлении полей в настройках модуля обмена. Например, `Дата звонка` → `data_zvonka`. Укажите название в системе и описание — они будут отображаться в формах и отчетах SpeechSense.
      * В поле **Тип** на данный момент поддерживается только значение `Строка`.

      По умолчанию в подключение добавлены ключи с датой, направлением звонка и языком диалога. Дополнительно можно задать набор ключей, которые вы хотите получать из внешнего сервиса. В поле **Название в системе** введите название, под которым ключ будет отображаться в SpeechSense.

      Чтобы указать дополнительные метаданные, нажмите **Добавить ключ**.

  1. Нажмите **Создать подключение**.
  1. На странице подключения в левом верхнем углу нажмите **ID** ![image](../../../_assets/console-icons/copy-transparent.svg), чтобы скопировать идентификатор подключения. Сохраните его — он понадобится позднее.

{% endlist %}


### Создайте проект {#create-project}

{% list tabs group=instructions %}

- Интерфейс SpeechSense {#speechsense}

  1. В [интерфейсе](https://speechsense.yandex.cloud/) SpeechSense перейдите в нужное пространство.
  1. Нажмите ![create](../../../_assets/console-icons/folder-plus.svg) **Создать проект**.
  1. Введите имя проекта.
  1. В блоке **Подключение** нажмите **Добавить подключение** и выберите подключение, созданное [ранее](#create-connection).
  1. Нажмите **Создать проект**.

{% endlist %}


## Настройте выгрузку из amoCRM в SpeechSense {#amocrm-export}


### Установите приложение в amoCRM {#amocrm-app}

{% list tabs group=instructions %}

- Интерфейс amoCRM {#amocrm}

  1. Перейдите в раздел **amoМаркет** в вашем личном кабинете amoCRM.
  1. В строке поиска введите `Экспорт в SpeechSense`.
  1. Нажмите **Установить бесплатно**.
  1. Включите опцию **Согласен на передачу персональных данных...**.
  1. Нажмите **Установить**.
  1. На вкладке **Описание** нажмите **Сохранить**.

      Приложение появится в разделе **amoМаркет** на вкладке **Установленные**.

{% endlist %}


### Настройте выгрузку из amoCRM {#amocrm-config}

{% list tabs group=instructions %}

- Интерфейс amoCRM {#amocrm}

  1. Перейдите в раздел **Настройки** в вашем личном кабинете amoCRM.
  1. Перейдите на вкладку **Настройки выгрузки SpeechSense**.
  1. Настройте подключение:
     
     1. **Язык** — выберите язык для распознавания.
     1. **ID подключения SpeechSense** — укажите идентификатор подключения, которое вы создали [ранее](#create-audio-connection).
     1. **API-ключ** — укажите секретную часть API-ключа, который вы создали [ранее](#create-key).
     1. Нажмите **Проверить подключение**.
     
         Если API-ключ и идентификатор подключения указаны правильно, отобразится сообщение:
     
         ```text
         Успешный запрос к SpeechSense
         ```

  1. Настройте остальные параметры:

      * Укажите период, за который нужно загрузить звонки.

          {% note info %}

          Начальная и конечная даты будут включены в выгрузку.

          {% endnote %}

      * **Список пользователей** — укажите пользователей amoCRM, звонки с которыми нужно выгрузить (список ваших операторов). Чтобы выгрузить звонки всех пользователей, оставьте список пустым.

      * **Направление звонка**:

          * `Все` — выгрузка всех типов звонков.
          * `Исходящий` — выгрузка только исходящих звонков.
          * `Входящий` — выгрузка только входящих звонков.

      * **Перевыгружать звонки** — включите эту опцию, если нужно заново выгрузить ранее выгруженные звонки, например, в новое подключение или пространство SpeechSense. Если опция включена, система не будет проверять, выгружались ли до этого звонки, и все звонки будут выгружены снова.
      * Укажите минимальную и максимальную длительность разговора в секундах. Чтобы выгрузить все звонки, оставьте значения `0`.
      * Настройте соответствие полей amoCRM и SpeechSense:

          1. В столбце **amoCRM** выберите ключ поля в amoCRM.
          1. В столбце **SpeechSense** введите ключ поля, доступного в подключении SpeechSense, которое вы создали [ранее](#create-audio-connection).

          Чтобы добавить новое соответствие, нажмите ![image](../../../_assets/console-icons/plus.svg) **Добавить**.

          {% note info %}

          Звонки могут быть привязаны к различным сущностям системы amoCRM. Передаваемые со звонком метаданные могут отличаться в зависимости от связанной сущности: сделка, контакт, компания или звонок. Привязанные к звонку сущности разделены на блоки.

          {% endnote %}

  1. Нажмите **Сохранить настройки**.
  1. Нажмите **Начать выгрузку**.

      Дождитесь завершения выгрузки.

      {% note tip %}

      Чтобы принудительно остановить выгрузку, нажмите **Остановить выгрузку**.

      {% endnote %}

{% endlist %}


## Проверьте результат {#check-result}

{% list tabs group=instructions %}

- Интерфейс SpeechSense {#speechsense}

  1. В [интерфейсе](https://speechsense.yandex.cloud/) SpeechSense перейдите в нужное пространство.
  1. Выберите созданный [ранее](#create-project) проект.

      На панели проекта вы увидите загруженные звонки и расшифровки. После этого вы сможете [настраивать отчеты](https://aistudio.yandex.ru/docs/ru/speechsense/operations/data/manage-reports).

{% endlist %}

В случае возникновения проблем [свяжитесь](#contact-form) со специалистом Yandex Cloud.