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

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

  1. Подготовьте облако к работе.
  2. Настройте выгрузку из Битрикс24 в SpeechSense.
  3. Проверьте результат.

Подготовьте облако к работе

  1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь, если вы еще не зарегистрированы. Подробнее в документе Начало работы с Yandex Cloud.

  2. Примите пользовательское соглашение.

  3. В сервисе Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт и он находится в статусе ACTIVE. Если платежного аккаунта нет, создайте его, если платежный аккаунт находится в статусе TRIAL_ACTIVE, активируйте платную версию аккаунта.

  4. Назначьте вашему аккаунту в Yandex Cloud роль speech-sense.spaces.creator.

    Примечание

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

В стоимость инфраструктуры для интеграции с внешними системами входит плата за сервис SpeechSense: длительность каждого двухканального аудиофайла (тарифы SpeechSense).

Создайте сервисный аккаунт

Создайте сервисный аккаунт с ролью speech-sense.data.editor для доступа amoCRM к проекту SpeechSense.

  1. В консоли управления выберите нужный каталог.
  2. Перейдите в сервис Identity and Access Management.
  3. Нажмите Создать сервисный аккаунт.
  4. Введите имя сервисного аккаунта: speechsense.
  5. Нажмите Добавить роль и выберите speech-sense.data.editor.
  6. Нажмите Создать.

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

  1. В консоли управления выберите каталог, в котором был создан сервисный аккаунт.

  2. Перейдите в сервис Identity and Access Management.

  3. На панели слева выберите Сервисные аккаунты.

  4. Выберите сервисный аккаунт speechsense.

  5. На панели сверху нажмите Создать новый ключ и выберите Создать API-ключ.

  6. В открывшемся окне в поле Область действия выберите область действия yc.speech-sense.use.

  7. Нажмите Создать.

  8. Сохраните идентификатор и секретный ключ — они понадобятся позднее.

    Внимание

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

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

  1. Откройте главную страницу SpeechSense.

  2. Нажмите кнопку Создать пространство.

  3. Введите название пространства.

  4. Нажмите кнопку Создать.

  5. Привяжите платежный аккаунт к пространству для оплаты SpeechSense.

    Примечание

    Для управления платежным аккаунтом у пользователя должна быть назначена роль billing.accounts.editor, billing.accounts.admin или billing.accounts.owner на нужный платежный аккаунт.

Добавьте сервисный аккаунт в пространство

  1. В интерфейсе SpeechSense перейдите в новое пространство.
  2. Нажмите кнопку Добавить участника → Добавить из организации.
  3. Скопируйте идентификатор созданного ранее сервисного аккаунта speechsense и вставьте в строку поиска.
  4. Выберите сервисный аккаунт speechsense и укажите роль Data editor. Эта роль позволит сервисному аккаунту загружать данные в SpeechSense.
  5. Нажмите кнопку Добавить.

Создайте подключение

  1. В интерфейсе SpeechSense перейдите в нужное пространство.

  2. Откройте вкладку Подключения и выберите шаблон для создания подключения, либо нажмите кнопку Создать подключение:

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

  3. Укажите название подключения.

  4. Выберите тип данных Двухканальное аудио.

  5. В блоках Оператор и Клиент укажите:

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

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

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

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

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

    Список доступных полей

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

    {
    "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"
}

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

  7. Нажмите Создать подключение.

  8. На странице подключения в левом верхнем углу нажмите ID , чтобы скопировать идентификатор подключения. Сохраните его — он понадобится позднее.

Создайте проект

  1. В интерфейсе SpeechSense перейдите в нужное пространство.
  2. Нажмите Создать проект.
  3. Введите имя проекта.
  4. В блоке Подключение нажмите Добавить подключение и выберите подключение, созданное ранее.
  5. Нажмите Создать проект.

Настройте выгрузку из Битрикс24 в SpeechSense

Установите приложение в Битрикс24

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

Настройте выгрузку из Битрикс24

  1. Настройте подключение:

    1. Язык — выберите язык для распознавания.

    2. ID подключения SpeechSense — укажите идентификатор подключения, которое вы создали ранее.

    3. API-ключ — укажите секретную часть API-ключа, который вы создали ранее.

    4. Нажмите Проверить подключение.

      Если API-ключ и идентификатор подключения указаны правильно, отобразится сообщение:

      Успешный запрос к SpeechSense

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

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

      Примечание

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

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

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

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

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

    • Минимальная длина разговора — укажите длительность разговора в секундах. Рекомендуется выгружать звонки длительностью от 30 секунд.

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

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

  3. Нажмите Сохранить.

  4. Нажмите Запустить выгрузку.

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

Проверьте результат

  1. В интерфейсе SpeechSense перейдите в нужное пространство.

  2. Выберите созданный ранее проект.

    На панели проекта вы увидите загруженные звонки и расшифровки. После этого вы сможете настраивать отчеты.

В случае возникновения проблем свяжитесь со специалистом Yandex Cloud.

Предыдущая
Интеграция с amoCRM
Следующая
Работа с AI-ассистентом