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

Одиночне SMS

Параметри запиту

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

Приклад запиту


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

Параметри відповіді

Параметр	Тип	Опис
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-кампанія містить один текст для всіх номерів отримувачів.

Параметри запиту

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

Параметри відповіді

Параметр	Тип	Опис
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-кампанія

Параметри запиту

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

Приклад запиту


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

Параметри відповіді

Параметр	Тип	Опис
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"
}