Алина Леонова
12.04.2020
303808

Отправка SMS-уведомлений с помощью сервиса RED SMS

Часто различные компании используют SMS-рассылки (например, для рассылки каких-либо рекламных акций или SMS-уведомлений о пропущенных вызовах). С технической точки зрения это можно устроить различными способами. Один из них – SMS-рассылка с помощью специальных сервисов. В данной статье рассмотрим возможность SMS-рассылки с помощью сервиса RED SMS. Немного о сервисе RED SMS – многофункциональный сервис рассылки. Одна из его функций […]

Часто различные компании используют SMS-рассылки (например, для рассылки каких-либо рекламных акций или SMS-уведомлений о пропущенных вызовах). С технической точки зрения это можно устроить различными способами. Один из них – SMS-рассылка с помощью специальных сервисов.

В данной статье рассмотрим возможность SMS-рассылки с помощью сервиса RED SMS.

Немного о сервисе

RED SMS – многофункциональный сервис рассылки. Одна из его функций – SMS-рассылка. Интегрироваться с ним можно тремя способами: по SMPP, HTTP API и 1С.

Интеграция с данным сервисом будет проходить по HTTP API. 

Для начала перейдём на сайт сервиса и зарегистрируемся на нём. Сделать это можно здесь.

 Форма регистрации RED SMS
Форма регистрации RED SMS

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

Интеграция

Документацию от разработчика по интеграции с сервисом по API можно найти тут.

Для интеграции потребуется API-ключ.

Генерируется он в настройках профиля.

 Генерация API-ключа
Генерация API-ключа

После генерации ключа не забываем сохранить изменения.

Теперь нам потребуются необходимые файлы для интеграции. Исходный код класса для взаимодействия с данным сервисом можно найти по ссылке.

Тестирование функционала проводилось на php 5.6. Для других версий php могут потребоваться отдельные доработки.

Создадим файл (в примере sendsms.php), в котором пропишем:

<?php

require ‘RedsmsApiSimple.php’;

$login = ‘логин от личного кабинета RED SMS’;

$api_key = ‘ранее сгенерированный api-ключ’;

$from = 89998887766;

$api = new \Redsms\RedsmsApiSimple($login, $api_key);

$uuid = »;

try{

echo «RED SMS. Отправка SMS-сообщения: \n»;

$res = $api->SendSMS($from, ‘Текст сообщения’, ‘Имя отправителя’);

if (!empty($res[‘items’])) {

$mess = $res[‘items’];

foreach ($mess as $message) {

echo $message[‘to’] . ‘-‘ . $message[‘uuid’] . «-» . $message[‘status’] . «\n»;

$uuid = $message[‘uuid’];

}

}

if ($uuid) {

echo «Статус: \n»;

$info = json_encode($api->messageInfo($uuid));

echo «$info \n»;

echo «Пожалуйста, подождите 10 секунд… \n»;

sleep(10);

$info = json_encode($api->messageInfo($uuid));

echo «$info \n»;

}

} catch (\Exception $e) {

echo «Ошибка » . $e->getCode() . «: » . $e->getMessage() . «\n»;

}

echo «Успешно! \n»;

?>

Теперь подробно рассмотрим, что делает скрипт.  В самом начале подключаем файл RedsmsApiSimple.php, в котором описан класс работы с сервисом. Затем производим объявление переменных $login и $api_key — для прохождения авторизации на сервисе, $from – номер, на который будет происходить отправка сообщения. В $api записываем новый экземпляр класса RedsmsApiSimple. В его конструктор передаём переменные $login и $api_key. Также объявляем переменную $uuid, которую пока что оставляем пустой – в неё при отправке сообщений будет писаться идентификатор сообщения.

Далее производим отправку сообщения. В переменной $res передаём в SendSMS, описанный в классе RedsmsApiSimple, 3 значения – номер, на который будем посылать сообщение, текст сообщения и имя отправителя.

В тестовом аккаунте имя отправителя и текст сообщения определяются сервисом RED SMS.

После этого нам вернётся результат запроса в виде массива. Проверяем его на пустоту, и, если он не пустой, выводим отладочную информацию (в примере это номер получателя, uuid сообщения и статус).

Затем по uuid получаем информацию о сообщении.

 Информация о сообщении
Информация о сообщении

Пример работы

Реализуем с помощью сервиса отправку уведомлений о пропущенных вызовах.

Для того чтобы показать пример работы данного сервиса в связке с Asterisk, введём в скрипт 2 переменные: $cid = $argv[1] и $did = $argv[2]. В них передаём номер звонящего и внутренний номер, на который поступает звонок. В качестве текста сообщения передаём: «Пропущен вызов от номера $cid».  Также введём условие, в котором будем проверять $did на равенство нужному внутреннему номеру.

Далее переходим в конфигурационный файл диалплана.

При использовании FreePBX потребуется файл extensions_override_freepbx.conf.

Здесь перепишем контекст ext-local следующим образом:

exten => h,1,NoOp(Sms sender)

same  => n,GotoIf($[«${CDR(disposition)}» != «ANSWERED»]?start:end)

same => n(start),System(/usr/bin/php -f /var/www/html/redsms/sendsms.php ${CALLERID(num)} ${EXTTOCALL})

same => n(end),GoTo(macro-hangupcall,s,1)

 Пример работы
Пример работы

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

  Детализация
Детализация

На этом данная статья завершена.

Подписаться
Уведомить о
guest
0 комментариев
Межтекстовые Отзывы
Посмотреть все комментарии

Остались вопросы?

Я - Виталий Шелест, менеджер компании Voxlink. Хотите уточнить детали или готовы оставить заявку? Укажите номер телефона, я перезвоню в течение 3-х секунд.

VoIP оборудование


ближайшие курсы

10 доводов в пользу Asterisk

Распространяется бесплатно.

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

Безопасен в использовании.

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

Надежен в эксплуатации.

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

Гибкий в настройке.

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

Имеет огромный функционал.

Во многом именно Asterisk показал какой должна быть современная телефонная станция. За многие годы развития функциональность Asterisk расширилась, а все основные возможности по-прежнему доступны бесплатно сразу после установки.

Интегрируется с любыми системами.

То, что Asterisk не умеет сам, он позволяет реализовать за счет интеграции. Это могут быть интеграции с коммерческими телефонными станциями, CRM, ERP системами, биллингом, сервисами колл-трекинга, колл-бэка и модулями статистики и аналитики.

Позволяет телефонизировать офис за считанные часы.

В нашей практике были проекты, реализованные за один рабочий день. Это значит, что утром к нам обращался клиент, а уже через несколько часов он пользовался новой IP-АТС. Безусловно, такая скорость редкость, ведь АТС – инструмент зарабатывания денег для многих компаний и спешка во внедрении не уместна. Но в случае острой необходимости Asterisk готов к быстрому старту.

Отличная масштабируемость.

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

Повышает управляемость бизнеса.

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

Снижает расходы на связь.

Связь между внутренними абонентами IP-АТС бесплатна всегда, независимо от их географического расположения. Также к Asterisk можно подключить любых операторов телефонии, в том числе GSM сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.