Отправка СМС через МЕГАФОН по https для корпоративных клиентов

Обмен - SMS рассылки

Рассылка SMS через оператора МЕГАФОН.

Предыстория.

Понадобилось как-то сделать рассылку sms. И случилось так, что корпоративной связью оказался Мегафон. Что может быть проще, подумал я. Ведь в БСП есть модуль рассылки sms. Но не все оказалось так радостно. Так как в БСП не оказалось сервиса Мегафона. И конфигурацию изменять не разрешили, чтобы дописать его туда.

Поиск готового решения не принес результатов. Так как готовые решения были реализованы на внешний компонентах или на ActiveX. И вызывали сомнения в своей работоспособности.

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

Выбор пал на http, так как рассылка предполагалась разовая, иногда персональная. SMPP подразумевает более оперативную рассылку с большим количеством сообщений. И к тому же это легко реализуется через HTTPСоединение.

После заключения доп. соглашения, Мегафон прислал данные для авторизации и инструкцию, описывающую API своего сервиса.

Описание подключения.

Сервис рассылки у Мегафона располагается на сервере https://a2p-api.megalabs.ru/ адрес ресурса /sms/v1/sms, запросы посылаются в нотации JSON, кодировка UTF-8.

В заголовке передаются авторизационные данные в формате login:pass закодированные Base64. Например, cG8nbX54dGAyqx==.

Обязательное требование - авторизация проходит только с заявленного IP.

Описание запросов.

Запрос отправляется методом POST.

{
	"from": "Johnny_Viper",
	"to": 79001234212,
	"message": "Это тест",
	"callback_url": "http://www.sombodyserver.ru/sms_callback"
}

Параметры:

from - имя отправителя. Тип строка. Обязательный параметр. Имя отправителя может содержать латинские буквы в разных регистрах, цифры, пробелы, а так же спецсимволы: '!"#$%()*+,-./:;<=>?@[\]^_`{|}~. Длина имени отправителя не должна превышать 11 символов, с учетом пробелов. Имя отправителя не может начинаться с одного или нескольких пробелов и/или заканчиваться одним или несколькими пробелами.

to - номер телефона. Тип число. Обязательный параметр. Из-за этого не получится отправить одно сообщение на несколько номеров. Т.е. один запрос - один номер.

message - собственно текст сообщения. Тип строка от 1 до 1000 символов.

callback_url - URL адрес вашей службы, для отправки уведомлений о статусе сообщения. Не обязательный параметр.

msg_id - УИД сообщения. Тип строка от 1 до 16 символов. Не обязательный параметр. По этому идентификатору можно получить состояние сообщения. Получил его абонент или нет. А так же сервис по этому номер понимает что сообщение с таким УИД уже отправлялось и не допускает дублей.

Реализация.

Для запроса нам понадобятся заголовки и тело запроса в нотации JSON.

Заголовки выглядят так:

Заголовоки = Новый Соответствие;
Заголовоки.Вставить("Authorization", "Basic " + ЛогинИПарольЗашифрованныйBase64);
Заголовоки.Вставить("Content-Type", "application/json; charset=utf-8");

Далее формируем запрос:

НТТРЗапрос = Новый HTTPЗапрос("/sms/v1/sms", Заголовоки);
НТТРЗапрос.УстановитьТелоИзСтроки(ТелоЗапроса);

Тело запроса формируем примерно так:

ЗаписьJSON = Новый ЗаписьJSON;
	
ЗаписьJSON.ПроверятьСтруктуру = Ложь;

ПараметрыЗаписиJSON = Новый ПараметрыЗаписиJSON;
	
ИмяФайлаОтвета = ПутьКФайлуОтвета;
	
ЗаписьJSON.УстановитьСтроку(ПараметрыЗаписиJSON);
	
ЗаписьJSON.ЗаписатьНачалоОбъекта();
	
ЗаписьJSON.ЗаписатьИмяСвойства("from");	
ЗаписьJSON.ЗаписатьЗначение(Отправитель);
	
ЗаписьJSON.ЗаписатьИмяСвойства("to");
ЗаписьJSON.ЗаписатьЗначение(Номер);
	
