API
API
API
API
API
API
API

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

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

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

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

Прийняти всі cookies*
*Рекомендовано для комфортного користування сайтом
Прийняти лише необхідні cookies
Прийняти лише вибрані cookies
Необхідні cookies
Соціальні мережі
Аналітика
Маркетинг

BSG переїхав на новий DevPortal
щоб швидше випускати найновіші версії One API

Використовуйте його для актуальних ендпоінтів, гайдів і журналів змін

Перейти на новий DevPortal
Документація для розробників
Number Intelligence

Надіслати SMS списку контактів

Метод дозволяє надіслати SMS списку контактів із адресної книги. Кампанія може містити персоналізовані дані з полів контакту в тексті повідомлення для кожного контакту.

Для однієї кампанії можна вказати не більше 10 000 контактів.

Limitation:

  • У режимі облікового запису DEMO створення кампанії через API недоступне.
  • У режимі платформи TEST створення кампанії можливе лише для верифікованих номерів.

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

POST https://one-api.bsg.world/api/campaigns/sms/send-groups

Request pаrаmeters:

Parameter Required Type Default Description
groups[] Yes array <int> No Масив списків контактів з адресної книги. Ідентифікатор списку контактів, яким потрібно надіслати SMS.
sender Yes string No Імʼя відправника SMS:

  • 1–11 символів для буквено-цифрового імені відправника (латинські літери, символи, цифри, пробіли)

  • 1–15 символів для числового імені відправника
text Yes string No Message text.
Щоб підставити персоналізовані дані отримувача в текст повідомлення, вкажіть ідентифікатор(и) поля(ів) контакту у форматі {field_id}.
Максимальна кількість символів у тексті повідомлення:
  • 335 символів кирилицею

  • 765 символів латиницею
validity No integer 72 Термін дії SMS у годинах.
Ціле число від 1 до 72. За замовчуванням — 72 години.
tariff_code No integer 0 Номер тарифу, за яким тарифікуються повідомлення кампанії. Можна вказати лише тариф, підключений до вашого облікового запису. Формат параметра — ціле число від 0 до 9. За замовчуванням — 0.
start_at No string now Дата й час надсилання повідомлення у форматі ISO 8601: yyyy-mm-dd hh:mm:ss. Використовується лише для планування кампаній на певний час. Максимальний термін планування — 30 днів. Якщо не вказано користувачем, встановлюється поточний час (кампанія без затримки).

Request sample:


{
  "groups": [
    1
  ],
  "sender": "string",
  "text": "string",
  "tariff_code": 0,
  "validity": 72,
  "start_at": "2025-01-25 09:00:00"
}

Response parameters:

Parameter Type Description
id integer Ідентифікатор створеної кампанії
name string Назва кампанії: генерується автоматично для створеної кампанії
sender string Sender name
status string Статус кампанії. Можливі значення:
  • creation — створено

  • spam — кампанія не пройшла модерацію

  • scheduled — кампанію заплановано

  • sending — розпочато надсилання кампанії

  • paused — кампанію призупинено

  • stopped — кампанію зупинено

  • done — кампанію завершено.
mesage_type string Тип кампанії: sms
start_at string Дата й час початку кампанії (заплановані). Формат ISO 8601: yyyy-mm-dd hh:mm:ss
real_start_at string Фактичні дата й час початку кампанії. Формат ISO 8601: yyyy-mm-dd hh:mm:ss
finished_at string Дата й час завершення кампанії. Формат ISO 8601: yyyy-mm-dd hh:mm:ss
created_at string Дата й час створення кампанії. Формат ISO 8601: yyyy-mm-dd hh:mm:ss
statistics array Campaign statistics:
delivered integer Загальна кількість доставлених повідомлень у межах кампанії
sent integer Загальна кількість надісланих повідомлень у межах кампанії

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


{
  "data": {
    "id": 1,
    "name": "string",
    "sender": "string",
    "status": "creation",
    "message_type": "sms",
    "start_at": "2021-04-27 19:44:06",
    "real_start_at": "2021-04-27 19:44:06",
    "finished_at": "2021-04-27 19:44:06",
    "created_at": "2021-04-27 19:44:06",
    "statistics": {
      "delivered": 0,
      "sent": 0
    }
  }
}

Зацікавлені у спеціальній пропозиції?

Готові розширювати можливості?
Давайте обговоримо.

Надіслати

Корисні Матеріали

WhatsApp Business API: повний гайд — налаштування, ціни, сценарії [2026]
WhatsApp Business API: повний гайд — налаштування, ціни, сценарії використання [2026]

WhatsApp Business API у 2026 — кроки налаштування, нова модель тарифікації за повідомлення та перевірені сценарії використання за галузями.

Що таке CPaaS? Повний бізнес-гайд із Communications Platform as a Service
Що таке CPaaS? Повний бізнес-гайд із Communications Platform as a Service

Що таке CPaaS? Хмарний API-шар, що додає SMS, WhatsApp, голос та OTP у ваші застосунки — як це працює і чому це краще за стек із кількох вендорів.

Один комунікаційний API для SMS, WhatsApp, Viber і RCS — чому він кращий за пʼять
Один комунікаційний API для SMS, WhatsApp, Viber та RCS — чому він кращий за пʼять

Чому один комунікаційний API для SMS, WhatsApp, Viber та RCS кращий за пʼять окремих інтеграцій — каскадний fallback, єдині звіти.