Импорт: как принести файл и что с ним будет

Одна дверь для любых файлов: живые сообщения и шаблоны — со статусами или без, от одного оператора или от нескольких сразу. Что с файлом произойдёт и где на этом теряют деньги.

Что сюда носят

Меню → «Импорт». Настоящих видов файла два, и различаются они содержимым: в шаблоне есть переменные, в отправленном сообщении их не бывает.

Живые сообщения — выгрузка отправленных SMS. Соберёт шаблоны для тех сообщений, которые идут мимо ваших.
Шаблоны — таблица с текстами: своя, из кабинета оператора или от поставщика SMS. Что произойдёт, решают колонки: есть текст — заведём, есть ещё и решения оператора — проставим статусы, причины отказов и номера, а оператор в колонке достанется каждой строке свой.

Принимаются CSV и XLSX до 80 МБ и до 200 000 строк. Вид файла, кодировка и разделитель определяются сами — указывать их заранее не нужно.

Сам файл нигде не сохраняется — он разбирается при загрузке. Остаётся разобранное: тексты, отправитель, оператор, дата. В текстах реальных SMS могут быть сведения ваших клиентов: имя, сумма, номер заказа приезжают внутри самого сообщения — решаете вы.

Принесённая выгрузка трафика остаётся у вас. Её разбор открывается заново из «Журнала», а числа по ней — сколько трафика идёт мимо шаблонов и какие шаблоны молчат — считает «Аналитика» в «Инструментах». Хранятся последние 12 выгрузок; у старых есть срок, после которого они чистятся.

Шаг 1. Как файл прочитан

Первая карточка после загрузки говорит, как именно файл прочитан: кодировка, разделитель, есть ли строка заголовков, а у книги Excel — какой лист взят. Всё это определено само, но правится: любая правка тут же перечитывает файл.

Смотреть на неё стоит одну секунду и по одному признаку — читается ли текст в таблице ниже. Если вместо букв «кракозябры», меняйте кодировку; если вся строка попала в одну колонку, меняйте разделитель.

Когда листов в книге больше одного, проверяйте, какой взят: берётся первый, а данные бывают на втором. Листы не объединяются — если нужны оба, несите файл дважды, выбирая нужный лист.

Шаг 2. Что мы поняли про файл

Над таблицей стоит вывод: «Прочитали как шаблоны со статусами. Оператор — в колонке файла». Он собран из того, что нашлось в файле, — проверьте его: ошибка здесь делает неверным весь разбор. Не согласны — нажмите «Не так?» и скажите, сообщения это или шаблоны.

Селекторы рядом появляются там, где разбор не уверен, и говорят, что именно посчитали, — например «узнали 2 названия из 6» у колонки операторов; спорная колонка подсвечена в таблице первых строк. Вопрос «Чей это ответ» задаётся, только когда статусы в файле есть, а оператора в нём нет.

Кому шаблоны пойдут, «Импорт» не спрашивает: заведённые получают всех ваших операторов сразу, а строка, где оператор назван в самом файле, — того, кто в ней назван. Лишних снимете в самом шаблоне.

Шаг 3. Разметка колонок

Обязательная колонка одна — та, где лежит текст: «Текст сообщения» у реальных SMS, «Текст шаблона» у остальных. Она стоит наверху, рядом с видом файла, и её стоит проверить в первую очередь: разбор идёт от неё.

Всё остальное — отправителя, оператора, дату, тип трафика, номера шаблонов, статус — разбор берёт из файла сам, если найдёт. Что и куда попало, видно в таблице под карточкой. Не нашёл или взял не то — откройте «Разметку колонок» и поправьте: там перечислены все поля этого вида файла.

Подпись отправителя ищется по вашему справочнику «Отправители». Если справочник пуст, колонка не угадывается — выберите её сами.
Номеров шаблона два, и они разные: «Номер шаблона у оператора» — из кабинета оператора, «Номер у поставщика» — из системы поставщика SMS. В заявку на снятие идёт второй, если он есть.
Дата ответа берётся только из колонки, которая про ответ оператора. «Дата создания» под неё не подойдёт: это день, когда шаблон завели.

Разметка запоминается за вашим поставщиком SMS и подставится в следующий раз — но только если файл тот же по составу колонок. Разошёлся хоть на одну — колонки подбираются заново.

