> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/functional/integrations/instagram/oshibki-i-reshenie-problem.md).

# Ошибки и решение проблем

Типовые ошибки Instagram\* и как их исправить

Если Instagram\* не подключается или агент не отвечает, начните с [быстрой проверки](#chastye-problemy-kotorye-privodyat-k-molchaniyu-agenta) ниже. Дальше — разбор по симптомам. Коды ошибок отправки: [Ошибки Instagram\*](/questions-answers/errors-description/channels/instagram.md).

## Частые проблемы, которые приводят к молчанию агента <a href="#chastye-problemy-kotorye-privodyat-k-molchaniyu-agenta" id="chastye-problemy-kotorye-privodyat-k-molchaniyu-agenta"></a>

Пройдите список сверху вниз. В большинстве случаев причина находится здесь, и до редких ошибок ниже дело не доходит.

1. **Статус на странице интеграции — не «Подключено».** Пока канал отключён или авторизация сбилась, Nextbot не получает сообщения и комментарии. Что делать: [переподключите канал](#kak-perepodklyuchit-instagram).
2. **Выключен нужный переключатель.** «Подключено» само по себе недостаточно: без **«Работа с Direct»** агент не отвечает в личных сообщениях и на реакции Stories; без **«Работа с комментариями»** — не видит комментарии к постам. Что делать: включите нужные опции — [Включение возможностей интеграции](/functional/integrations/instagram/podklyuchenie-i-pervaya-nastroika.md#vklyuchenie-vozmozhnostei-integracii).
3. **Сообщение лежит в папке «Запросы».** Агент обрабатывает только чаты из **«Основные»**. Пока запрос не принят в приложении Instagram\*, сообщения из «Запросов» в Nextbot не попадут.
4. **Истекло окно 24 часов в Direct.** Агент может писать пользователю только после его сообщения и только в течение суток. Если окно закрылось, отправка не пройдёт — в диалоге Nextbot появится [`INSTAGRAM_SEND_MESSAGE_NOT_ALLOWED_WINDOW`](/questions-answers/errors-description/channels/instagram.md). Что делать: дождитесь нового сообщения от пользователя.
5. **Сценарий перехватывает событие раньше ответа агента.** Например, сценарий с действием **«Промолчать»** или с более высоким [приоритетом](/functional/scenarii.md#prioritet-gruppy-i-prioritet-scenariya) срабатывает первым — и агент «молчит» намеренно. Что делать: проверьте сценарии на это событие и их порядок.
6. **На странице интеграции есть кнопка «Разблокировать».** Приём сообщений временно заблокирован. Что делать: нажмите **«Разблокировать»** и отправьте тест ещё раз.

***

## Instagram\* не подключается

На странице интеграции нет статуса **«Подключено»**, авторизация обрывается или после входа канал сразу отваливается.

* Пройдите авторизацию заново: сначала через Instagram\*, при повторной ошибке — через Facebook\*.
* Проверьте, что у аккаунта есть права на связанную страницу Facebook\* и что Meta\* не отозвала доступ приложению Nextbot.
* Если ошибка связана с перепиской или правами на сообщения — см. [Ошибка прав доступа к потоку](#oshibka-prav-dostupa-k-potoku).
* Если ничего не помогает — полностью [переподключите канал](#kak-perepodklyuchit-instagram): удалите Nextbot в настройках Instagram\*, отключите интеграцию в Nextbot и подключите снова.

***

## Instagram\* подключён, но агент не отвечает

Статус **«Подключено»**, но в Direct, комментариях или на реакции Stories ответа нет (или в диалоге Nextbot событие есть, а ответа агента нет).

* Убедитесь, что включён переключатель именно того канала, где ждёте ответ — [Включение возможностей интеграции](/functional/integrations/instagram/podklyuchenie-i-pervaya-nastroika.md#vklyuchenie-vozmozhnostei-integracii).
* Откройте раздел [Сценарии](/functional/scenarii.md): нет ли сценария, который на это событие ставит **«Промолчать»** или отвечает шаблоном вместо агента. Проверьте [приоритет](/functional/scenarii.md#prioritet-gruppy-i-prioritet-scenariya).
* Для Direct дополнительно: чат должен быть в **«Основные»**, а окно **24 часов** после сообщения пользователя — ещё открыто.
* Проверьте [системный промпт](/functional/setting-up-agent/system-prompt.md) и сам диалог в Nextbot: агент не на паузе и диалог не остановлен вручную.

***

## Не приходят сообщения из Direct

Пользователь пишет в Direct, а в разделе **Диалоги** Nextbot переписки нет (или она не обновляется).

* Включите **«Работа с Direct»** на странице интеграции.
* В приложении Instagram\* примите запрос в переписку, если чат в папке **«Запросы»** — агент видит только **«Основные»**.
* Если на странице интеграции есть **«Разблокировать»**, нажмите её: приём мог быть временно заблокирован.

***

## Не обрабатываются комментарии

Под постом или Reels есть комментарии, но агент на них не реагирует и сценарии по комментариям не запускаются.

* Включите **«Работа с комментариями»** — по умолчанию переключатель часто выключен. Без него агент комментарии не видит.
* Если нужна реакция только на определённые комментарии (ключевые слова, увод в Direct) — проверьте, что есть сценарий с условием **«Instagram\*: сообщение в комментарии»** и что он включён.
* В параметрах условия: пост не в режиме соавторства; не попал в исключения и, если область проверки — «Выбранные посты», входит в этот список.

***

## Не работают сценарии для Stories

Реакция или отметка в Stories есть, но нужный сценарий не срабатывает — или, наоборот, агент отвечает на обычные реакции, хотя вы хотели тишину.

* Добавьте сценарий с условием **«Instagram\*: реакция на Stories»** (или **«отметка в Stories»**) либо готовый шаблон — например [«Не отвечать на реакции в Stories»](/functional/integrations/instagram/gotovye-scenarii-dlya-instagram.md#ne-otvechat-na-reakcii-v-stories).
* Если сценарий есть, но ведёт себя не так: проверьте, не перехватывает ли событие другой сценарий с более высоким [приоритетом](/functional/scenarii.md#prioritet-gruppy-i-prioritet-scenariya).
* Примеры задач и логики: [Что можно автоматизировать в Instagram\*: Stories](/functional/integrations/instagram/chto-mozhno-avtomatizirovat-v-instagram.md#stories).

***

## Не отправляется сообщение после комментария

Комментарий обработан (или ответ под постом ушёл), но сообщение в Direct не доходит.

* Чтобы писать в Direct, нужно открытое окно **24 часов** и чат в папке **«Основные»**. Если пользователь ещё не писал в Direct и не открыл переписку, доставка в личные сообщения может не пройти.
* В [Конструкторе сообщений](/functional/scenarii/konstruktor-soobshenii.md) проверьте настройки отправки: выбран ли канал **Instagram Direct** (или оба канала — комментарии и Direct), а не только ответ в комментариях.
* Если в диалоге Nextbot виден код ошибки — смотрите расшифровку в [Ошибках Instagram\*](/questions-answers/errors-description/channels/instagram.md).

***

## Ошибка прав доступа к потоку <a href="#oshibka-prav-dostupa-k-potoku" id="oshibka-prav-dostupa-k-potoku"></a>

Интеграция вроде подключена, но Nextbot не может управлять перепиской — например, не уходят ответы в Direct из‑за прав на стороне Meta\* / Facebook\*.

{% hint style="info" %}
Интерфейс Meta\* / Facebook\* может меняться. Ориентируйтесь на разделы про обмен сообщениями, разрешения Instagram\* и маршрутизацию переписки.
{% endhint %}

1. В бизнес-странице Facebook\* откройте **Настройки и конфиденциальность** → **Настройка страницы** → **Расширенный обмен сообщениями**.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FrqIHNYe6VdwJyXLWHx4S%2Fimage.png?alt=media&amp;token=682ae53d-d7f3-4344-a335-a8c7acefa53b" alt="Расширенный обмен сообщениями в настройках страницы Facebook"><figcaption><p>Настройки страницы Facebook\*: раздел «Расширенный обмен сообщениями».</p></figcaption></figure>

2. Нажмите **Edit** и включите **«Управление переписками»** в разрешениях канала Instagram\*.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FlRIw9JZInNGnFkKZKuMs%2Fimage.png?alt=media&amp;token=c0c736dc-3291-4dfe-b233-897904081e27" alt="Управление переписками в разрешениях Instagram"><figcaption><p>В разрешениях канала Instagram\* включите «Управление переписками».</p></figcaption></figure>

3. Если не помогло: **«Получатель в Instagram»** → **«Настроить»** → выберите приложение **Nextbot**.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FTuenKFW8ELSOiaFAVj9s%2F%7B1314DF71-85EC-4687-B575-B4C7D7FF3823%7D.png?alt=media&amp;token=3e2dc9f1-9629-4484-8aba-34b9c4c29e1c" alt="Получатель в Instagram"><figcaption><p>Пункт «Получатель в Instagram» → «Настроить».</p></figcaption></figure>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fu0wI22zULVw2ggo5KcBI%2F%7B455C9C3D-5775-4DAE-9340-A614B4BBA8B1%7D.png?alt=media&amp;token=ea351635-c5b7-425c-b6d2-1d7a7e778c98" alt="Выбор приложения Nextbot"><figcaption><p>Выберите приложение Nextbot в списке получателей.</p></figcaption></figure>

4. Затем **Маршрутизация переписки в Instagram** → **«Настроить»** → **«Начать»** → **«Продолжить»** → **Nextbot**.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FX5sy9h0rLuqWMA46icdy%2F%7BC9F50EA6-29B2-4714-AB4C-029CF2B2E62E%7D.png?alt=media&amp;token=b363c78e-e2ef-4efe-a166-2d9eb1aea357" alt="Маршрутизация переписки в Instagram"><figcaption><p>Раздел «Маршрутизация переписки в Instagram».</p></figcaption></figure>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F2aw2W1Rfm1rqBSJrbYTt%2F%7B21A39EE6-FC23-4E6E-A7CD-8DE944D4232C%7D.png?alt=media&amp;token=dfdef8a9-5abf-4f60-9f59-346887a636d6" alt="Кнопка Настроить"><figcaption><p>Нажмите «Настроить».</p></figcaption></figure>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FfJrzU8tLKmv5eFBVuB32%2F%7B42388302-89A5-4616-B4B5-090CDF06B3AB%7D.png?alt=media&amp;token=d90a37ae-021e-445d-8e27-754516364449" alt="Кнопка Начать"><figcaption><p>Нажмите «Начать».</p></figcaption></figure>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fg1CjjaBBLY6OGeR019fu%2F%7BC7B4CC1F-9493-4D37-A700-94BC15A141AA%7D.png?alt=media&amp;token=eb23ec15-b96b-4992-8e08-487c6a8117fc" alt="Кнопка Продолжить"><figcaption><p>Нажмите «Продолжить».</p></figcaption></figure>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fqy764OZlcz1Azz0YUidh%2F%7B9D0896B2-75B1-468E-AEC4-5FC23BB26393%7D.png?alt=media&amp;token=4c9ffd73-fee9-468d-b876-3eb9cf1af60b" alt="Выбор Nextbot в маршрутизации"><figcaption><p>Выберите Nextbot в маршрутизации переписки.</p></figcaption></figure>

5. Если ошибка остаётся — [переподключите Instagram\*](#kak-perepodklyuchit-instagram).

***

## Как переподключить Instagram\* <a href="#kak-perepodklyuchit-instagram" id="kak-perepodklyuchit-instagram"></a>

Переподключение нужно, если канал отвалился после смены пароля, отзыва доступа Nextbot в Instagram\* / Meta\* или сбоя авторизации. Смысл шагов: сначала отозвать доступ в Instagram\*, потом отключить канал в Nextbot и подключить заново.

1. Откройте Instagram\* в браузере, войдите в нужный аккаунт. В левом меню нажмите **«Ещё»** → **«Настройки»**.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-77d8bf2a379f52ae17c42f31de106758dc23dc6c%2Finstagram-eshe-nastroiki.png?alt=media" alt="Меню Ещё и пункт Настройки в Instagram"><figcaption><p>В веб-версии Instagram\*: «Ещё» → «Настройки».</p></figcaption></figure>

2. В настройках откройте **«Ваше приложение и медиафайлы»** → **«Разрешения сайта»** — откроется список приложений и сайтов.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-25507435ea55faf98e002fd985a9e806ea53a7f6%2Finstagram-razresheniya-sajta.png?alt=media" alt="Настройки: Разрешения сайта"><figcaption><p>В настройках: «Ваше приложение и медиафайлы» → «Разрешения сайта».</p></figcaption></figure>

3. На вкладке **«Активные»** найдите **Nextbot** и нажмите **«Удалить»**.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-c8013f6653f0b21eda49af27aeff0d304c22d194%2Finstagram-prilozheniya-nextbot-udalit.png?alt=media" alt="Приложения и сайты: удаление Nextbot"><figcaption><p>В «Приложения и сайты» на вкладке «Активные» удалите Nextbot.</p></figcaption></figure>

4. В Nextbot откройте **Интеграции → Instagram\*** и нажмите **«Отключить»**.
5. Подключите канал заново по статье [Подключение и первая настройка](/functional/integrations/instagram/podklyuchenie-i-pervaya-nastroika.md): сначала через Instagram\*, затем [включите нужные переключатели](/functional/integrations/instagram/podklyuchenie-i-pervaya-nastroika.md#vklyuchenie-vozmozhnostei-integracii) и [проверьте](/functional/integrations/instagram/podklyuchenie-i-pervaya-nastroika.md#proverka-podklyucheniya) тестовым сообщением или комментарием.

{% hint style="info" %}
Если после переподключения через Instagram\* сообщения всё ещё не уходят, попробуйте авторизацию через Facebook\* — см. подсказку в [Подключение и первая настройка](/functional/integrations/instagram/podklyuchenie-i-pervaya-nastroika.md) и на [главной странице раздела](/functional/integrations/instagram.md).
{% endhint %}

\**Принадлежит корпорации Meta, запрещена на территории РФ.*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.nextbot.ru/functional/integrations/instagram/oshibki-i-reshenie-problem.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
