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

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

  1. Подготовьте облако к работе.
  2. Настройте выгрузку из amoCRM в 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 и выберите сервисный аккаунт speechsense.

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

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

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

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

    Внимание

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

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

  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. В блоке Общие метаданные укажите не связанные с оператором и клиентом ключи из файла метаданных:

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

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

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

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

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

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

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

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

Установите приложение в amoCRM

  1. Перейдите в раздел amoМаркет в вашем личном кабинете amoCRM.

  2. В строке поиска введите Экспорт в SpeechSense.

  3. Нажмите Установить бесплатно.

  4. Включите опцию Согласен на передачу персональных данных....

  5. Нажмите Установить.

  6. На вкладке Описание нажмите Сохранить.

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

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

  1. Перейдите в раздел Настройки в вашем личном кабинете amoCRM.

  2. Откройте вкладку Настройки выгрузки SpeechSense.

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

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

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

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

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

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

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

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

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

      Примечание

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

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

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

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

    • Перевыгружать звонки — включите эту опцию, если нужно заново выгрузить ранее выгруженные звонки, например, в новое подключение или пространство SpeechSense. Если опция включена, система не будет проверять, выгружались ли до этого звонки, и все звонки будут выгружены снова.

    • Укажите минимальную и максимальную длительность разговора в секундах. Чтобы выгрузить все звонки, оставьте значения 0.

    • Настройте соответствие полей amoCRM и SpeechSense:

      1. В столбце amoCRM выберите ключ поля в amoCRM.
      2. В столбце SpeechSense введите ключ поля, доступного в подключении SpeechSense, которое вы создали ранее.

      Чтобы добавить новое соответствие, нажмите Добавить.

      Примечание

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

  5. Нажмите Сохранить настройки.

  6. Нажмите Начать выгрузку.

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

    Совет

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

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

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

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

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

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

Предыдущая
Автоматическая загрузка данных с помощью Yandex Workflows
Следующая
Интеграция с Битрикс24