Модуль SMS уведомлений для Netcat

Простая в работе и управлении CMS NetCat не прихотлива к хостингу и имеет бесплатную тех поддержку. Для облегчения взаимодействия с клиентом сервис PIR.Company разработал бесплатный модуль для рассылки СМС уведомлений.

Установка модуля СМС рассылки

Для начала работы с установленным модулем SMS уведомлений от PIR.Company необходимо скачать бесплатный модуль на сайте CMS NetCat, затем зарегистрироваться на нашем сайте, и получить права доступа в личный кабинет (https://netcat.pir.company/ru/cabinet.html)
Стоимость смс с именем отправителя тарифицируется — 2,4 руб за одно сообщение.
Для использования в смс уникального имени отправителя необходимо согласование с вашим менеджером сервиса ПИР (ссылка https://pir.company/contacts/).

Описание модуля СМС рассылки

Модуль предназначен для ;SMS уведомлений администраторов и покупателей сайта о статусе заказов.

Обрабатываемые события:
• Новый заказ
• Оплата заказа
• Отмена заказа
• Изменение статуса заказа

SMS-уведомления, формируются по настраиваемым шаблонам отдельно для пользователей магазина и администратора.

Модуль покрывает большинство редакций NetCat, а не только Business (и старшие), в которых присутствует функционал интернет-магазина. Текущая реализация модуля позволяет реализовать смс-рассылку для любых редакций в которых есть компонент «Заказа».

Единственная проблема заключается в том, что если это не Business+ редакция, то интегрировать с кастомным каталогом товаров и кастомной разработкой для хранения заказанных продуктов (и их цен) сложная и проблематичная задача, поэтому для младших редакций с кастомными компонентами заказа в смс-рассылках НЕ отсылается список заказанных продуктов, отсылается лишь базовая информация: номер заказа, информация по клиенту, статус заказа.

Начальная настройка модуля смс рассылки

Доступ к настройкам модуля можно получить перейдя в меню Настройка — PIR.Company: SMS уведомления. Откроется главный экран настроек.

Вам необходимо задать все настройки, чтобы модуль начал функционировать.

SMSGATE_CATALOGUE_ID — ID сайта магазина

SMSGATE_ORDER_SUB_ID — ID раздела с заказами

SMSGATE_ORDER_COMPONENT_ID — ID компонента с заказами

SMSGATE_CLIENT_FIO_FIELD_NAME — наименование поля с именем клиента

SMSGATE_CLIENT_PHONE_FIELD_NAME — наименование поля с телефоном клиента

SMSGATE_CLIENT_EMAIL_FIELD_NAME — наименование поля с e-mail-ом клиента

SMSGATE_CLIENT_ADDRESS_FIELD_NAME — наименование поля с адресом доставки клиенту

SMSGATE_ORDER_STATUS_FIELD_NAME — наименование поля со статусами в компоненте заказов

SMSGATE_ORDER_PAYED_STATUS_NAME — значение поля статус для оплаченного заказа

SMSGATE_CANCELED_STATUS_NAME — значение поля статус для отмененного заказа

SMSGATE_PRODUCT_NAME_FIELD_NAME — наименование поля с наименованием продукта в инфоблоке каталога (продукции)

SMSGATE_PIR_SERVER_NAME — адрес сервера для отправки XML запросов (https://netcat.pir.company/xml/)

SMSGATE_PIR_USERNAME — логин полученный при регистрации

SMSGATE_PIR_PASSWORD — пароль полученный при регистрации

SMSGATE_PIR_SENDER_NAME — имя отправителя (уточняйте у своего менеджера)

SMSGATE_ADMIN_PHONE — телефон администратора в формате 79101234567

Настройки уведомлений

После основных настроек пользователь щелкает на ссылку сверху (вкладку) PIR.Company: SMS-уведомления и попадает на экран непосредственных настроек SMS рассылок.

Там идут шаблоны смс. Для каждого типа события по два шаблона на каждый (шаблон для админа и шаблон для пользователя). Каждый шаблон имеет чекбокс, по клику на который пользователь может либо включить его, либо отключить. SMS рассылка происходит только по включенным (активным) шаблонам.

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

Разрешенные к использованию переменные в шаблоне:

%PIR_SHOP_NAME% — наименование магазина из настроек CMS

%PIR_ORDER_ID% -ID заказа

%PIR_STATUS% — статус заказа

%PIR_CLIENT_NAME% — имя клиента

%PIR_CLIENT_PHONE% — телефон клиента

%PIR_CLIENT_EMAIL% — E-mail клиента

%PIR_CLIENT_ADDRESS% — Адрес клиента

%PIR_ORDERED_PRODUCTS% — заказанные товары. Только для редакций Business и старше.

Таким образом, если у пользователя Business+ редакция и он хочет в смс рассылку включить список продуктов заказанных пользователем, он просто пишет в шаблоне в нужном месте

%PIR_ORDERED_PRODUCTS% — система это понимает и при отсылке смс подставит в это место список товаров в формате:

Наименование товара 1 — Кол-во Шт. — Стоимость

…

Наименование товара N — Кол-во Шт. — Стоимость

Итого: общая стоимость заказа

После настроек шаблонов пользователь сохраняет все сделанное им и система готова к работе.

Дополнительные функции

Кроме всего прочего модуль ведет лог внутри своей папки на сервере всех отосланных на сервер данных в формате XMLи полученных от сервера на этот запрос ответов, с указанием точной даты и времени и типа события.

После полной настройки модуля можно реализовать отправку SMS сообщений из любого места в системе. Для того, чтобы иметь возможность отослать на тот или иной номер SMS сообщение с произвольным текстом, осуществите вызов функции pir_send_sms, принимающей два параметра: мобильный номер адресата и текст в произвольном формате. Пример использования функции (которую можно вызывать в макетах дизайна, шаблонах компонента и в ваших собственных обработчиках и пр. модулях системы NetCat) ниже:

<?php 

pir_send_sms  (  «79871233222»,  «Текст, который будет отправлен в sms на номер в первом параметре.»); 

?>