У узнанной выгрузки из кабинета оператора карточки разметки нет — вместо неё стоит строка «Разметка колонок не нужна». Такая выгрузка читается по своему формату целиком, размечать в ней нечего. Колонки в такой выгрузке стоят на известных местах.

Живые сообщения: шаблоны из непокрытого

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

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

Под текстом стоит ряд «Сделать переменной»: слова и числа, которые от сообщения к сообщению менялись. Нажатие ставит на это место переменную, повторное — возвращает слово обратно.

Число, обведённое янтарной рамкой, — обезличенное. Кабинеты часто отдают выгрузку, где каждое число заменено чередой одной цифры: «8888» вместо настоящего кода. Оставите его в тексте как есть — оно станет постоянной частью шаблона: оператор такой шаблон зарегистрирует, плата за него пойдёт, а ни одного живого сообщения он не поймает. Нажмите на него, чтобы на его месте встала переменная.

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

Мелкие группы шаблоном не предлагаются: по одному-двум сообщениям не видно, что в тексте меняется от раза к разу, и такой шаблон поймает только эти самые тексты. Где проходит граница, решаете вы — селектор «Шаблон от» над списком; по умолчанию это 20 сообщений в группе. Рядом написано, сколько шаблонов получается при нынешнем пороге.

Порог стоит опустить, когда ищете то, что пропустили в прошлый раз, и поднять, когда смотрите большую выгрузку и вам нужно только крупное. Выбор действует на этот разбор и не запоминается.

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

Свои тексты без статусов: что заведётся, а что нет

Над таблицей — ряд отборов с числами, и это ответ на вопрос «что будет, если я нажму». Нажатие показывает только эти строки: так до них можно дойти и в файле на три сотни строк.

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

Обязательная колонка в файле одна — текст шаблона. Название, пример, тип, отправитель и статус разбор берёт, если найдёт; чего в файле нет, то и не заведётся. Название, которого в файле не было, соберётся из первых слов текста — переименуете потом в реестре.

Над таблицей стоят три общих селектора — «Тип», «Статус», «Отправитель». Каждый ставит своё значение всем строкам разом, а «Автоматически» возвращает то, что разбор взял из файла. Те же три поля есть у каждой строки: правка строки главнее общего выбора, а общий выбор, сделанный после, стирает правки строк.

Статус — это ответ оператора, который у этих шаблонов уже есть. Он нужен тем, кто переезжает с готовым реестром: без него сотня согласованных текстов заведётся черновиками, то есть неправдой о ваших делах. Строкой под селекторами написано, скольким шаблонам он проставится.

Шаблон, которому файл принёс ответ оператора, сразу занимает место в лимите организации: он уже работает у оператора, а черновики места не занимают. Число таких стоит проверить до нажатия: упереться в предел на половине файла хуже, чем узнать о нём заранее.

Имя отправителя, которого нет в вашем справочнике, видно прямо в селекторе строки — «MYSHOP — не заведён». Выберите там другое имя или заведите это в «Отправителях»: без отправителя шаблон заведётся, но подать его будет нельзя — оператор принимает шаблоны только под зарегистрированным именем.

Ненужную строку снимите галочкой — она не заведётся. Таблица идёт страницами, а отборы, галочка «Выбрать все» и само применение считают по всему файлу, а не по показанной странице.

Файл со статусами: что у вас у оператора

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

Ваш ID шаблона оператору не уходит, поэтому строки из кабинета сверяются с реестром по тексту, а отправитель и тип уточняют совпадение. Со второго раза проще: номер шаблона у оператора запоминается и дальше служит прямым ключом.

В колонке «Что сделаем» у каждой строки стоит одно из:

«Поставим статус» — статус изменится.
«Допишем» — статус тот же, но файл принёс причину отказа или номер шаблона.
«Статус уже такой» — трогать нечего.
«Шаблон не найден» — текста из файла нет в вашем реестре. Такую строку стоит прочитать: либо это чужой шаблон, либо ваш, но текст с тех пор менялся.
«В файле нет статуса» — в строке нечего применять.
«Подходит нескольким — выберите» — текст совпал с несколькими вашими шаблонами. Нужный выбирается в колонке «Наш шаблон».

