# Настройка Direct и Stories

Для активации работы ИИ-агента в личных сообщениях подключите Instagram удобным для вас способом на странице интеграции Instagram в Nextbot, затем включите переключатель "**Настройки Direct".**

После включения по умолчанию открываются два блока:

* **Настройки ответа на реакции в Stories**
* **Настройка Direct**

#### Общие настройки

Опция "**Продолжить диалог после совпадения по ключевому слову"** позволяет ИИ-агенту продолжать общение с пользователем после того, как сработал конкретный триггер. То есть ИИ не ограничивается одним первым шаблонным ответом, а аккуратно продолжает переписку в Direct и отвечает на следующие сообщения пользователя. Это особенно удобно, когда ключевые слова нужны только для запуска диалога (например, "старт", "записаться", "скидка". "акция"), а дальше пользователь общается в свободной форме и задаёт любые уточняющие вопросы.

**Разберем каждый блок**

### Настройки ответа **на реакции в Stories**

В этом блоке вы выбираете, как именно ИИ должен реагировать при получении текстовых сообщений, эмодзи, быстрых реакций от пользователей на ваши публикации (Stories), выбрав одну из опций: Игнорировать, Шаблонный ответ, Позволить ИИ ответить самому.

<figure><img src="/files/PkbK6DkUviexpU3cAFKd" alt=""><figcaption></figcaption></figure>

* **Игнорировать**: ИИ-агент не будет создавать диалог или отвечать на присланные реакции.
* **Шаблонный ответ**: В этой опции вы можете добавить до 5 вариантов заготовленного ответа — в этом случае система будет выбирать один из них случайным образом, для разнообразия ответов.
* **Позволить ИИ ответить самому**: ИИ автоматически сформирует персональный ответ на реакцию пользователя в Stories, используя выбранный системный промпт, который вы можете создать, модифицировать или сгенерировать нажав на кнопку "карандаш".

### Настройка Direct

{% hint style="warning" %}
Важно: для переписки в Instagram Direct действует правило 24 часов. ИИ-агент может отправлять сообщения только в течение 24 часов после последнего сообщения пользователя. Если пользователь не писал в Direct, бот не сможет начать диалог первым. При нарушении этого правила возможна ошибка [`INSTAGRAM_SEND_MESSAGE_NOT_ALLOWED_WINDOW`](/questions-answers/errors-description/channels/instagram.md).
{% endhint %}

#### **Добавление ключевых слов:**

ИИ-агент может отвечать на сообщения, которые содержат определенные ключевые слова. Введите ключевое слово и нажмите "Enter". Вы можете ввести несколько ключевых слов. По которым будет запускаться ИИ-агент.

Если не добавлены ключевые слова, то ИИ-агент отвечает на все сообщения в Direct.

{% hint style="info" %}
Важно: при отключении Инстаграм, все ранее введенные ключевые слова и настройки будут удалены
{% endhint %}

* **Полное совпадение запроса** — работает при точном совпадении сообщения с ключевыми словами/фразами.
* **Частичное совпадение запроса** — активируется, если сообщение содержит часть ключевых слов.
* **Совпадение запроса по смыслу** — срабатывает при смысловой близости сообщения к заданной фразе (уровень совпадения можно регулировать).

### Действия в Direct: Шаблоны, Кнопки, ИИ

<figure><img src="/files/wJfG0AWpGsFn3P7ImZsl" alt=""><figcaption></figcaption></figure>

1. **Шаблон с простым текстом.** Агент будет отправлять пользователю заранее заданный текст. Вы можете добавить до 5 вариантов ответа — в этом случае система будет выбирать один из них случайным образом, для разнообразия ответов.

**Дополнительно:**

* В блоке "Добавление ключевых слов" укажите слова или фразы, при которых сработает данный шаблон.
* Если оставить поле пустым — шаблон будет отвечать на **все входящие сообщения.**

2. **Шаблон с кнопками.** В этой опции будет отправлен шаблонный ответ с кнопкой (можно создать до трех кнопок), который позволяет переводить клиентов на сайт или запускать дополнительный сценарий в связке с ключевыми словами.

<figure><img src="/files/J5A9URmXF8XKp93je3y5" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
**Важно:** Кнопки отображаются только в мобильном приложении Instagram. В веб-версии (на компьютере) пользователь увидит только текст сообщения.
{% endhint %}

Выберите действие для каждой кнопки шаблона:

