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

# Интеграция SpeechSense с Битрикс24

Чтобы настроить интеграцию SpeechSense с Битрикс24:

1. [Подготовьте облако к работе](#before-you-begin).
1. [Настройте выгрузку из Битрикс24 в SpeechSense](#bitrix24-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. В блоке **Общие метаданные** укажите не связанные с оператором и клиентом ключи из файла метаданных.

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

      {% cut "Список доступных полей" %}

      Список актуален для текущей версии приложения.

      ```json
      {
          "id",
          "portal_user_id",
          "portal_number",
          "phone_number",
          "call_id",
          "external_call_id",
          "call_category",
          "call_duration",
          "call_start_date",
          "call_record_url",
          "call_vote",
          "cost",
          "cost_currency",
          "call_failed_code",
          "call_failed_reason",
          "crm_entity_type",
          "crm_entity_id",
          "crm_activity_id",
          "rest_app_id",
          "rest_app_name",
          "transcript_id",
          "transcript_pending",
          "session_id",
          "redial_attempt",
          "comment",
          "record_duration",
          "record_file_id",
          "call_type"
      }
      ```

      {% endcut %}

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

  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 %}


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


### Установите приложение в Битрикс24 {#bitrix24-app}

{% list tabs group=instructions %}

- Интерфейс Битрикс24 {#bitrix24}

  1. Перейдите в раздел **Маркет** в вашем личном кабинете Битрикс24.
  1. В строке поиска введите `Yandex SpeechSense`.
  1. Нажмите **Установить**.
  1. Включите опции **Я ознакомлен и согласен с...** и нажмите **Установить**.
  1. Нажмите **Открыть приложение**.

{% endlist %}


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

{% list tabs group=instructions %}

- Интерфейс Битрикс24 {#bitrix24}

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

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

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

          {% note info %}

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

          {% endnote %}

          Чтобы выгрузить звонки за все время, не указывайте даты.

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

      * **Направление звонка** выберите один или несколько вариантов :

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

      * **Минимальная длина разговора** — укажите длительность разговора в секундах. Рекомендуется выгружать звонки длительностью от 30 секунд.
      * **ID последнего обработанного звонка** — поле недоступно для редактирования. Здесь отображается значение, по которому можно определить, какой звонок был обработан последним. 

          Чтобы обнулить значение поля, нажмите **Сбросить**.

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

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

{% 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.