Импорт звонков

Авторизация

Тип авторизации — 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

Запрос

Параметр	Тип	Обязательность	Описание
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 символов.
FileLink	string	true	Ссылка на файл, не больше 2000 символов.
LanguageCode	string	false	Язык разговора: ru — русский; en — английский.
TaskType	string	false	Тип задания, не больше 200 символов.

Ответ

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

При ошибке 500 коммуникация не поступает в систему из-за внутреннего сбоя.

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

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