* **Переход по ссылке** — используется для открытия внешних ресурсов (сайт, карточка товара, оплата, группа Telegram). Необходимо указать полный URL.
* **"Продолжить диалог"** — текст кнопки отправляется как обычное сообщение. Создайте дополнительную настройку Direct №2 с использованием ключевого слова, которое совпадает с текстом из кнопки Direct №1 → установите Тип ответа в Direct это шаблон с простым текстом, универсальный шаблон и т.д, исходя из вашей бизнес-логики.

**Дополнительно для шаблона:**

* В блоке "Добавление ключевых слов" укажите слова или фразы, при которых сработает данный шаблон.
* Если оставить поле пустым — шаблон будет отвечать на **все входящие сообщения.**

3. **Универсальный шаблон.** Эта опция предназначена для создания визуальных сообщений с изображениями, которые пользователь может пролистывать (каруселей). В одно сообщение можно добавить до 10 элементов, каждый из которых содержит изображение, заголовок, описание и до трех кнопок.

{% hint style="info" %}
**Важно:** В мобильном приложении Instagram отображаются все карточки карусели и все кнопки.

В веб-версии **с**ообщения не поддерживаются.
{% endhint %}

<figure><img src="/files/UR1ND1RaoAwRVJVgyoIH" alt="" width="375"><figcaption></figcaption></figure>

**Настройка элементов:**\
Для каждой карточки в шаблоне вы можете настроить:

* **Заголовок и текст** — краткое описание предложения.​
* **URL изображения** — ссылка на картинку, которая будет обложкой карточки.​ При добавлении изображения убедитесь, что URL ведет напрямую на файл картинки и доступен публично, иначе она не подгрузится в Instagram.\
  Если вы используете Облако Nextbot, то можно скопировать URL ссылку оттуда.
* **Кнопки** — до 3-х интерактивных кнопок с действиями "Переход по ссылке" или "Продолжить диалог".

При выборе действия "**Продолжить диалог**" текст кнопки отправляется как обычное сообщение. Создайте дополнительную настройку Direct №2 с использованием ключевого слова, которое совпадает с текстом из кнопки Direct №1 → установите Тип ответа в Direct это шаблон с простым текстом, универсальный шаблон и т.д, исходя из вашей бизнес-логики.

**Дополнительно:**

* В блоке "Добавление ключевых слов" укажите слова или фразы, при которых сработает данный шаблон.
* Если оставить поле пустым — шаблон будет отвечать на **все входящие сообщения.**

4. **Быстрые ответы.** Это кнопки с вариантами, которые ИИ отправляет вместе с сообщением в Direct. Они появляются прямо под текстом сообщения и позволяют пользователю выбрать один из заготовленных вариантов одним нажатием, вместо того чтобы печатать ответ вручную. Вы можете создать до 13 таких кнопок.

{% hint style="info" %}
**Важно:** быстрые ответы отображаются **только в мобильном приложении Instagram**. В веб-версии кнопки не видны.
{% endhint %}

<figure><img src="/files/1wSxGZpxUuCKVqsho9Dx" alt=""><figcaption></figcaption></figure>

**Как работают быстрые ответы:**

1. Пользователь пишет сообщение → ИИ отправляет текст сообщения с кнопками-вариантами под ним.
2. Пользователь нажимает на одну из кнопок → **кнопки исчезают**, а текст кнопки отправляется как обычное сообщение.
3. ИИ обрабатывает этот текст и отвечает — в зависимости от настроек Direct. Создайте дополнительную настройку для Direct №2 с использованием ключевых слов, которые совпадают с текстом из кнопок Direct №1 → установите Тип ответа в Direct. например это шаблон с простым текстом, универсальный шаблон и т.д, исходя из вашей бизнес-логики.

**Дополнительно:**

* В блоке "Добавление ключевых слов" укажите слова или фразы, при которых сработает данный шаблон.
* Если оставить поле пустым — шаблон будет отвечать на **все входящие сообщения.**

5. **Дополнить промпт.** Эта опция позволит ИИ-агенту дополнить инструкцию, исходя из контекста.

Например, введите в поле "Инструкция для ИИ": "*Если клиент интересуется дополнительной скидкой, то сообщи пользователю "дополнительная скидка только за подписку*".

Как только пользователь спросит про дополнительную скидку, то ИИ-агент ответит соответствующей инструкцией.

6. **Позволить ИИ ответить самому.** ИИ-агент ответит на сообщение самостоятельно, генерируя текст в соответствии с вашим системным промптом.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.nextbot.ru/functional/integrations/instagram/nastroika-direct-i-stories.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
