Основной формат для загрузки и получения списка пользователей - CSV.
Кодировка CSV файлов - UTF-8.
Символ перевода строки - \n (LF, \x0A).
Следующие параметры CSV формата берутся из настроек проекта:
символ разделения между столбцами (по умолчнию: ; (точка с запятой))
символ ограничения полей (по умолчанию не выставлен, если необходим - рекомендуется: " (двойная ковычка))
символ экранированя спецсимволов (по умолчанию не выставлен)
Первой строкой файле должен быть заголовок с названиями всех полей передаваемых в шаблон.
Файл должен называться латиницей.
Обязательными полем является email (либо phone или uid в зависимости от типа рассылки).
Название файла guys.csv
email;nickname;level
foo@mail.ru;Шерлок Холмс;80
bar@gmail.com;Доктор Ватсон;42
В данном примере письма будет оправлено по адресам foo@mail.ru и bar@gmail.com.
В теле письма у foo@mail.ru директива {{ nickname }} будет заменена на значение Шерлок Холмс, а {{ level }} на 80
Внимание! Если у проекта выставлен символ ограничения полей, данные не должны содержать этот спец символ, либо данные необходимо экранировать.
Иначе возможны следующие ситуации:
email;nickname;
one@mail.ru;"ВасяПро
two@gmail.com;ЖекаЗло"
three@ya.ru;ГенаТру
В данном примере будет отравленно не три письма, а два. Так как, в первом письме поле {{ nickname }} будет выглядеть
как ВасяПроtwo@gmail.com;ЖекаЗло