Наверху, в карточке файла, стоит галочка «В этом файле — все действующие шаблоны оператора». Отмечайте её только для полной выгрузки: тогда файл сверится с реестром в обратную сторону, а в отборе «Снимем» появятся шаблоны, которые у вас числятся зарегистрированными, а в файле отсутствуют. Обычно это значит, что оператор снял их сам за простой. Отмеченным проставится «Деактивирован».

Это самое дорогое согласие на экране: за ним стоит деактивация всего, чего в файле нет. По частичной выгрузке — «только отклонённые», один отправитель, один тип — галочка не предлагается вовсе.

Два предупреждения, мимо которых лучше не проходить. Если написано, что тексты в файле испорчены, — так их отдал кабинет, сменой кодировки это не чинится, выгрузите файл заново. И если узнан формат Т2: тем же файлом отвечает Ростелеком, а по содержимому они не различаются. Применив одно за другое, вы проставите статусы, которых никто не давал.

Слово из колонки статуса, которого мы не знаем, разбор не толкует, а спрашивает: карточка «Не знаем слова из колонки статуса» перечисляет их и просит сказать, что они значат у вас. Ответ запоминается за этим поставщиком, и второй раз он не спросит. Строки с неотвеченными словами не применятся — их число написано рядом.

Несколько операторов в одном файле

Если вы подаёте через поставщика SMS, весь ваш реестр приезжает одним файлом: у каждой строки свой оператор, свой статус и свой номер шаблона в системе поставщика. Такой файл разбирается по операторам сам — каждой строке достанется тот оператор, который назван в ней.

Оператора выбирать не надо — он берётся из строки, но колонку с ним и колонку с решением стоит проверить наверху: в этом файле они и есть разбор. Сводка по операторам стоит над таблицей, а работа — одной таблицей на весь файл, с теми же отборами и страницами; оператор у строки написан в ней самой. Строки, где оператор не узнан, не применяются, и их число написано рядом.

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

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

«Часть проверок не выполнялась»

Янтарная строка с этим заголовком стоит над разбором трафика и говорит, что сверка прошла не по всему вашему реестру. Раскройте её — там написано, сколько шаблонов в ней не участвовали и почему.

Причина всегда одна и та же: шаблон не удалось разобрать для сверки. Либо сломаны границы переменной — «%w{1, 5}» с пробелом внутри скобок, — либо в тексте несколько широких переменных подряд, и вариантов разбора становится слишком много. Первое правится в редакторе за минуту, второе — разведением переменных текстом.

Числа при этом сходятся, и в этом вся опасность: непокрытых сообщений показано больше, чем есть на самом деле, — часть из них ловят как раз те шаблоны, что в сверке не участвовали. Заведёте по ним новые шаблоны — получите дубли, за которые оператор берёт плату дважды.

Применение

Кнопка внизу называется по тому, что произойдёт: «Создать шаблоны» у реальных SMS и своих шаблонов, «Проставить статусы» у ответа оператора и реестра поставщика. Погашенная — объясняет причину при наведении: ничего не отмечено, нечего менять или упёрлись в лимит организации.

После применения приходит отчёт числами: сколько сообщений сохранено, сколько шаблонов заведено, сколько статусов проставлено и по каким операторам. Если ответ оператора вывел шаблоны из черновиков, это сказано отдельно — с этого мгновения они занимают место в лимите организации. Завели шаблоны — экран уводит в реестр, к ним.

Последние загрузки видно тут же, под областью для файла, а весь список — в «Журнале», отбором «Импорт». Там же лежат две кнопки у каждой строки: «Открыть разбор» и удаление.

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

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

Если что-то пошло не так

Непокрытым оказался весь файл — сначала проверьте кодировку и колонку текста наверху: нечитаемый или не тот текст не совпадёт ни с одним шаблоном.
«Шаблон не найден» у большинства строк ответа оператора — сверьте, тот ли оператор выбран и не испорчены ли тексты при выгрузке из кабинета.
Строк заметно меньше, чем в файле, — посмотрите лист книги: взят первый.
Кнопка погашена — наведите на неё курсор, причина написана подсказкой.
Файл не принимается по размеру или числу строк — разделите его на части; предел назван на самой области загрузки.

Про сам предмет — что такое шаблоны, переменные и типы трафика — есть отдельный гайд «Шаблонизация SMS: как это устроено». Как собрать шаблон руками и подать его оператору, описано в гайде «Первый шаблон: от текста до подачи».

Не нашли ответ — посмотрите соседние гайды: список на странице «Помощь».