В данной статье рассмотрим, как можно передать краткий анализ по записи разговора с помощью сервиса T Bank VoiceKit и ИИ-блоков в MoreKIT

Содержание

Задача

Получаем входящий вебхук от АТС UIS
Передаем запись разговора в сервис T-Bank VoiceKit
Передаем результат транскрипции звонка в ИИ для получения краткого анализа разговора
Передаем результат в Bitrix24

Подключение сервисов

Первым делом — подключим нужные сервисы в MoreKIT

Подключение Bitrix24

Перед добавлением сервиса Битрикс24 в MoreKit необходимо установить приложение наше приложение в маркетплейсе. Для установки приложения требуется подписка на маркетплейс Битрикс24

После установки приложения MoreKit в маркетплейс Битрикс24 можно приступать к добавлению сервиса в Morekit. Для этого в проекте нажмите Добавить сервис, найдите в списке Битрикс24. При подключении сервиса будет запрошена ссылка на ваш битрикс

Введите ссылку в формате https://мой-домен.bitrix24.ru. После этого произойдет редирект на страницу с вашим битриксом, подтвердите авторизацию

Если все правильно — сервис появится в списке сервисов и у него будет статус Готово

Подключение T-Bank VoiceKit

В списке сервисов ищем VoiceKit

Для подключения нам понадобится API ключ и Секретный ключ

Для получения данных для добавления сервиса вы можете обратиться к официальной документации T Bank Voicekit:

Зарегистрируйтесь в личном кабинете и отправьте обращение — справа внизу нажмите на синий конверт, выберите продукт VoiceKit и раздел Общие вопросы. Т банк отправит информацию по оформлению нужных документов.
В личном кабинете сгенерируйте пару API-ключей — API_KEY и SECRET_KEY.
Сохраните оба ключа в безопасном месте. После создания можно посмотреть повторно только публичный ключ. Если вы забыли сохранить секретный ключ, перевыпустите его.

Пополнение баланса ИИ MoreKIT

Для данной задачи будем использовать ИИ-блоки в MoreKIT

Для использования ИИ блоков в схемах — необходимо пополнить ИИ баланс MoreKIT. Пополнить баланс на любую сумму можно в разделе О проекте —> Оплаты

После того, как все сервисы подключены и баланс пополнен — можем приступать к настройке схемы

Создание процесса

Получать данные от UIS будет процесс с типом Другое

В проекте нажимаем:

Создать процесс
Выбираем процесс с типом Другое

Даем процессу название и нажимаем Добавить

Подключение webhook от UIS

Следующим шагом — необходимо скопировать ссылку из первого блока схемы и отправить по ней webhook от АТС UIS

По скопированной на процесс ссылке нужно установить вебхук в личном кабинете UIS

Подробнее о подключении вебхуков можно посмотреть в официальной документации UIS

Установим webhook по событию Записанный разговор

После установки хука — нужно выполнить звонок по выбранному событию и посмотреть, были ли получены данные в процессе MoreKIT

В схеме нужно перейти в События

Если на стороне UIS все сделано верно — увидим входящее событие с данными о звонке

Далее — осталось выстроить схему передачи данных в Bitrix24

Настройка процесса

Схема передачи данных в Bitrix24 будет выглядеть следующим образом

Данная схема:

Скачивает файл записи разговора
Передает запись разговора в T Банк Voicekit для распознавания диалога звонка и получения его транскрипции
Отправляет транскрипцию звонка в ИИ для получения краткого анализа по итогу разговора
Ищет контакт в Bitrix24 по номеру телефона или создает его
Прикрепляет к контакту дело с типом Звонок, прикрепляя к нему файл

Описание блоков схемы

#4 HTTP запрос — данный блок скачает запись разговора в рамках схемы, в ответе будет содержать файл записи разговора. Файл нужен для прикрепления записи разговора в дело Bitrix24

#3 Распознавание речи — данный блок принимает в себя файл записи разговора. Для того, чтобы заполнить технические поля блока, необходимо скачать одну из записей с АТС, данный будут в Свойствах аудиофайла

На примере скачанного файла видим, что файл имеет два канала (стерео), частоту 8кгц и формат .mp3

#4 Запрос на ответ модели — в ИИ блок передаем файл и указываем промпт с настройками

Модель: в данном случае используется GPT 5.4 mini, она дешевле по сравнению с обычными моделями. Можете попробовать разные модели и выбрать ту, ответ которой вам больше понравится
Сообщение от разработчика — задаем промпт для ИИ. Это наиболее важная часть настройки для корректного ответа
Пример промпта из документации: Проведи аналитику диалога между менеджером и клиентом и выдай менеджеру краткий результат диалога согласно JSON_SCHEMA
Сообщение от пользователя:
текст диалога: {% for i in ID3 %}speaker_id: {{i.speaker_id}}\ntranscript:{{i.transcript}}{% endfor %}
JSON_schema ответа

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Краткое содержание разговора"
    },
    "result": {
      "type": "string",
      "description": "Чем закончился разговор"
    },
    "client_interest": {
      "type": "string",
      "description": "Уровень заинтересованности клиента"
    },
    "next_step": {
      "type": "string",
      "description": "Следующее действие менеджера"
    }
  },
  "required": [
    "summary",
    "result",
    "client_interest",
    "next_step"
  ],
  "additionalProperties": false
}

#13 JSON декодировать — данный блок возвращает ответ от ИИ в формате JSON, чтобы можно было легко передать данные дальше

#14 Создать переменную — данный блок записывает краткий анализ разговора в красивый вид, согласно JSON ответу от ИИ

#1 Найти контакты — ищем существующий контакт в Bitrix24 по номеру телефона

#2 Создать контакт — создаем контакт, заполняем номер телефон и имя

#9 Создать дело — данный блок создает дело с типом Звонок, прикрепляя к делу файл записи разговора и краткий анализ. Дело будет привязано к контакту

Тестирование процесса

Совершим звонок в UIS и проверим передачу данных

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

Дело с анализом прикрепилось к контакту. Попробуем посмотреть запись разговора

Как видим — запись разговора также прикрепилась, ее можно прослушать

Подведем итоги

В данной статье рассмотрели, как можно передать звонок в Bitrix24 и прикрепить к нему краткий анализ разговора для менеджера

Передаем аналитику разговора из АТС UIS в Bitrix24 с помощью T-Bank VoiceKit