ЗаписьJSON.ЗаписатьИмяСвойства("message");
ЗаписьJSON.ЗаписатьЗначение(Сообщение);
	
ЗаписьJSON.ЗаписатьИмяСвойства("callback_url");
ЗаписьJSON.ЗаписатьЗначение("http://www.sombodyserver.ru/sms_callback");
	
УИДСообщения = СтрЗаменить(Прав(Строка(Новый УникальныйИдентификатор), 17), "-", "");
	
ЗаписьJSON.ЗаписатьИмяСвойства("msg_id");
ЗаписьJSON.ЗаписатьЗначение(УИДСообщения);

ЗаписьJSON.ЗаписатьКонецОбъекта();
ТелоЗапроса = ЗаписьJSON.Закрыть();

Устанавливаем соединение и отправляем запрос.

Попытка
   Соединение = Новый HTTPСоединение("a2p-api.megalabs.ru", , , , ПолучениеФайловИзИнтернетаКлиентСервер.ПолучитьПрокси("http"), 60, Новый ЗащищенноеСоединениеOpenSSL);
   Соединение.ОтправитьДляОбработки(НТТРЗапрос, ИмяФайлаОтвета);
Исключение
   //ОписаниеОшибки();
КонецПопытки;

Для отправки сообщений этого хватит.

В обработке-примере реализован механизм рассылки по сотрудникам организации. Обработка должна работать в конфигурациях ERP 2, ЗУП 3, КА 2.

Тестировалась на ЕРП - 2.2.4.67.

P.S.: Если статья окажется полезной, у меня не единичный случай применения данной рассылки. Я сделаю описание службы, которая принимает состояние сообщения. И описание встраивания данного функционала в БСП.

В обработке настройки включаются сочетанием клавиш Ctrl+Shift+P.

Скачать файлы

Наименование Файл Версия Размер
Отправка СМС через МЕГАФОН по https для корпоративных клиентов.:
.epf 17,60Kb
21.09.17
9
.epf 1.0 17,60Kb 9 Скачать

См. также

Комментарии
1. Павел Толкачев (ltfriend) 258 25.09.17 13:11 Сейчас в теме
1. Имя пользователя и пароль можно передать в параметрах конструктора HTTPСоединение в место заголовков. Ну тут на любителя.
2. Для такой простой структуры JSON я бы сразу формировал строку без всяких ЗаписьJSON. Кода меньше и проще. Ну опять же на любителя.
3. Зачем нужны все эти "ИмяФайлаОтвета" когда есть объект HTTPОтвет?
2. Николай Захаров (Захаров_Николай) 8 25.09.17 13:52 Сейчас в теме
Согласен, можно все задать строкой.
Это писалось на скорую руку, вслепую, так как авторизованного IP у меня не было.
Файл ответа нужен для отладки.
4. Александр (user669425_potolitsyn) 19.10.17 13:41 Сейчас в теме
Сделал отправку SMS по вашей статье, взлетало только так:
НТТРЗапрос.УстановитьТелоИзСтроки(ТелоЗапроса,,ИспользованиеByteOrderMark.НеИспользовать);
5. Николай Захаров (Захаров_Николай) 8 19.10.17 14:14 Сейчас в теме
(4) А запрос как формировали? Не в блокноте?
6. Александр (user669425_potolitsyn) 19.10.17 14:32 Сейчас в теме
Нет, точно как у Вас ЗаписьJSON, также строкой пробовал, результат одинаков. С дополнением работает в обоих вариантах.
7. Николай Захаров (Захаров_Николай) 8 20.10.17 09:05 Сейчас в теме
(6) По умолчанию этот параметр стоит в состоянии Авто. Следовательно можно предположить, что используются системные настройки.
В документации нет четкого указания используется BOM (Маркер последовательности байтов) или нет.
Все взаимодействие происходит в кодировке UTF-8.

Из этого можно сделать вывод что либо у меня по умолчанию стоит кодировка без BOM (как у большинства у кого тестировался механизм), либо у вас с BOM.
То что вы обнаружили этот момент это очень хорошо. Возможно будет кому-то полезно.
Оставьте свое сообщение