BSG використовує HTTP-cookies (а також подібні або додаткові технології), щоб:
1) забезпечити безпечну, стабільну та доступну роботу сайту (через використання обов’язкових cookies) та
2) зрозуміти, як ви користуєтеся сайтом (через використання необов’язкових cookies) — з метою покращення вашого досвіду та надання персоналізованого контенту.

Інформація у cookie-файлах може бути пов’язана з вашими уподобаннями або пристроєм і допомагає сайту працювати так, як ви очікуєте. Зазвичай ці файли не ідентифікують вас безпосередньо, але дозволяють забезпечити більш персоналізовану взаємодію з сайтом.

Відповідно до вимог Загального регламенту про захист даних (GDPR), який регулює обробку та передачу персональних даних осіб у ЄС, ми надаємо вам можливість заборонити використання певних типів cookies під час відвідування нашого сайту.

Ознайомтеся з нашими Правилами використання cookies та Політикою конфіденційності, щоб дізнатися більше про те, як BSG збирає та використовує cookies.
Зверніть увагу, що заборона певних типів cookies може вплинути на роботу сайту та обмежити доступ до деяких сервісів. Оберіть відповідну категорію нижче, щоб дізнатися більше або вимкнути cookies.

Прийняти всі cookies*

*Рекомендовано для комфортного користування сайтом

Прийняти лише необхідні cookies

Прийняти лише вибрані cookies

Необхідні cookies

Соціальні мережі

Аналітика

Маркетинг

Надіслати SMS / 2Way SMS

Метод дозволяє надіслати SMS.

Підтримується створення одиночного SMS («destination»:»phone»), масової розсилки («destination»:»phones») та персоналізованого SMS («destination»:»individual»).

Щоб надіслати кампанію, надішліть запит на цей URL:

PUT (POST) https://api.bsg.world/rest/sms/create

Single SMS

Request parameters

Parameter	Required	Type	Description
destination	Yes	string	встановлюється значення «phone»
originator	Yes	string	відправник. Рядок довжиною до 14 символів
body	Yes	string	Текст SMS-повідомлення
msisdn	Yes	string	номер телефону, на який надсилається SMS
reference	No	string	Зовнішній ідентифікатор SMS. Рядок довжиною до 32 символів, що містить /a-zA-Z0-9/
validity	No	integer	Термін дії SMS. За замовчуванням — 72 години. Ціле число від 1 до 72
tariff	No	integer	номер тарифу. За замовчуванням — 0. Ціле число від 0 до 9
2way	No	bool	належність до 2WAY

Request sample


{
"destination":"phone", 
"msisdn": "380501234567",
"reference": "reference_id",
"originator": "sender",
"body":"test sms",
"2way": 1
}

Response parameters

Parameter	Type	Description
id	integer	ідентифікатор повідомлення — унікальний випадковий ідентифікатор, що створюється на платформі BSG під час створення обʼєкта
reference	string	Зовнішній ідентифікатор SMS
price	float	SMS price
currency	string	сurrency in which the SMS price is specified

Якщо запит виконано успішно, ви отримаєте відповідь:


{
"error":"0",
"id":"22125",
"reference":"12erdgm9",
"price":"0.02",
"currency":"EUR"
}

Масова SMS-кампанія

Масова SMS-кампанія містить один текст для всіх номерів отримувачів.

Request parameters

Parameter	Required	Type	Descripton
destination	Yes	string	встановлюється значення «phones»
phones	Yes	array	values array
msisdn	Yes	string	номер телефону, на який надсилається SMS
reference	No	string	Зовнішній ідентифікатор SMS. Рядок довжиною до 32 символів, що містить /a-zA-Z0-9/
originator	Yes	string	Імʼя відправника. Рядок довжиною до 14 символів
body	Yes	string	Текст SMS-повідомлення
validity	No	integer	Термін дії SMS. За замовчуванням — 72 години. Ціле число від 1 до 72
tariff	No	integer	номер тарифу. За замовчуванням — 0. Ціле число від 0 до 9
2way	No	bool	належність до 2WAY

Response parameters

Parameter	Type	Description
id	integer	SMS ID
reference	string	Зовнішній ідентифікатор SMS
price	float	SMS price
currency	string	сurrency in which the SMS price is specified
task_id	integer	Ідентифікатор кампанії, що генерується системою автоматично під час створення кампанії. Параметр task_id використовується для запиту статусу всієї кампанії

Якщо запит виконано успішно, ви отримаєте відповідь:

Персоналізована SMS-кампанія

Request parameters

Parameter	Required	Type	Description
destination	Yes	string	встановлюється значення «individual»
validity	No	integer	Термін дії SMS. За замовчуванням — 72 години. Ціле число від 1 до 72
tariff	No	integer	номер тарифу. За замовчуванням — 0. Ціле число від 0 до 9
2way	No	bool	належність до 2WAY
phones	Yes	array	values array
msisdn	Yes	string	номер телефону, на який надсилається SMS
reference	No	string	Зовнішній ідентифікатор SMS. Рядок довжиною до 32 символів, що містить /a-zA-Z0-9/
originator	Yes	string	Імʼя відправника. Рядок довжиною до 14 символів
body	Yes	string	Текст SMS-повідомлення

Request sample


{
"destination":"phones", 
"phones":[
{"msisdn": "380972000001","reference":"12erdgm9"},
{"msisdn": "380972000002","reference":"12erdgn0"}
],
"originator":"test",
"body":"test sms", 
"validity": 72,
"tariff":9
}

Response parameters

Parameter	Type	Description
id	integer	SMS ID
reference	string	Зовнішній ідентифікатор SMS
price	float	SMS price
currency	string	сurrency in which the SMS price is specified
total price	float	загальна вартість кампанії.
currency	string	сurrency in which the camapign price is specified

Якщо запит виконано успішно, ви отримаєте відповідь:


{
"result":
[
{"reference":"12erdgm9",
"id":"12345",
"error":"0",
"price":"0.02",
"currency":"EUR"},
{"reference":"12erdgn0",
"id":"12346",
"error":"0",
"price":"0.02",
"currency":"EUR"}
],
"error":"0", 
"task_id":"21902"
}