Як роз'язати проблеми з надсиланням повідомлень у чат-ботах Instagram і Facebook
Якщо чат-бот Instagram або Facebook не може доставити повідомлення, Meta повертає помилку з кодом і коротким описом. SendPulse показує цю помилку у звіті про розсилку, у списку одержувачів елемента ланцюжка і в самому чаті.
Якщо ви зіткнулися з помилками підключення або маршрутизації розмов, наприклад, (#190) Access Token Error або (#200) Permission Error, дивіться статтю Як роз'язати проблеми з підключенням чат-ботів Instagram і Facebook.
Розглянемо, як знайти код помилки і що робити з кожним типом помилки.
Знайдіть код помилки
Meta повертає повідомлення про помилки мовою вашого акаунта, тому формулювання може відрізнятися від англійського в цій статті. Щоб знайти свою помилку, шукайте її код у дужках, наприклад, (#10). Якщо Meta також повертає підкод, використовуйте його, щоб уточнити результат.
Повідомлення про помилку можна побачити в таких місцях:
- звіт про розсилку — поруч із кожним одержувачем, який не отримав повідомлення;
- статистика ланцюжка — у списку одержувачів елемента, який не вдалося надіслати;
- сам чат — поруч із недоставленим повідомленням.
Повідомлення за межами стандартного вікна повідомлень
Чат-бот може надсилати повідомлення лише поки відкрито стандартне вікно повідомлень Meta. Щоразу, коли підписник пише вам, натискає кнопку, реагує на повідомлення або коментує вашу публікацію, вікно відкривається на 24 години.
Якщо підписник написав вам із реклами з переходом у листування, вікно триває до 7 днів.
Чат-боти Facebook можуть надіслати повідомлення за межами вікна за допомогою тега повідомлення. Однак теги працюють лише для певних цілей, схвалених Meta. Докладніше у статті Типи розсилок чат-бота Facebook.
Чат-боти Instagram можуть надіслати повідомлення за межами вікна лише з тегом HUMAN_AGENT. Він дає змогу учаснику команди відповісти протягом 7 днів з моменту останнього повідомлення підписника.
З 27 квітня 2026 року Meta повертає код помилки 100 для повідомлень із тегами CONFIRMED_EVENT_UPDATE, ACCOUNT_UPDATE і POST_PURCHASE_UPDATE. Докладніше в документації Meta.
За межами вікна повідомлень Meta повертає такі помилки:
| Проблема | Причина | Що робити |
|---|---|---|
|
Instagram: Facebook: |
Стандартне вікно повідомлень закрилося, тому що підписник не взаємодіяв із чат-ботом останні 24 години. | Зачекайте, поки підписник знову взаємодіє з чат-ботом, а потім надішліть повідомлення. Якщо Meta дозволяє, використовуйте тег повідомлення. |
Facebook: (#613) Warning! You are engaging in behavior that may be considered bothersome or abusive by users. You must significantly decrease the rate at which you are sending messages using message tags to this person. Subcode 2018338. |
Ви надто часто надсилаєте цьому підписнику повідомлення з тегами. | Надсилайте цьому підписнику менше повідомлень із тегами. Інакше Meta може обмежити вашу сторінку. |
Підписники, які не можуть отримувати повідомлення
Ці помилки спричинені діями або налаштуваннями підписника, тому виправити їх у SendPulse не можна. Meta повертає їх, коли підписник блокує вашу сторінку Facebook або акаунт Instagram, видаляє свій акаунт або обмежує коло тих, хто може йому писати.
| Проблема | Причина | Що робити |
|---|---|---|
|
Facebook: Також повертається як:
|
Підписник заблокував вашу сторінку, деактивував акаунт Facebook або недоступний з іншої причини. | Жодних дій не потрібно. Ви не можете писати цьому підписнику, поки він знову не звернеться до вас. |
|
Facebook: Instagram: |
Meta більше не розпізнає ID підписника, наприклад, тому що підписник видалив свій акаунт. | Жодних дій не потрібно. Повідомлення цьому підписнику не можуть бути доставлені. |
Instagram: (#9010) No matching Instagram user. |
Meta не змогла знайти профіль Instagram підписника в момент підписки. | Жодних дій не потрібно. |
Instagram: User consent is required to access the user profile. Code 230. |
Користувач прокоментував вашу публікацію або історію, але не написав вам. Meta не передає його профіль, поки він цього не зробить. | Надішліть приватну відповідь на коментар. Щойно користувач відповість, відкриється стандартне вікно повідомлень. |
Instagram: The conversation was deleted or archived. Code 100. |
Підписник видалив листування з вами в Instagram. | Жодних дій не потрібно. |
Помилки приватної відповіді
Ланцюжок із тригером Коментар до публікації (Comment on your post), Коментар у прямому ефірі (Comment on your live video) або Коментар до публікації (Comment on a post) надсилає перше повідомлення як приватну відповідь на коментар.
Meta дозволяє одну приватну відповідь на коментар протягом 7 днів з моменту коментаря. На коментарі у прямому ефірі можна відповісти лише під час трансляції.
В Instagram відповідь потрапляє в папку «Вхідні» користувача або в «Запити», якщо користувач не підписаний на вас. Докладніше в документації Meta для Instagram і Facebook.
Коли приватна відповідь неможлива, Meta повертає такі помилки:
| Проблема | Причина | Що робити |
|---|---|---|
Instagram: (#100) The comment is invalid for a private reply. Subcode 2534025. |
Meta не дозволяє приватну відповідь на цей коментар. Коментар видалено, він старший за 7 днів або залишений у прямому ефірі після трансляції. | Жодних дій не потрібно. |
Facebook: (#10903) This user cant reply to this activity. Subcode 1893049. |
Meta не дозволяє приватну відповідь на цей коментар, наприклад, тому що його залишила інша сторінка Facebook. | Жодних дій не потрібно. |
Facebook: (#100) Invalid parameter. Subcode 1893060. |
Коментар більше не існує або не може отримати приватну відповідь. | Жодних дій не потрібно. |
|
Facebook: Instagram: помилка про те, що на коментар уже є відповідь. |
Meta дозволяє одну приватну відповідь на коментар, а в цього коментаря вона вже є — з вашого ланцюжка або зі вхідних Instagram чи Facebook. | Жодних дій не потрібно. Ви можете продовжити листування після того, як користувач відповість на ваше повідомлення. |
Обмеження і ліміти
Meta обмежує акаунт або сторінку, які порушують її Правила обміну повідомленнями, надто часто виконують одну й ту саму дію або перевищують ліміти запитів. Наведені помилки означають, що обмеження на боці Meta:
| Проблема | Причина | Що робити |
|---|---|---|
Facebook: (#10) You are temporarily restricted from sending messages. Subcode 1893063. |
Meta тимчасово обмежила вашу сторінку за активність, яка не відповідає її Правилам обміну повідомленнями. | Перевірте деталі обмеження і оскаржте його, як описано у статті Поширені причини блокування сторінки Facebook. Надсилайте менше автоматичних повідомлень, поки діє обмеження. |
Facebook: (#2022) The ability to send commerce messages has been temporarily disabled. This is the result of a feature limit placed after a policy violation. |
Meta встановила обмеження функції на вашу сторінку після порушення правил, наприклад, після того, як користувачі поскаржилися на ваші повідомлення. | Перевірте нещодавні повідомлення на порушення і оскаржте обмеження. Докладніше у статті Поширені причини блокування сторінки Facebook. |
Instagram і Facebook: (#368) Temporarily blocked for policies violations. |
Meta тимчасово заблокувала дію як неприпустиму, наприклад, тому що чат-бот надіслав багато однакових повідомлень за короткий час. | Призупиніть надсилання на деякий час і не повторюйте одну й ту саму дію багато разів поспіль. Якщо обмеження зберігається, перевірте статус акаунта в застосунку Instagram або порушення сторінки у Facebook. |
Instagram: Links in messages are blocked. Code 508, subcode 2534122. |
Meta блокує посилання в повідомленнях із вашого акаунта, зазвичай після підозри у спамі або обмеження. | Видаліть посилання з повідомлення і перевірте статус акаунта в застосунку Instagram. |
|
Також повертається як:
|
За короткий час у Meta надіслано надто багато запитів, наприклад, під час великої розсилки. | Зачекайте і надішліть повідомлення пізніше. |
Помилки контенту і вкладень
Ці помилки означають, що Meta відхилила контент повідомлення. Виправте елемент у ланцюжку або розсилці і надішліть повідомлення знову:
| Проблема | Причина | Що робити |
|---|---|---|
Facebook: Button template without buttons. Code 100, subcode 2018397. |
Повідомлення надіслано як шаблон із кнопками, але в ньому немає кнопок. | Додайте в повідомлення хоча б одну кнопку або видаліть порожні кнопки. |
Invalid URL. Code 100. |
У кнопці або текстовому посиланні вказано недійсний URL, наприклад, без https:// або з пробілами. | Виправте посилання. |
Text is too long. |
Текст повідомлення, зокрема значення змінних, перевищує ліміт Meta: 1 000 символів для Instagram і 2 000 для Facebook. | Скоротіть текст або розділіть його на кілька повідомлень. |
(#100) Upload attachment failure. A common way to trigger this error is that the provided media type does not match type of file provided int the URL. Subcode 2018047. |
Тип файлу не відповідає типу вкладення, наприклад, відеофайл прикріплено як зображення. | Перевірте, що тип файлу відповідає типу вкладення, і прикріпіть файл знову. |
(#100) Attachment size exceeds allowable limit. Subcode 2018109. |
Файл більший за ліміт Meta: 8 МБ для зображень і 25 МБ для аудіо, відео і файлів. | Стисніть файл або прикріпіть файл меншого розміру. |
|
Також повертається як:
|
Meta не змогла вчасно завантажити файл за посиланням (75 секунд для відео) або відео пошкоджено. | Використовуйте пряме https-посилання на файл, доступний без входу в систему, або завантажте відео знову. |
Meta підтримує такі вкладення:
- Instagram: зображення до 8 МБ (png, jpeg); аудіо (aac, m4a, wav, mp4), відео (mp4, ogg, avi, mov, webm) і pdf-файли до 25 МБ;
- Facebook: зображення до 8 МБ; аудіо, відео і файли до 25 МБ.
Докладніше в документації Meta.
Маршрутизація розмов
Маршрутизація розмов у налаштуваннях Meta визначає, який застосунок отримує розмови з вашою сторінкою або акаунтом Instagram і відповідає на них. Meta замінила Handover Protocol на Conversation Routing.
Якщо застосунком за замовчуванням є інший застосунок, чат-бот може не отримувати повідомлення, зокрема з реклами та за посиланнями. Якщо застосунок за замовчуванням не задано, чат-бот не може перехоплювати розмови в інших застосунків, і Meta повертає помилку (#27) Request thread control not supported when Conversation Routing is not enabled.
Коли чат-бот надсилає повідомлення в розмові, якою керує інший застосунок, Meta повертає помилку: (#10) The message failed to send because another app controls the conversation. Чат-боти Instagram отримують помилку: (#100) The action is invalid because your app is not the thread owner.
Призначте SendPulse застосунком за замовчуванням
Призначити застосунок за замовчуванням можна в Meta Business Suite або в налаштуваннях сторінки Facebook. Якщо акаунт Instagram не пов’язаний зі сторінкою Facebook, використовуйте Meta Business Suite.
У Meta Business Suite перейдіть у Налаштування > Інтеграції > Маршрутизація розмов і виберіть свою сторінку Facebook або акаунт Instagram. На вкладці Маршрутизація натисніть Налаштувати і виберіть SendPulse Inst-IG.

На вкладці Застосунки партнерів натисніть Керувати поруч із SendPulse.

Увімкніть усі дозволи.

Перевірте дозволи підключеного застосунку
Якщо потрібний дозвіл вимкнено або інший застосунок перехоплює ваші розмови, чат-бот може не отримувати або не надсилати повідомлення.
Щоб перевірити дозволи, перейдіть у Налаштування сторінки Facebook > Налаштування сторінки > Розширені налаштування повідомлень. У розділі Підключені застосунки знайдіть SendPulse або SendPulse Inst для Instagram і натисніть Змінити.

У діалоговому вікні перейдіть у Дозволи Messenger і увімкніть перемикачі Доступ до резервного каналу і Перехоплення керування розмовами. Перший перемикач дає змогу SendPulse бачити події розмови, коли нею володіє інший застосунок. Другий дає змогу SendPulse перехоплювати керування. Перемикач Перехоплення керування розмовами працює лише за заданого застосунку за замовчуванням.

Для інших застосунків у розділі Підключені застосунки вимкніть перемикач Перехоплення керування розмовами, щоб вони не перехоплювали розмови в чат-бота.
Тимчасові помилки Meta
Іноді Meta не може обробити запит на своєму боці. Ці помилки не потребують змін у чат-боті:
| Проблема | Причина | Що робити |
|---|---|---|
(#1) An unknown error occurred. |
Тимчасова помилка на боці Meta. Meta зазначає, що цю помилку також можуть спричиняти відсутні дозволи. | Надішліть повідомлення пізніше. Якщо помилка з’являється для всіх підписників, оновіть дозволи в розділі Керування ботами. |
(#2) An unexpected error has occurred. Please retry your request later. |
Тимчасова помилка на боці Meta. Meta зазначає, що вона також може з’являтися, коли підписник заблокував ваш бізнес. | Перевірте сторінку статусу Meta і надішліть повідомлення пізніше. |
Facebook, приватні відповіді: (#1) Please reduce the amount of data you're asking for, then retry your request. |
Помилка на боці Meta під час відповідей на коментарі, яка не залежить від вашого повідомлення. | Надішліть повідомлення пізніше. |
|
Facebook: Instagram: |
Тимчасова помилка на боці Meta. | Надішліть повідомлення пізніше. |
Якщо помилки немає в цьому списку, знайдіть її в кодах помилок Meta. Якщо проблема зберігається, зверніться до підтримки.
або