Поширені помилки WhatsApp API (надсилання) на BSG

BSG віддзеркалює помилки WhatsApp Cloud API від Meta — коли повідомлення не вдається надіслати або доставити, ми передаємо код помилки та опис від Meta напряму, без перейменування чи переінтерпретації. Коди, які ви бачите, — це коди Meta, а повний офіційний перелік наведено в документації Meta WhatsApp Cloud API error codes.

Цей посібник охоплює помилки надсилання, з якими ви найімовірніше зіткнетеся. (Щодо проблем під час підключення вашого облікового запису див. Поширені помилки Embedded Signup (онбордингу) на BSG.)

Як помилки потрапляють до вас

Код (code) та опис (description) помилки повертаються у відповіді на надсилання та у зворотних викликах доставки, і ви можете переглянути їх пізніше за допомогою Get Single Message Info (поле error_code). Meta формує повідомлення з коду та короткого заголовка — наприклад (#130429) Rate limit hit — а додаткові деталі містяться в error_data.

Швидкий спосіб сортування: rejected означає, що щось на боці запиту потребує вашої уваги (параметри, ліміт або білінг); undeliverable означає, що запит був коректним, але повідомлення не змогло досягти отримувача.

Найпоширеніші помилки надсилання

132001 — Шаблон не знайдено або не схвалено

Meta: "The template does not exist in the specified language or the template has not been approved."

Чому ви можете це бачити: неправильний name шаблону чи language.code, або шаблон ще не схвалено (чи він ще не синхронізувався з Meta в BSG).

Що робити: підтвердьте точну назву та мову за допомогою Search WhatsApp templates і переконайтеся, що шаблон має статус Approved у WhatsApp Manager.

132000 — Кількість параметрів не відповідає шаблону

Meta: "The number of variable parameter values included in the request did not match the number of variable parameters defined in the template."

Чому ви можете це бачити: ви надіслали більше або менше параметрів, ніж визначає схвалений шаблон, або в неправильному порядку.

Що робити: надсилайте саме ті параметри, які очікує шаблон, у правильному порядку. Перевірте структуру шаблону за допомогою Get WhatsApp template.

131049 — Повідомлення не доставлено (ліміт на користувача)

Meta: "This message was not delivered to maintain healthy ecosystem engagement."

Чому ви можете це бачити: Meta обмежує, скільки маркетингових повідомлень людина отримує від усіх компаній, тож частина будь-якого великого маркетингового розсилання очікувано потрапить сюди. (Пов’язане: Meta також не доставляє маркетингові шаблони на номери US (+1) — див. per-user limits.)

Що робити: на великих обсягах це очікувана поведінка, а не помилка — не повторюйте спробу одразу (зачекайте щонайменше 24 год). Використовуйте не-US номер для маркетингових тестів.

131026 — Повідомлення неможливо доставити

Meta: "Unable to deliver message." Серед причин: отримувач не є користувачем WhatsApp, не прийняв останні Умови WhatsApp або має дуже стару версію WhatsApp.

Чому ви можете це бачити: звичайний фоновий шум у будь-якому великому розсиланні.

Що робити: переконайтеся, що отримувач користується WhatsApp і що номер правильний; у самому запиті нічого змінювати не потрібно.

131042 — Спосіб оплати / білінг не налаштовано

Meta: "There was an error related to your payment method." Поширені причини: не прикріплено спосіб оплати, кредитна лінія перевищила ліміт або неактивна, або не встановлено часовий пояс/валюту.

Чому ви можете це бачити: білінг не повністю налаштовано на боці Meta — найчастіше одразу після підключення.

Що робити: у BSG ви платите Meta напряму, тож налаштуйте білінг у WhatsApp Manager → Account tools → Payment settings. Див. довідкову статтю Meta About Billing.

99 — Досягнуто балансу платформи або ліміту плану (специфічне для BSG)

Ця помилка від BSG, а не від Meta — це виняток із правила «ми віддзеркалюємо Meta». Вона означає, що ви досягли ліміту повідомлень вашого плану BSG (за замовчуванням — до 1 000) або що ваш баланс платформи вичерпано.

Що робити: поповніть баланс або зверніться до вашого менеджера облікового запису, щоб підвищити ліміт плану.

Коли помилка надсилання насправді є проблемою налаштування

Деякі помилки надсилання пов’язані з тим, як було підключено обліковий запис, а не із самим запитом — найчастіше це 131042 (білінг не налаштовано) та помилки реєстрації номера телефону. Якщо надсилання почали давати збій одразу після онбордингу, спершу перевірте своє підключення: див. Поширені помилки Embedded Signup (онбордингу) на BSG.

Де знайти всі інші помилки

Оскільки BSG віддзеркалює Meta, будь-який код, не наведений тут, визначено в документації Meta WhatsApp Cloud API error codes.

Пов’язані посібники

• Огляд BSG WhatsApp API — надсилання, статуси та обробка помилок у контексті.
• Поширені помилки Embedded Signup (онбордингу) на BSG — проблеми під час підключення вашого облікового запису.
• Початок роботи з 1-way WhatsApp на BSG — підключення облікового запису, ліміти та налаштування оплати.