Перейти к содержанию

Выгрузка и загрузка

Страница отвечает на два вопроса: как скачать расшифровки многих звонков одним файлом (это доступно всем, у кого есть страница «Звонки») и как добавить в платформу аудио- или видеофайл вручную (это делает только владелец).

Выгрузка расшифровок

Выгрузка берёт расшифровки тех звонков, которые подходят под фильтры на странице «Звонки», и собирает их в один файл.

Как выгрузить

  1. Откройте страницу «Звонки» и выберите период, менеджера и нужные фильтры.
  2. Нажмите «Экспорт» в заголовке страницы. Кнопка неактивна, пока в списке пусто.
  3. В окне «Экспорт расшифровок» посмотрите число: «Найдено N расшифровок».
  4. Выберите формат файла.
  5. Нажмите «Скачать». Браузер начнёт загрузку, и появится сообщение «Скачивание началось».

Файл называется transcripts-<дата>.zip, .csv или .jsonl. Дата в имени это сегодняшний день по времени платформы.

Форматы

Формат Для чего Что внутри
«ZIP с txt-файлами» (по умолчанию) Читать и искать по текстам Один txt-файл на звонок и файл index.csv со сводкой всех звонков
«CSV для Excel» Таблица для анализа Одна таблица: строка на звонок, текст в последнем столбце. Разделитель «;», кодировка UTF-8, Excel открывает файл без настроек
«JSONL» Скрипты и интеграции Одна строка JSON на расшифровку

Имена txt-файлов в архиве состоят из даты, времени и цифр номера звонка, например 2026-10-07_14-32_номер_0199b3c4.txt. В конце стоят первые восемь знаков номера записи. Время указано по часовому поясу платформы.

Сводка index.csv и таблица CSV содержат столбцы: «Дата звонка», «Телефон», «Менеджер», «Направление», «Длительность, с», «Файл», «ID звонка», «Источник» и «ID записи». В сводке есть ещё «Файл в архиве», в таблице «Текст». В JSONL у каждой строки те же сведения о звонке, длительность, декодер и текст.

В файле нет оценок и результатов проверки, только текст и данные звонка, и нет отметок времени. В txt-файлах каждая фраза стоит на отдельной строке, в CSV и JSONL весь текст звонка лежит в одной ячейке или строке.

Какие звонки попадают в файл

В файл попадают только записи со статусом «Готово»: у остальных нет текста. Из них берутся те, что подходят под фильтры, которые выгрузка учитывает. Ваши права действуют и здесь: менеджеру с уровнем «Свои» попадут только его звонки, руководителю звонки его отдела.

Фильтр на странице «Звонки» Учитывается
Поиск по тексту Да
Период: даты, год, месяц, день Да
Менеджер, выбранный в каталоге Да
«Длительность записи», «Направление», «Телефон» Да
«Стоит послушать» Да
«Статус» (у владельца) Нет: в файл попадают только готовые записи
«Проверка» Нет
«Страна» и «Канал» Нет
«Отдел», «Менеджеры» и «Линия», пришедшие из отчёта Нет

Если среди выбранных фильтров есть те, что выгрузка не учитывает, окно предупредит: «Проверка, отдел, менеджер, страна, канал и линия здесь не действуют: в файл попадают все готовые записи, подходящие под остальные фильтры». Число «Найдено N расшифровок» в окне уже посчитано с учётом этого, поэтому оно может отличаться от числа записей в списке.

Внимание

Менеджер из каталога и менеджеры из отчёта это разные фильтры. Менеджер, которого вы выбрали в каталоге, учитывается. Менеджеры, пришедшие из отчёта (метка «Менеджер · …» над списком), выгрузка не учитывает. Чтобы выгрузить звонки одного человека, выберите его в каталоге.

Лимиты

  • Из интерфейса в один файл попадает не больше 10 000 расшифровок. Если их больше, окно предупредит: «Расшифровок больше 10 000: в файл попадут только первые 10 000. Сузьте фильтры, чтобы выгрузить остальные».
  • Руководитель и менеджер получают в один файл не больше 5 000 расшифровок, даже если окно показывает больше: предупреждение появляется только при превышении 10 000.
  • «Первые» значит самые ранние по времени добавления в платформу, а не самые свежие. Чтобы получить недавние звонки, сузьте период.
  • Через API в один файл можно выгрузить до 50 000 расшифровок.

Каждая выгрузка записывается в журнал действий как «Выгрузка расшифровок»: кто её сделал, в каком формате и сколько расшифровок выгружено («Выгружено 120 из 120, формат zip»).

