Для создания новой 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-рассылок и получить другую полезную информацию можно на странице "Рассылки по шаблону".
