Импорт записи бейджа с файлом

/import/badge/with-file

POST

https://tqm-cloud.tbank.ru/v2/integration/import/badge/with-file

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

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

• Звонок должен появиться в системе и стать доступным для поиска в течение 15 минут, расшифровка и речевой поиск — в течение часа.
• Коммуникация не поступает в систему, если возвращается любой ответ, кроме 200. Если вернулась ошибка 500, обратитесь в техническую поддержку. Для упрощения поиска причины ошибки в обращении укажите заголовок ответа x-correlation-id. Когда поддержка ответит, что проблема решена, повторно вызовите метод для коммуникаций, которые не удалось импортировать.
• При отправке большого количества коммуникаций одновременно необходимо делать это небольшими батчами до ~100 запросов, равномерно, без резких скачков в количестве запросов в секунду (RPS). В противном случае вы можете быть временно заблокированы системой защиты от DDoS атак.

• Пример запроса: curl --location --request POST
  'https://tqm-cloud.tbank.ru/v2/integration/import/badge/with-file'
  -H 'accept: application/json'
  -H 'Content-Type: multipart/form-data'
  -H 'Authorization: <API_KEY_VALUE>'
  -F 'file=@test.wav;type=audio/wav'
  -F 'value={
  "id": "123456",
  "callDirection": "inbound",
  "startDate": "2023-03-30T12:55:34",
  "endDate": "2023-03-30T12:55:34",
  "hangupParty": "client",
  "operatorId": "743",
  "operatorChannel": "right",
  "clientPhoneNumber": "+79998887766",
  "reason": "some reason",
  "result": "some result",
  "languageCode": "Ru",
  "taskType": "new"
  }'

Авторизация

Security

Bearer API Token

Запрос

Query parameters

Required

apiVersion

String

Default: 1.0

The requested API version

Request body schema multipart/form-data

file

String<binary>

Запись бейджа

value

Object (ExternalBadge)

Запись бейджа.

id

String

Уникальный идентификатор, не больше 64 знаков.

Required

startDate

String<date-time>

Дата начала встречи. Дата должна передаваться в формате 2025-07-25T11:00:00 без указания часового пояса.

Required

endDate

String<date-time>

Дата завершения встречи. Дата должна передаваться в формате 2025-07-25T11:00:00 без указания часового

operatorId

String

Идентификатор оператора, не больше 50 символов.

reason

String

Причина встречи, не больше 200 символов.

result

String

Результат встречи, не больше 200 символов.

Required

languageCode

String (ExternalLanguageCode)<int32>

Requirements: [ru, en]

Код языка

taskType

String

Тип задания, не больше 200 символов.

Ответ

200

OK

400

Bad Request

500

Internal Server Error

Это полезный материал?

Обратиться в поддержку

Loading...