Внимание

В файле тексты разговоров и номера клиентов: это персональные данные. Храните файл там, где к нему нет доступа посторонних, и не пересылайте его в открытых чатах. Подробнее: Персональные данные и хранение.

Выгрузка через API

Для интеграций та же выгрузка доступна по ключу API. Ключ создаёт владелец в «Настройки → Система → API-ключи».

curl -H "X-API-Key: <ключ>" -o transcripts.zip \
  "https://<адрес-api>/v1/transcripts/export?format=zip&dateFrom=2026-09-01T00:00:00%2B03:00&dateTo=2026-09-30T23:59:59%2B03:00"

Параметры: format (zip, csv или jsonl), limit (от 1 до 50 000, по умолчанию 10 000) и те же фильтры, что в списке: q, dateFrom, dateTo, minDurationSeconds, maxDurationSeconds, direction, manager, phone, scoreBelow. В ответе заголовки X-Transcripts-Matching и X-Transcripts-Exported говорят, сколько расшифровок подошло и сколько попало в файл. Остальное: API и интеграции.

Загрузка файла

Загружать файлы может только владелец. У руководителей и менеджеров кнопки нет.

Как загрузить

  1. Откройте страницу «Звонки» и нажмите «Загрузить файл» в заголовке страницы. Та же кнопка есть на пустой странице «Записей пока нет».
  2. В окне «Загрузка записей» перетащите файлы или целую папку, нажмите на область загрузки, чтобы выбрать файлы, или нажмите «Выбрать папку».
  3. Файлы появятся в списке «Загрузки». Каждый файл показывает размер и состояние: «Ожидает очереди», «Загружается · 40%», «Загружено», «Не загружено: причина» или «Отменено».
  4. Нажмите «Открыть запись» рядом с загруженным файлом, чтобы перейти на его карточку.

Одновременно грузятся три файла, остальные ждут. Не закрывайте вкладку, пока идёт загрузка: файлы отправляются из вашего браузера, и незавершённые остановятся. Кнопки в списке: «Повторить загрузку», «Отменить загрузку» (или «Убрать из списка» для завершённых) и «Очистить завершённые».

Что принимается

Принимается Пропускается
Файлы, которые браузер определил как аудио или видео Документы, картинки и другие файлы
Файлы с расширениями 3gp, aac, aif, aiff, amr, avi, flac, m4a, m4v, mkv, mov, mp3, mp4, mpeg, mpg, oga, ogg, opus, wav, weba, webm, wma Скрытые файлы, имя которых начинается с точки

Из видео берётся звуковая дорожка. Если в выбранном нет подходящих файлов, окно скажет «Подходящих аудио- и видеофайлов не нашлось.», а если часть файлов пропущена, напишет, сколько именно.

Ограничения

  • Размер одного файла: по умолчанию до 512 МБ. Предел задаёт администратор платформы. Файл больше предела получит состояние «Не загружено» с причиной.
  • Длина записи: по умолчанию не больше трёх часов. Более длинная запись получит статус «Ошибка».
  • Пустой файл платформа не принимает.
  • Если формат не распознан, запись получит статус «Ошибка», а повторять её не поможет. Причина видна на карточке.

Что происходит после загрузки

  1. Запись сразу появляется в списке «Звонки» со статусом «В очереди» и источником «Загрузка файла». Расшифровка начнётся сама, когда подойдёт очередь.
  2. Названием записи служит имя файла, а датой время загрузки: у файла нет ни времени звонка, ни номера клиента.
  3. У файла нет менеджера, направления и отдела, поэтому его видит только владелец. В отчёты он не попадает, а блока «Сделка в Битриксе» на карточке нет.
  4. Оценка у такого файла может не появиться: правила проверки привязаны к отделу, а у файла отдела нет.

Файл можно удалить на его карточке кнопкой «Удалить»: вместе с ним удалится расшифровка.

Как это считается

Число «Найдено N расшифровок» в окне выгрузки считается так:

  • Что считается. Расшифровки готовых записей, которые подходят под учитываемые фильтры и доступны вам по правам. Число обновляется само, пока окно открыто.
  • По какой дате. Период отбирается по дате начала звонка, а если она неизвестна, по времени загрузки файла.
  • Что не входит. Записи в очереди, в обработке, с ошибкой и отменённые, у которых нет текста, а также звонки, которые вы не видите по правам.
  • Предел. Из этого числа в файл попадает не больше 10 000 расшифровок, а у руководителя и менеджера не больше 5 000: сначала самые ранние.

См. также