СМС Дисконт: SMS рассылка и СМС оповещения

Руководство для пользователей

Шаг 1. Установка модуля на сайт.

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

Шаг 2. Настройки модуля.

Для получения логина и пароля необходимо пройти регистрацию на сайте https://iqsms.ru/
Доступы поступят на телефон и электронную почту.

После установки необходимо задать настройки подключения к сервису а также указать шаблоны которые необходимо использовать при тех или иных событиях. Чтобы найти модуль в административном разделе сайта, необходимо перейти в раздел Сервисы / СМС Дисконт.

Далее переходим в подпункт Настройки модуля. И указываем соответствующие настройки. В самом низу в блоке настройки подключения указываем свои логин и пароль для входа на сайт iqsms.ru и нажимаем кнопку применить. После чего появятся варианты подписей отправителей, и вы сможете выбрать один из вариантов, после чего обязательно нажимаем кнопку применить чтобы сохранились настройки. Помимо настроек подключения можно задать шаблоны сообщений которые будут отправляться при смене статуса заказа, при оформлении заказа. Для того чтобы сообщения отправляли, нужно выбрать обязательно поле, в котором хранится номер телефона покупателя.

Шаг 3. Шаблоны смс.

В подпункте шаблоны смс можно изменить предустановленные шаблоны сообщения или добавить новые. Помимо шаблонов смс которые отправляются при наступлении отслеживаемых событий, таких как регистрация пользователя, оформления заказа можно задать шаблоны сообщений, которые будут автоматически отправляться при наступлении почтовых событий ( Административный раздел/ Настройки / Настройки продукта / Почтовые события /Типы почтовых событий) . Такие шаблоны в списке помечаются как «Для почтового события».

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

Поле номер получателя заполняется либо номером телефона, например 79991112233 либо конструкцией #PHONE# которая будет заменена автоматически на номер пользователя.

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

Из примера выше, покупатель получит сообщение с текстом например «ваш заказ 5». В модуле уже отслеживается события добавления нового заказа и есть соответствующий шаблон, поэтому новый привязанный к почтовому событию делать не нужно. Эта функция может быть нужна например для оповещения при заполнении формы обратной связи и моментального реагирования ответственного лица.

Шаг 4. Отправленные сообщения.

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

Шаг 5. Отправка сообщений

Чтобы отправить сообщение, необходимо перейти в соответствующий раздел модуля – «Отправить сообщение». На странице есть несколько блоков интуитивно понятных.

Слева вводите текст сообщения также можно подгрузить шаблон сообщения и заменить конструкции вида #ORDER_ID#, #NAME# и тп. на соответствующие значения, так как они автоматически НЕ ЗАМЕНЯЮТСЯ при ручной отправке, так как данные отсутствуют.

Справа в блоке нужно указать номера получателей сообщения ( сообщения будет для всех получателей одинаковым).

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

После выбора ограничений необходимо нажать кнопку найти номера, будет автоматически произведен поиск номеров, которые будут подставлены в поле получателей.

Руководство для разработчиков

1) После установки модуля на сайт, для работы с ним, расширения функционала, решения каких-то задач связанных с отправкой смс, вы можете использовать API модуля. Помимо этого руководства, для понимания, вам нужно также ознакомиться с руководством для пользователей.

Отправить смс можно в любом месте сайта, используя код в пару строк.

\Bitrix\Main\Loader::includeModule('iqsms.sender');

$oManager = \Iqsms\Sender\Manager::getInstance();

$oManager->send('79991112233', 'Текст сообщения');

У метода send есть дополнительные парамтеры:

1. Идентификатор сайта для использования настроек конкретного сайта (при многосайтовости) по умолчанию используются настройки текущего сайта.

2. Расписание отправки, то есть передается объект класса \BItrix\Main\Type\DateTime() с установленным временем отправления

3 Имя отправителя, по умолчанию берется имя отправителя из настроек модуля для текущего сайта.

2) Отправка смс по шаблону

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

Для отправки как обычного шаблона так и с привязанных к почтовым событиям существуют методы sendTemplate и sendTemplateEmail

$oManager->sendTemplate('NEW_ORDER', array(

'PHONE' => '79991112233',
'NAME' => 'Евгений',
'PRICE' => '2000'
));

$oManager->sendTemplateEmail('NEW_ORDER', array(
'PHONE' => '79991112233',
'NAME' => 'Евгений',
'PRICE' => '2000'
));

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

Первым параметром передается код шаблона (для шаблонов с привязкой к почтовым событиям, код шаблона = коду типа почтового события). Вторым параметром передается массив c данными. Исходя из примеров выше, в тексте шаблона конструкции #PHONE#, #NAME#, #PRICE# будут заменены на значения из переданных данных.

Также можно передать остальные входные параметры как для метода send – идентификатор сайта, время отправки и имя отправителя.

Результатом этих трех методов является объект класса \Iqsms\Sender\Result, используя методы которого можно узнать как прошла отправка.

$result = $oManager->send('79991112233', 'Текст сообщения');
if($result->isSuccess())
{
// сообщение отправлено
$status = $result->getResult();
$smsID = $result->getMore('id');
}
else
{
/**
* @var $error \Iqsms\Sender\Error
*/
foreach($result->getErrors() as $error)
{
echo $error->getCode() .': ' . $error->getMessage();
}

// или

echo '<pre>';
print_r($result->getErrorMessages());
echo '</pre>';
}

В переменной $status установлено

$oManager::SMS_STATUS_SENT = 1; //отправлено
$oManager::SMS_STATUS_DELIVERED = 2; //доставлено
$oManager:: SMS_STATUS_ERROR = 3; //ошибка
$oManager::SMS_STATUS_WAIT = 4; //ожидание отправки

Код модуля имеет достаточное количество комментариев для того чтобы разобраться более детально.

За поддержкой можно обращаться по контактам:
8 (812) 640-07-66 Санкт-Петербург
8 (495) 640-07-66 Москва
8 (343) 384-41-81 Екатеринбург
8 (831) 429-04-26 Нижний Новгород
8 (800) 700-99-10 звонок из регионов России бесплатно.
e-mail: info@conversite.ru