Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

--- smszilla [2018/02/27 04:10]
+++ smszilla [2022/09/24 14:39]
127.0.0.1 зовнішнє редагування
@@ Рядок 1: / Рядок 1: @@
+====== SMSZilla ======
+Появилась начиная с релиза Ubilling 0.8.8 и предназначена для <del>фигурного спама</del> рассылки SMS в каких угодно направлениях. А именно пользователям интернета, пользователям [[ukv|КТВ]], сотрудникам и спискам номеров (считаем потенциальным клиентам или кому угодно). В общем текст и адресаты ваших SMS ограничиваются только вашей фантазией.
+{{:smszilla0.png?|}}
+====== Включение ======
+Для работы SMSZilla требуется включенная, настроенная и работающая [[senddog|собака-посылака]] а также включенная соответствующая опция в конфиге [[alteriniconf|alter.ini]]:
+<code ini>
+; Включена ли SMSZilla?
+SMSZILLA_ENABLED=1
+; Необязательная опция. Устанавливает длину номера в международном формате с учетом кода страны, кода оператора, номера абонента и без символа +.
+; Для стран отличных от Украины, берем полный мобильный номер, в международном формате E.164 и считаем на пальцах, сколько там циферок.
+;SMSZILLA_MOBILE_LEN=12
+; Необязательная опция. Устанавливает код страны получателя без символа +. Если вы не уверены в какой стране живете, либо какой у
+; нее международный телефонный код, можете свериться со списком https://en.wikipedia.org/wiki/List_of_mobile_telephone_prefixes_by_country
+;SMSZILLA_COUNTRY_CODE="380"
+</code>
+====== Использование ======
+Для начала нам потребуется создать шаблон рассылаемого сообщения, при этом мы можем использовать соответствующие [[templating#smszilla|макросы]]. Естественно, что для разных направлений SMS они работают по разному в силу специфики самих сущностей из которых извлекаются номера для рассылки.
+Пускай наш шаблон, будет выглядеть примерно так:
+{{:smszilla1.png?600|}}
+Далее нам следует решить, кому мы будем рассылать сообщения с этим шаблоном. Для этого потребуется создать фильтр. Пускай это будут активные пользователи которым может не хватить денег на следующий месяц (типа ласково намекаем), с их дополнительными мобилками (может какие-то из старых основных уже не актуальны?).
+Для этого создаем фильтр с направлением SMS "Интернет" приблизительно такого вида:
+{{:smszilla2.png?|}}
+После чего, приступаем непосредственно к рассылке. Выбираем требуемый шаблон, затем фильтр, отмечаем галочки про визуализацию фильтров (если требуется оценить, как они отрабатывают и сколько "сущностей" после них остается), опционально транслит (может сильно сэкономить денег) и наблюдаем предварительный результат:
+{{:smszilla3.png?600|}}
+Как не сложно заметить, состояние всех селекторов и чекбоксов сохраняется, и если нас все устраивает, мы можем включить чекбокс "Выполнить реальную рассылку" для помещения SMS идентичных тем, что в окне "предварительный просмотр" в общую системную очередь, для последующей рассылки [[senddog|собакой-посылакой]]. В общем надеемся суть понятна - выбрали шаблон, выбрали фильтр - разослали в три клика.
+====== Фильтры ======
+Фильтры работают по методу исключения. То есть каждый последующий, фильтр если он задействован либо имеет не пустой параметр исключает из общего массива сущностей, каждую конкретную сущность которая ему не соответствует. Да, "сущности" это то, что является одиночными объектами соответствующим выбранному для фильтра "направлению SMS", а именно "пользователи интернета", "пользователи КТВ", "сотрудники" либо каждая конкретная запись в заданном "списке номеров". Собственно визуализация работы фильтров требуется для наглядного понимания, сколько и чего остается после фильтрации. В последствии для уже отфильтрованных сущностей запускается процедура извлечения номеров которая тоже зависит от выбранного направления. Следует также заметить, что фильтр "Использовать дополнительные мобилки" на прямую никак не влияет на количество отфильтрованных сущностей - это нормально. В силу специфики своей реализации он влияет только на количество извлеченных номеров что можно увидеть на информационной панели в поле "номеров извлечено". Также на этапе извлечения номеров, из них будут удалены номера из "исключений". Он один общий для всех. Данная трехступенчатая схема позволяет хоть поздравить пользователей КТВ с именинами с фильтром по имени, хоть разослать ныне активным сотрудникам напоминание о корпоративе, хоть уведомить жителей конкретной улицы/дома о авариях или проводимых работах в их локации.
+Список доступных фильтров постоянно расширяется и позволяет таргетировать ваши рассылки все более гибко.
+{{:smszilla5.png?|}}
+====== Списки номеров ======
+Для рассылок по номерам, не являющимся вашими абонентами, это может быть как-то полученная вами база "потенциальных клиентов" ;) так и скажем список номеров ЖЕК-ов или ОСББ или собственно что угодно. Для начала требуется создать сам "список номеров"
+{{:smszilla4.png?|}}
+После чего добавить поштучно либо залить в него номера в виде готового файла. Поддерживаемый формат файлов: CSV с разделителем ";". В первой колонке всегда должен быть номер телефона, все последующие - будут рассматриваться как примечания. Пример:
+<file csv numbers.csv>
++380501234567;Крюгер Федор Петрович;Вязов 1428
++380937654321;Вурхис Джейсон Иванович;Хрустальное озеро
+</file>
+Собственно это позволит в последствии, создав фильтр с направлением "Список номеров" разослать ваше чудесное предложение пользователям с примечанием, содержащим "Вязов".
+====== Вызов из RemoteAPI ======
+На случай, если вам потребуется фоновая рассылка, в автоматическом режиме, начиная с релиза 0.9.1 вы можете воспользоваться соответствующим вызовом из [[remoteapi|RemoteAPI]]. С параметрами там все максимально просто:
+  * filterid - ID существующего фильтра по которому будет производиться рассылка
+  * templateid - ID существующего шаблона, который будет использован для рассылки
+  * translit - опциональный параметр, включающий принудительную транслитерацию рассылаемых SMS
+Пример использования из стандартной обертки:
+<code bash>
+$ ubapi "smszilla&filterid=61&templateid=10&translit=1"
+</code>

Ubilling Wiki

Користувальницькькі налаштування

Налаштування сайту

Розбіжності

Налаштування сторінки