Шаблон отчёта
Шаблон отчёта
Состав, который нужен каждую неделю, сохраняется под именем: в окне «Отчёт по диалогам» на странице кампании — кнопкой «Сохранить как шаблон», в окне «Экспорт звонков» в Истории — кнопкой «Сохранить как набор». Шаблон запоминает колонки, их порядок, формат выгрузки и четыре настройки ниже — подписи колонок, замены значений, служебные колонки и настройки файла. Несохранённый выбор называется «Свой шаблон». Шаблоны общие для организации — до 50 штук. Каждый пользователь кабинета видит их в группе «Мои шаблоны» и может переименовать, перезаписать или удалить любой из них. Название шаблона — от 1 до 80 символов и уникально в организации: регистр и лишние пробелы не учитываются. В шаблоне должна быть хотя бы одна колонка. Если изменить что-либо в выбранном шаблоне, выбор переключится на «Свой шаблон». Дальше изменения можно записать в исходный шаблон кнопкой «Обновить шаблон «…»» — после подтверждения он перезаписывается — или сохранить как новый шаблон. Действия с шаблоном в двух окнах выглядят по-разному:- «Отчёт по диалогам» — кнопки над списком колонок: «Сохранить как шаблон», «Обновить шаблон «…»», «Переименовать» и «Удалить».
- «Экспорт звонков» — кнопка «Сохранить как набор» и меню ⋮ «Действия с набором»: «Обновить шаблон «…»», «Сохранить как новый набор», «Переименовать» и «Удалить».

Подписи колонок
У каждой выбранной колонки в правой панели раскрывается поле «Имя колонки» — как она будет называться в шапке файла. Пусто — в шапке остаётся ключ колонки. Подпись до 200 символов, это данные шаблона, а не перевод интерфейса: платформа пишет ровно то, что вы задали. Именно так собирается файл, привычный вашим получателям, без правки разборщиков на нашей стороне.Замена значений
Там же у колонки задаётся таблица «Заменить значение → на это значение»: до 100 строк на колонку. Сравнение точное, по строковому виду ячейки; пустое значение тоже можно заменить; всё, чего нет в таблице, выгружается как есть. Типичное применение — привести технические значения к словам, которые понимает получатель отчёта:completed → Дозвонились, voicemail → Автоответчик.

Служебные колонки
Кнопка «Добавить служебную колонку» создаёт колонку, которой нет в каталоге, — двух видов:- одно значение во всех строках — константа: код выгрузки, название источника, признак партии;
- несколько колонок в одной — склейка от двух до пяти колонок каталога через ваш разделитель. Пустая часть пропускается, двойного разделителя не будет.

Настройки файла
В окне «Отчёт по диалогам» настройки собраны в блоке «Настройки файла»: группы «Любой формат» и «Только XLSX». В окне «Экспорт звонков» — в разделе «Файл»: при Excel сразу под форматом стоят лист сводки и разбивка по листам, остальное — под «Ещё настройки».- Лист «Сводка» — отдельный лист с итогами, последний в книге, после листов со звонками.
- Лист по колонке — строки раскладываются по листам: лист на каждое значение колонки, шапка на каждом листе. Доступны агент, статус звонка и причина статуса. Имя листа — значение, обрезанное до 31 символа, без запрещённых в Excel символов
\ / ? * [ ] :; пустое значение попадает на лист «—». Замены значений колонки действуют и на имена листов. - Имя файла — шаблон имени до 120 символов.
{date}подставляет дату создания отчёта,{template}— название шаблона.{campaign_id}и{campaign_name}подставляются, когда в отчёте одна кампания — со страницы кампании или в «Истории» с одной кампанией в фильтре; если кампания не выбрана, вместо{campaign_id}встанет дата создания отчёта, а{campaign_name}останется пустым. Расширение добавит сервер. Все символы, кроме латинских букв, цифр,.,_,-и пробела, заменяются на_— название кампании кириллицей превратится в подчёркивания. - Заголовки колонок — «Подписи колонок»: ваши имена колонок там, где они заданы, у остальных колонок — ключ; «Технические ключи»: всегда ключи колонок, ваши имена не используются. Служебная колонка в обоих случаях называется своим именем.
- Все ячейки текстом — числа и даты записываются как текст, чтобы Excel не менял их вид: не превращал длинные номера в экспоненциальную запись и не терял ведущие нули. В окне «Отчёт по диалогам» отдельные колонки можно вывести из-под правила («Кроме колонок:») и оставить числами.
- Формат даты — один из трёх: ISO 8601,
ГГГГ-ММ-ДД ЧЧ:ММ:ССилиДД.ММ.ГГГГ ЧЧ:ММ:СС. Применяется к колонке «Начало».

Для CSV применяются имя файла, формат даты и заголовки колонок. Лист «Сводка», лист по колонке и «все ячейки текстом» — свойства книги XLSX. В окне «Отчёт по диалогам» при CSV они остаются видимыми и сохраняются в шаблоне, но к файлу не применяются, и форма об этом пишет. В окне «Экспорт звонков» при CSV они скрыты.
Язык файла
Служебные тексты внутри книги XLSX — имена листов и девять подписей сводки («Всего звонков», «Статус», длительность, доля успешных) — приходят на языке вашего кабинета. Три детали:- Язык замораживается в момент создания отчёта. Файл собирается фоном, иногда сильно позже запроса, и к этому моменту спрашивать уже некого — поэтому язык записывается в задание вместе с фильтром. Уже созданные задания не переписываются.
- Имена готовых системных форм и их описания — английские.
- Подписи колонок не переводятся. Без вашего имени колонки в шапке стоит её ключ (
session_id,started_at) — на ключи завязаны разборщики на вашей стороне. Читаемую шапку задайте сами, см. Подписи колонок.

