Помощь

Для создания новой SMS-рассылки перейдите на страницу "Создать новую рассылку".


Заполните обязательное (*) поле "Название SMS-рассылки". Это поле служит для удобства отображения ваших SMS-рассылок и не рассылается вместе с SMS-сообением.


Заполните обязательное (*) поле "Текст сообщения". Именно этот текст будет разослан в виде SMS-сообщения.


Чтобы вручную ввести номера телефонов получателей SMS-сообщений, воспользуйтесь полями блока "Укажите номера телефонов".



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


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




После заполнения файла, убедитесь, что все заполненные вами ячейки соответствуют "Цифровому" или "Текстовому" формату. Обратите внимание, что при правильном заполнении файла цифры в ячейке таблицы и в "строке формулы" должны совпадать. Если это не так, то возможно у вас не верно задан формат ячеек или внесены данные.
Соответственно, SMS-сообщения будут отправлены только на те номера телефонов которые корректно записаны в сформированном вами .xls-файле.


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


Если вы попытаетесь прикрепить файл другого формата, то получите сообщение о неправильном формате прикрепленного файла.


Если вы хотите отправить ваше SMS-сообщение в определенный день или время, то укажите эти данные в поле для даты и времени соответственно.


Для отправки SMS-рассылки нажмите кнопку "Сохранить рассылку".

Для просмотра своих созданных SMS-рассылок перейдите на страницу "Отправленные рассылки".


В таблице приведены данные о созданных Вами SMS-рассылках:





  • Альфа-номер - номер или альфа-имя отправителя, который отобразится у получателя Вашего SMS-сообщения.
  • Название рассылки - название, которое вы присвоили своей рассылке.
  • Текст сообщения - текст отправленного Вами сообщения.
  • Дата и время отправки - дата и время отправки SMS-сообщения (время отправки Вашего SMS-сообщения и время получения этого SMS-сообщения получателем иногда может не совпадать, например, из-за большого количества абонентских номеров в вашей рассылке, загруженности телекоммуникационных сетей или загруженности сервера отправки SMS-сообщений).
  • Кол-во телефонов - количество номеров телефонов в этой конкретной SMS-рассылке.
  • Кол-во SMS - количество SMS-сообщений отправленных на один телефонный номер в данной SMS-рассылке.
  • Статус рассылки - состояние в котором сейчас находится Ваша SMS-рассылка.
  • Телефоны - список номеров телефонов в данной SMS-рассылке и дифференцированный статус доставки SMS-сообщений для них.
  • Удаление - кнопка для удаления SMS-рассылки, ее возможно использовать, если сразу же после создания данной SMS-рассылки вы поняли, что совершили ошибку и хотите ее отменить (это возможно, если сервер SMS-рассыки еще не начал выполнять вашу SMS-рассылку).

Для просмотра детализации SMS-рассылки перейдите по ссылке "Список телефонов".


В таблице приведены данные детализации выбранной SMS-рассылки:





Сохранить данные рассылки - скачать и сохранить файл с данными о SMS-рассылке.
Номера телефонов - список всех номеров телефонов в данной рассылке.
Статус рассылки - статус для конкретного SMS-сообщения:

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

API для создания пользовательских WEB-приложений

Переменные обязательны для заполнения (для php):

  • $login - логин пользователя на портале sms.beltelecom.by
  • $pass - пароль пользователя на портале sms.beltelecom.by
  • $header - заголовок SMS-рассылки
  • $text - текст SMS-рассылки
  • $telefon - телефон(-ы) SMS-рассылки


Максимальный текст SMS-рассылки не должнен превышать 201 символ.

Превышающие ограничения cимволы будут обрезаны.

Каждый текст будет разбиваться на несколько SMS-сообщений.

В каждом SMS-сообщении 67 символов.

Дата и время отправки сообщения будет соответствовать дате и времени создания.

Формат телефонов : 375ххууууууу, при рассылке нескольких телефонов, они должны перечисляться через запятую.
Пример: "375ххууууууу,375ххууууууу,375ххууууууу,375ххууууууу,375ххууууууу"


Получение результата

После отправки запроса, абонент получает результат формата: 

{"state_author":" ","state_sms":" ","id_sms": }

,где:

  • state_author - состояние аутентификации
    • -1: пустой логин
    • -2: пустой пароль
    • -3: данные корректны
    • -4: не верный логин\пароль
    • -5: пользователь заблокирован
  • state_sms - состояние рассылки
    • -1: пустой заголовок
    • -2: пустой текст
    • -3: пустые телефоны
    • -4: данные корректны
    • -5: сервер недоступен
  • id_sms - результат запроса
    • -1: рассылка не сохранилась
    • -(id): id сохраненной рассылки


