Рассылка SMS через GSM-шлюзы

Управление обработкой распределено по трём вкладкам. На вкладке «Сообщение» вводится текст SMS, на вкладке «Получатели» формируется список получателей этого сообщения. Вкладка «Настройка» используется для выбора шлюза отправки сообщений и настройки дополнительных параметров рассылки.
 

Настройка обработки

Основные параметры обработки находятся на вкладке «Настройка».

• Шлюз. GSM-шлюз, через который будет осуществляться рассылка.
• Логин. Имя пользователя GSM-шлюза. Если у вас его нет, зарегистрируйтесь на сайте выбранного шлюза.
• Пароль. Пароль пользователя GSM-шлюза.

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

Помимо перечисленных настроек, на этой вкладке содержатся два дополнительных поля:

• Отправитель. Определяет имя автора SMS, которое отображается на экране мобильного телефона получателя. Следует понимать, что значение этой настройки, скорее всего, потребует первоначального одобрения администрацией шлюза на сайте сервиса.

• Отправлять срочные сообщения (flash SMS) вместо обычных? Позволяет вместо обычных SMS посылать так называемые «Flash SMS» — сообщения, которые сразу появляются на экране телефона и, в большинстве случаев, не сохраняются в памяти устройства.

Все данные вкладки «Настройка» автоматически сохраняются и восстанавливаются при открытии обработки. Вместе с тем, вы можете пользоваться стандартным функционалом сохранения и восстановления значений настроек, который доступен в меню «Все действия» формы.

Список получателей

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

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

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

При заполнении списка вручную заполнять колонку «Получатель» необязательно: она носит исключительно информативный характер и никак не влияет на процесс формирования сообщений.

Отправка сообщения

После ввода списка получателей следует перейти на вкладку «Сообщение», ввести его текст и выполнить команду «Отправить сообщение».

Состояние отправки выводится стандартными сообщениями. При возникновении какой-либо ошибки (например, недостатке средств на счету для отправки очередного сообщения) процесс остановится и программа сообщит о возникшей проблеме.

Программный интерфейс

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

Точки входа для отправки сообщений:

• ОтправитьРассылкуЧерезGateSMS( Рассылка )
• ОтправитьРассылкуЧерезSMSC( Рассылка )

В качестве параметра в обоих случаях выступает структура со следующими элементами:

• ЛогинШлюза (строка; имя пользователя GSM-шлюза)
• ПарольШлюза (строка; пароль пользователя GSM-шлюза)
• ИмяОтправителя (строка; имя автора SMS)
• ТелефонПолучателя (строка; один или несколько телефонов через запятую)
• ТекстСообщения (строка; содержимое SMS)
• Срочное (булево; определяет необходимость посылать Flash-SMS вместо обычных SMS)
• ЗапросСтоимости (булево; определяет, нужно ли запросить стоимость рассылки вместо собственно рассылки)

В качестве результата в обеих случаях возвращается структура. Обязательные элементы:

• Успешно (булево; индикатор успешного завершения операции)
• Сообщение (строка; текст ошибки, если она возникла)

Если операция успешна, структура ответа дополняется. В случаяе запроса стоимости появляются элементы:

• КоличествоСообщений (строка; количество SMS, которые будут посланы в ходе этой рассылки)
• СтоимостьРассылки (строка; стоимость рассылки в валюте сервиса)

Если запроса стоимости не было (то есть, была выполнена обычная рассылка) к структуре ответа добавляется параметр БалансШлюза (строка), который содержит баланс GSM-шлюза на момент завершения рассылки.

Пример рассылки:

    Рассылка = Новый Структура;
    
    Рассылка.Вставить( "ЛогинШлюза"         , "МойЛогин" );
    Рассылка.Вставить( "ПарольШлюза"        , "МойПароль" );
    Рассылка.Вставить( "ИмяОтправителя"     , "МойПсевдоним" );
    Рассылка.Вставить( "ТелефонПолучателя"  , "79133100000" );
    Рассылка.Вставить( "ТекстСообщения"     , "Привет, мир!" );
    Рассылка.Вставить( "Срочное"            , Ложь );
    Рассылка.Вставить( "ЗапросСтоимости"    , Ложь );

    Результат = Обработки.РассылкаSMS.Создать().ОтправитьРассылкуЧерезSMSC( Запрос );
    
    Если Результат.Успешно Тогда
        Сообщить( "Баланс: " + Результат.БалансШлюза );
    Иначе
        Сообщить( Результат.Сообщение );
    КонецЕсли;

Пример оценки стоимости:

    Рассылка = Новый Структура;
    
    Рассылка.Вставить( "ЛогинШлюза"         , "МойЛогин" );
    Рассылка.Вставить( "ПарольШлюза"        , "МойПароль" );
    Рассылка.Вставить( "ИмяОтправителя"     , "МойПсевдоним" );
    Рассылка.Вставить( "ТелефонПолучателя"  , "79133100000" );
    Рассылка.Вставить( "ТекстСообщения"     , "Привет, мир!" );
    Рассылка.Вставить( "Срочное"            , Ложь );
    Рассылка.Вставить( "ЗапросСтоимости"    , Истина);

    Результат = Обработки.РассылкаSMS.Создать().ОтправитьРассылкуЧерезSMSC( Запрос );
    
    Если Результат.Успешно Тогда
        Сообщить( "Количество сообщений: " + Результат.КоличествоСообщений );
        Сообщить( "Стоимость отправки: " + Результат.СтоимостьРассылки );
    Иначе
        Сообщить( Результат.Сообщение );<
    КонецЕсли;

Точки входа для определения баланса на GSM-шлюзах:

• ОпределитьБалансНаGateSMS( Запрос )
• ОпределитьБалансНаSMSC( Запрос )

В качестве параметра в обеих случаях выступает структура со следующими элементами:

• ЛогинШлюза (строка; имя пользователя GSM-шлюза)
• ПарольШлюза (строка; пароль пользователя GSM-шлюза)

В качестве результата в обеих случаях возвращается структура. Обязательные элементы:

• Успешно (булево; индикатор успешного завершения операции)
• Сообщение (строка; текст ошибки, если она возникла)

Если операция успешна, к структуре добавляется элемент БалансШлюза (строка), который содержит текущий баланс GSM-шлюза.

Пример определения баланса:

    Рассылка = Новый Структура;
    
    Рассылка.Вставить( "ЛогинШлюза"         , "МойЛогин" );
    Рассылка.Вставить( "ПарольШлюза"        , "МойПароль" );

    Результат = Обработки.РассылкаSMS.Создать().ОпределитьБалансНаGateSMS( Запрос );
    
    Если Результат.Успешно Тогда
        Сообщить( "Баланс: " + Результат.БалансШлюза );
    Иначе
        Сообщить( Результат.Сообщение );
    КонецЕсли;