​

Шаблон отчёта

​

Шаблон отчёта

Состав, который нужен каждую неделю, сохраняется под именем: «Сохранить как шаблон» запоминает колонки, их порядок, формат выгрузки и четыре настройки ниже — подписи колонок, замены значений, служебные колонки и структуру файла. Шаблоны принадлежат организации — до 50 штук, — и участник ведёт свои целиком, включая удаление. Несохранённый выбор называется «Свой шаблон». Шаблон — это копия, а не ссылка. Задание на отчёт забирает снимок шаблона в момент создания, поэтому правка или удаление шаблона не меняют ни одного уже сформированного отчёта. По той же причине при применении старого шаблона мир может оказаться другим: поле пост-аналитики переименовали или убрали, а колонки себестоимости попали в шаблон от того, кому они были видны. Форма говорит об этом строкой над списком: сколько колонок в шаблоне и какие из них сейчас недоступны — галочки с них сняты. Ничего не отваливается за спиной. Фильтр в шаблон намеренно не входит. Период каждый раз разный, и шаблон, заморозивший «1–14 августа», через месяц был бы бесполезен. Шаблон без заполненных настроек даёт файл в стандартном виде — если вам ничего из перечисленного не нужно, эти поля можно не трогать.

​

Подписи колонок

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

​

Замена значений

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

​

Служебные колонки

Кнопка «Добавить служебную колонку» создаёт колонку, которой нет в каталоге, — двух видов:

• одно значение во всех строках — константа: код выгрузки, название источника, признак партии;
• несколько колонок в одной — склейка от двух до пяти колонок каталога через ваш разделитель. Пустая часть пропускается, двойного разделителя не будет.

Служебная колонка занимает своё место в списке справа наравне с обычными; до 30 штук на шаблон.

​

Настройки файла

Блок «Настройки файла» отвечает за структуру выгрузки:

• Лист «Сводка» — отдельный первый лист с итогами.
• Лист по колонке — строки раскладываются по листам: лист на каждое значение колонки, шапка на каждом листе. Доступны агент, статус звонка и причина статуса; имя листа — само значение, обрезанное до 31 символа.
• Имя файла — шаблон с подстановками {campaign_id}, {campaign_name}, {date}, {template}. Кампания подставится, только если в фильтре ровно одна кампания; расширение добавит сервер. Если кампания в фильтре не названа, вместо {campaign_id} встанет дата создания отчёта. {campaign_name} в этом случае остаётся пустым: имя — украшение, различать файлы должен идентификатор.
• Все ячейки текстом — числа и даты записываются как текст, чтобы Excel не менял их вид: не превращал длинные номера в экспоненциальную запись и не терял ведущие нули. Отдельные колонки можно вывести из-под правила и оставить числами.
• Формат даты — один из трёх: ISO 8601, ГГГГ-ММ-ДД ЧЧ:ММ:СС или ДД.ММ.ГГГГ ЧЧ:ММ:СС.

​

Язык файла

Служебные тексты внутри книги XLSX — имена листов и девять подписей сводки («Всего звонков», «Статус», длительность, доля успешных) — приходят на языке вашего кабинета. Три детали:

• Язык замораживается в момент создания отчёта. Файл собирается фоном, иногда сильно позже запроса, и к этому моменту спрашивать уже некого — поэтому язык записывается в задание вместе с фильтром.
• Имена готовых системных форм и их описания — английские (у файла импорта — тоже).
• Подписи колонок не переводятся. В шапке файла по умолчанию стоят технические ключи (session_id, started_at) — на них завязаны разборщики на вашей стороне. Читаемую шапку задайте сами, см. Подписи колонок.