Необхідні cookies
Соціальні мережі
Аналітика
Маркетинг
Документація для розробників
RCS
SMS / 2Way SMS API
Viber API
Number Intelligence
Контакти
Відправники
Списки
Стоп-листи
Статистика
Помилки API
BSG використовує стандартні коди статусів HTTP, щоб позначати успіх або невдачу API-запиту.
У відповідь на API-запит ви можете отримати повідомлення про помилку, яке вказує, що щось не так із вашим запитом або на нашому боці.
У разі помилки тіло відповіді містить відповідь у форматі json, яка точно повідомляє, що саме не так.
Приклад:
{"error":"40","errorDescription":"Message not found"}
Помилки API 1.0
Загальні помилки
| 0 | немає помилки |
|---|---|
| 1 | недійсний ключ |
| 2 | користувача заблоковано |
| 3 | недостатньо параметрів |
| 4 | запитувана функція не підтримується |
| 5 | невідома помилка |
| 6 | вказано номер неіснуючої тарифної сітки |
| 7 | недійсні параметри |
| 8 | недостатньо коштів |
| 9 | тарифна сітка неактивна |
| 10 | недійсний час надсилання |
| 11 | перевищено максимальну кількість повідомлень, що одночасно обробляються для надсилання |
| 12 | перевищено максимальний розмір пакета повідомлень |
Помилки SMS
| 20 | SMS не знайдено |
|---|---|
| 21 | недійсний номер телефону |
| 22 | відсутній зовнішній ID SMS-запиту |
| 23 | SMS з таким ID вже існує |
| 24 | недійсне тіло запиту |
| 25 | недійсний originator |
| 26 | текст SMS порожній або задовгий |
| 27 | Недійсний зовнішній ID SMS |
| 28 | недійсне значення часу життя SMS |
| 29 | недійсний ID завдання |
| 30 | завдання не знайдено |
| 31 | телефон уже є в списку розсилки |
| 32 | відправник не дозволений |
| 33 | напрямок не дозволений |
| 34 | неправильний OTP, помилка генерації коду |
| 35 | 2way не активовано для акаунта |
| 36 | неправильний відправник 2way |
Помилки Viber
| 40 | Viber-повідомлення не знайдено |
|---|---|
| 41 | недійсний номер телефону |
| 43 | Viber-повідомлення з таким ID вже існує |
| 44 | недійсне тіло запиту |
| 45 | Відправника не зареєстровано |
| 46 | порожній або задовгий текст Viber-повідомлення |
| 47 | недійсний зовнішній ID Viber-повідомлення |
| 48 | недійсне значення часу життя Viber-повідомлення |
| 49 | недійсні додаткові опції Viber-повідомлень |
| 51 | номер телефону вже додано до кампанії |
Помилки Number Verifier
| 60 | запит Number Verifier не знайдено |
|---|---|
| 61 | недійсний номер телефону |
| 62 | відсутній зовнішній ID запиту Number Verifier |
| 63 | запит Number Verifier з таким ID вже існує |
| 64 | недійсне тіло запиту |
| 65 | недійсний зовнішній ID запиту Number Verifier |
| 66 | номер телефону вже є в запиті |
Помилки запитів на формування статистики
| 80 | недійсний message_id (нечислове значення) |
|---|---|
| 81 | недійсний message_type |
| 82 | недійсний source_type |
| 83 | недійсний status |
| 84 | недійсний country_id |
| 85 | недійсний clicks_comp |
| 86 | недійсний часовий діапазон |
| 87 | недійсний msisdn |
| 88-89 | зарезервовано для майбутнього використання |
Помилки запитів файлів статистики
| 90 | Файл не знайдено |
|---|---|
| 91 | Файл не готовий |
| 92 | Досягнуто максимальної кількості файлів |
| 93 | Файл порожній |
Помилки API 2.0
Помилки контактів і списків
| Недійсний формат номера телефону | |
|---|---|
| Контакт не знайдено | |
| Номер телефону вже існує в адресній книзі користувача | |
| Перевищено кількість доступних полів | |
| Недійсний формат поля контакту | |
| Недійсний формат поля дати | |
| Недійсний формат числового поля | |
| Поле з такою назвою вже існує | |
| Група контактів з такою назвою вже існує | |
| Недійсний список контактів | |
| Групу контактів не знайдено | |
| Недійсна група контактів | |
| Заблокований контакт не знайдено | |
| Кампанію не знайдено | |
| Дія недоступна для цього типу акаунта | |
| Поле не знайдено | |
| Недійсний оператор для пошуку контактів | |
| Недійсний формат значення пошуку |
Помилки SMS
| Недоступно для статусу вашого акаунта | |
|---|---|
| Тариф не знайдено | |
| Недійсний формат номера телефону | |
| Недійсний список номерів телефонів | |
| Усі номери в стоп-листі | |
| Групу контактів не знайдено | |
| Порожні групи | |
| Кампанію не знайдено | |
| Недійсний статус кампанії |
Помилки відправника
|
| Вказано недійсну країну |
|---|---|
| Реєстрація імені не дозволена для вказаної країни |
Помилки тарифів
| Тариф не знайдено | |
|---|---|
| Оператора не знайдено | |
| Ціну оператора не знайдено |
Зацікавлені у спеціальній пропозиції?
Готові розширювати можливості?
Давайте обговоримо.
Надіслати
Корисні Матеріали
![WhatsApp Business API: повний гайд — налаштування, ціни, сценарії [2026]](/assets/img/blog/whatsapp-business-api-setup-pricing-use-cases-guide_avatar.jpg){kind=avatar}
WhatsApp Business API: повний гайд — налаштування, ціни, сценарії використання [2026]
WhatsApp Business API у 2026 — кроки налаштування, нова модель тарифікації за повідомлення та перевірені сценарії використання за галузями.
Що таке CPaaS? Повний бізнес-гайд із Communications Platform as a Service
Що таке CPaaS? Хмарний API-шар, що додає SMS, WhatsApp, голос та OTP у ваші застосунки — як це працює і чому це краще за стек із кількох вендорів.
Один комунікаційний API для SMS, WhatsApp, Viber та RCS — чому він кращий за пʼять
Чому один комунікаційний API для SMS, WhatsApp, Viber та RCS кращий за пʼять окремих інтеграцій — каскадний fallback, єдині звіти.