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

Дані вивантаження зберігаються на сервері один місяць від дати створення запиту. Один клієнт може мати на сервері лише 5 запитаних вивантажень. Щоб створити шосте, попереднє потрібно видалити окремим методом. У запиті на формування вивантаження рядок зі значенням null дорівнює незаданому параметру, і навпаки.

Запит на вивантаження статистики

Детальна статистика повідомлень

Дані вивантаження зберігаються на сервері один місяць від дати створення запиту. Один клієнт може мати на сервері лише 5 запитаних вивантажень. Щоб створити шосте, попереднє потрібно видалити окремим методом. У запиті на формування вивантаження рядок зі значенням null дорівнює незаданому параметру, і навпаки.

Щоб вивантажити статистику, зверніться за цією URL-адресою:

POST https://api.bsg.world/rest/stat/create

Тіло запиту

Передається один із таких обовʼязкових параметрів:

  • message_id — задається як “message_id”. Якщо це значення задано, всі наступні поля ігноруються, навіть якщо в них зазначені дані. Масив. Максимум 300 значень у масиві. Якщо задано порожній масив або параметр є, але ключ не є масивом, параметр ігнорується.

АБО часовий проміжок:

  • time_in_from — дата й час, коли повідомлення надійшли на платформу.
  • time_in_to — дата й час, коли повідомлення надійшли на платформу.

Передаються необовʼязкові параметри

Параметр Тип Опис
msisdn Масив значень для зазначення номерів. Якщо задано порожній масив або параметр є, але ключ не є масивом, параметр ігнорується.
originator string Імʼя відправника.
source_type string Джерело, з якого повідомлення надійшло на платформу. Може набувати одного з таких значень: api, web, smpp, xml, http, json.
message_type string Тип повідомлення. Може набувати одного з таких значень: sms, hlr, viber.
time_sent_from Час надсилання повідомлень із платформи “від”.
time_sent_to Час надсилання повідомлень із платформи “до”.
country_name string Назва країни для пошуку.
operator_id Зазначення оператора країни, якщо присутнє поле Country_name. Якщо оператора вказано без країни, його буде проігноровано.
status string Статус повідомлень для відображення. Може набувати одного з таких значень: Delivered, Rejected, Scheduled, Moderation, Accepted, Sending, Sent, Expired, Failed, Undelivered, Unknown, Read, not-viber-user.
sl_clicks Чи потрібно враховувати кількість кліків. Поле доступне лише клієнтам з увімкненим сервісом Short URL.
sl_clicks_comp Оператор порівняння зі значенням кількості кліків. Може набувати одного з таких значень: “<”, “>”, “=”. Поле доступне лише клієнтам з увімкненим сервісом Short URL.
sl_clicks_count Значення для порівняння. Верхня межа — 999999. Поле доступне лише клієнтам з увімкненим сервісом Short URL.

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


{
   "error":0,
   "key": {}
}

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

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

Надіслати

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

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, єдині звіти.