PHP-скрипт для отправки SMS-сообщения

                    
                        <?
                        // Входные данные 
                            $login='';
                            $pass='';
                            $header="";
                            $text="";
                            $telefon="";
    
                            $data = array('login'=>$login,
                                    'password'=>$pass,
                                    'header'=>$header,
                                    'text'=>$text,
                                    'number'=>$telefon
                                    ); 
                            
                        $text = json_encode($data);         
                        $url = "https://sms.beltelecom.by/sites/all/modules/api_sms/xml.php"; 
                        $ch = curl_init($url);  // инициализирует сеанс
                        // curl_setopt установка параметров для сеанса
                        curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
                        curl_setopt($ch, CURLOPT_HEADER, 0);
                        curl_setopt($ch, CURLOPT_HTTPHEADER, array(
                                                                'Content-Type: application/json' ,
                                                                'Content-Length: ' . strlen($text)));
                        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
                        curl_setopt($ch, CURLOPT_POSTFIELDS, $text);
                        $return = curl_exec($ch)."<br/>";
                        echo $return; 
                        curl_close($ch);  
                        ?>
                      
                    

Python-скрипт для отправки SMS-сообщения

                    
                        import requests
                        import json

                        url = "https://sms.beltelecom.by/sites/all/modules/api_sms/xml.php"
                        data = {
                            "login": "Your_login",
                            "password": "Your_password",
                            "header": "Test Python script for API",
                            "text": "Test Python script for API",
                            "number": "Your_phone_number",
                        }
                        headers = {
                            'Content-Type': 'application/json',
                        }


                        def send_sms(url=url, data=data, headers=headers):
                            r = requests.post(
                                url,
                                data=json.dumps(data),
                                headers=headers
                            )
                            print(r.text)


                        if __name__ == '__main__':
                            send_sms()
                      
                    

JavaScript-скрипт для отправки SMS-сообщения

                    
                        const body = {
                            login: 'Your_login',
                            password: 'Your_password',
                            header: 'Test JS script for API',
                            text: 'Test JS script for API',
                            number: 'Your_phone_number'
                        };

                        fetch('https://sms.beltelecom.by/sites/all/modules/api_sms/xml.php', {
                            method: 'POST',
                            body: JSON.stringify(body),
                            headers: {
                                'Content-Type': 'application/json',
                            }
                        })
                            .then(response => response.json())
                            .then(json => {
                                console.log(json);
                            });
                      
                    

Шаблоны - гибкий механизм рассылки, ориентированный на создание более персонализированных SMS-сообщений в одной "Массовой SMS-рассылке" путем создания каркаса (текста, который не будет изменяться) с расставленными в нем "указателями подстановки" - %1, %2, %3, %4, %5 - вместо которых будет подставляться уникальная для каждого получателя информация: текст или цифры.

Для создания шаблона перейдите на страницу "Создать Шаблон".

В поле "Название шаблона" укажите название для создаваемого вами шаблона.

Поле "Шаблон сообщения" заполните вашим шаблоном.

Для указания места, куда надо будет вставить персонализированную информацию при рассылке используйте "указатели подстановки" - %1, %2, %3, %4, %5. В шаблоне допускается от 1 до 5 подстановок.

Возможный пример шаблона:

Уважаемый %1 %2 %3, ваша задолженность %4 %5

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


Ваш шаблон будет сохранен и отобразится на экране.

Созданные ранее Вами шаблоны можно редактировать или удалять.


Для просмотра доступных Вам шаблонов перейдите на страницу "Список шаблонов".


Теперь Вам необходимо создать .xls-файл ("файл с данными") в котором будет храниться персонализированная информация для SMS-рассылки по шаблону.
Пример .xls-файла с тестовыми данными.

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

Номер телефона, на который будет отправляться SMS-сообщение должен быть записан в ячейке "A".

Информация для первой подстановки (%1) должна быть записана в ячейке "B".

Информация для второй подстановки (%2) должна быть записана в ячейке "C".

Информация для третьей подстановки (%3) должна быть записана в ячейке "D".

Информация для четвертой подстановки (%4) должна быть записана в ячейке "E".

Информация для пятой подстановки (%5) должна быть записана в ячейке "F".

Общая длина итогового SMS-сообщения, как и при создании SMS-рассылки без шаблона, не должна превышать 335 символов.

Созданный вами .xls-файл ("файл с данными") должен содержать более одной записи для рассылки, т.е. 2 и более строк. Максимальное их количество не ограничено.


Чтобы создать новую SMS-рассылку с помощью шаблона перейдите на страницу "Создать рассылку по шаблону". В поле "Шаблоны" найдите требуемый шаблон. Далее загрузите файл с данными для этой рассылки. Если необходимо отложить рассылку, укажите время и дату в соответствующих полях. После этого нажмите кнопку "Сохранить". Рассылка будет создана и отправлена на указанные номера.


Итогом приведенной выше тестовой SMS-рассылки, созданной с помощью "шаблона о задолженности" и .xls-файла с тестовыми данными будет отправка трех SMS-сообщений на три разных номера.


Проконтролировать доставку созданных Вами SMS-рассылок и получить другую полезную информацию можно на странице "Рассылки по шаблону".