Импорт звонков с файлами

Авторизация

Тип авторизации — Basic (API Key).

При вызове методов интеграционного API через хедер Authorization передается значение Basic {credentials}, где credentials — это ключ доступа к TQM, полученный в личном кабинете.

Пример значения, которое нужно передать — Basic UuMlW1BUJzVsUM7Q.

Описание метода

Метод для загрузки звонков из файла. Требования к аудиофайлам:

• Стерео формат — в одном канале оператор, в другом — клиент.

• Качество записи — не меньше 32 Кб/c, желательно 64 Кб/с.

• Размер — не больше 32 Мб. Это нужно для корректного распознавания текста.

• Формат — MP3 или PCM-WAV.

  • PCM-WAV впоследствии конвертируется в MP3 — его размер не должен превышать 32 Мб после конвертации.
  • Размер исходного файла в PCM-WAV не должен превышать 100 Мб, максимальная длительность записи — не больше одного часа.

Звонок должен появиться в системе и стать доступным для поиска в течение 15 минут, расшифровка и речевой поиск — в течение часа.

URL запроса — https://tqm-cloud.tbank.ru/integration

Метод запроса — POST /import/call/with-file

Запрос

Параметр		Тип	Обязательность	Описание
file		string (binary)	true	Файл со звонками. Размер сконвертированного звонка — до 32 Мб.
value		object	true	Тело JSON-запроса.
id		string	true	Внешний ID звонка, не больше 32 символов.
	callDirection	string	true	Направление звонков: inbound — входящий; outbound — исходящий.
	startDate	string	true	Дата начала звонка, не больше текущей даты. Передается в формате 2023-09-25T11:00:00 без указания часового пояса.
	endDate	string	true	Дата окончания звонка, не больше текущей даты, не меньше start_date. Передается в формате 2023-09-25T11:00:00 без указания часового пояса.
	hangupParty	string	true	Сторона, положившая трубку в коммуникации: client — клиент; operator — оператор; server — тех. проблемы; error — ошибка; timeout — превышено время ожидания.
	operatorId	string	true	ID оператора, не больше 50 символов.
	operatorChannel	string	true	Канал оператора: left — левый; right — правый.
	clientPhoneNumber	string	true	Телефон клиента, не больше 50 символов.
	reason	string	false	Причина звонка, не больше 200 символов.
	result	string	false	Результат звонка, не больше 200 символов.
	languageCode	string	false	Язык разговора: ru — русский; en — английский.
	taskType	string	false	Тип задания, не больше 200 символов.

Ответ

Код ответа	Значение	Описание
200	OK	Успешная обработка.
400	Bad Request	Ошибка валидации
401	Unauthorized	Ошибка авторизации
403	Forbidden	Ошибка доступа к материалу
429	Too Many Requests	Превышен лимит: 10000 запросов за последние 24 часа; 16 одновременных соединений.
500	Internal Server Error	Внутренняя ошибка сервера. При возникновении ошибки 500 данные не попадают в TQM и не сохраняются.

Коммуникация не поступает в систему, если возвращается любой ответ, кроме 200.

Если вернулась ошибка 500, обратитесь в техническую поддержку. Для упрощения поиска причины ошибки в обращении укажите заголовок ответа x-correlation-id.

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