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

API Viber дозволяє надсилати повідомлення в месенджер Viber, а також надсилати SMS як альтернативу, якщо повідомлення не було доставлене в месенджер.

Надіслати Viber-повідомлення

Метод дозволяє надсилати повідомлення Viber. У повідомлення можна додати зображення, заголовок і кнопку CTA.
Також цей метод дозволяє вказати опцію переадресації (каскадування) повідомлення через SMS із зазначенням SMS Alpha-імені та його тексту.

Щоб надіслати Viber-повідомлення, надішліть запит на цей URL:

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

Request parameters:

Parameter Mandatory Type Description
validity No string Термін дії Viber-повідомлення в секундах (за замовчуванням — 24 години). Ціле число від 15 до 86400.
tariff No integer Номер тарифу. За замовчуванням — 0. Ціле число від 0 до 9.
messages Масив обʼєктів повідомлень. Містить 1 і більше обʼєктів такої структури:
to Масив отримувачів:
msisdn Yes string Номер телефону, на який надсилається повідомлення.
reference No string Зовнішній ідентифікатор повідомлення. Рядок довжиною до 32 символів, що містить /a-zA-Z0-9/.
text Yes string Текст Viber-повідомлення.
alpha_name Yes string Відправник. Рядок довжиною до 14 символів.
is_promotional Yes boolean Ознака того, чи є повідомлення рекламним чи транзакційним.
options Додаткові параметри для додавання зображення, заголовка та кнопки.
img No string Image URL.
caption No string Button name.
action No string Button URL.
scheduledDatetime No string Час надсилання Viber-повідомлення (для планування кампаній).
alt_route No Додаткові параметри для переадресації Viber-повідомлення через SMS. Ці параметри вказуються, лише якщо потрібно забезпечити альтернативну доставку повідомлень у разі недоставлення в месенджер
originator Yes Sender
text Yes Message text

Request example:


{
    "tariff": 9,
    "validity": 24,
    "messages": [
        {
            "to": [
                {
                    "msisdn": "380972920283",
                    "external_id": "example_12"
                },
                {
                    "msisdn": "380972920282",
                    "external_id": "example_13"
                }
            ],
            "text": "My Viber messages are shinier than your SMS messages",
            "alpha_name": "My Company",
            "is_promotional": false,
            "options": {
                "viber": {
                    "img": "http://my-cool-webpage.com/logo.png",
                    "caption": "Join us!",
                    "action": "http://my-cool-webpage.com"
                    "alt_route": {
                       "originator": "testsms",
                       "text": "SMS message will be received if you are not a VIBER user."

                }
            },
            "scheduledDatetime": "ISO 8601 date"
        }
    ]
}

Response parameters:

Parameter Type Description
messages містить вкладені дані:
id integer Message ID
reference string Зовнішній ідентифікатор Viber-повідомлення
price float Message cost
currency string Валюта облікового запису, у якій вказано вартість повідомлення в кампанії Viber

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


[
    {
        "error": "0",
        "messages": [
            {
                "id": "22125",
                "reference": "example_12",
                "price": "0.02",
                "currency": "EUR"
            },
            {
                "id": "22126",
                "price": "0.02",
                "currency": "EUR"
            }
        ]
    }
]

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

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

Надіслати

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

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