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

В консоли управления выберите сервис Identity and Access Management.

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

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

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

В поле Область действия нажмите Выбрать все.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

По умолчанию в подключение добавлены ключи с датой, направлением звонка и языком диалога. Дополнительно можно задать набор ключей, которые вы хотите получать из внешнего сервиса. В поле Название в системе введите название, под которым ключ будет отображаться в 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"
}

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

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

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

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

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

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

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

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

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

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

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

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

  Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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