> 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/scenarii.md).

# Сценарии

Сценарии расширяют потенциал вашего ИИ-агента, позволяя автоматизировать задачи, настраивать гибкое поведение и интегрировать внешние системы на основе заданных условий

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FdkR8RgS5nFpfgcwXYlUm%2Fimage.png?alt=media&amp;token=7ad190c9-03e7-4fa1-9a0d-d9f21c565c2a" alt=""><figcaption></figcaption></figure>

Функционал "Сценарии" — это инструмент для автоматизации задач и создания гибкого поведения вашего ИИ-агента. С его помощью агент может реагировать на различные события в диалоге и выполнять заданные действия, такие как отправка сообщений, интеграция с CRM, выполнение Python-скриптов и многое другое.

<h2 align="center"><strong>Как это работает?</strong></h2>

Сценарий запускается, когда происходит определённое **событие** (например, клиент отправляет сообщение). После этого выполняется одно или несколько **действий**, которые вы настроили: сразу или с задержкой, если включено [отложенное выполнение](/functional/scenarii/deistviya-v-scenariyakh.md).

Вы можете комбинировать различные события и действия так, как будет нужно именно вам. Не стесняйтесь экспериментировать!

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FIOVqlrN297JKQNIF8oE0%2Fimage.png?alt=media&amp;token=c47a4d6b-7693-4f1a-9fb5-957ce9e8a69f" alt=""><figcaption></figcaption></figure>

## В этом разделе

Чтобы было проще ориентироваться, мы разделили тему сценариев на отдельные статьи:

* [Виды сценариев (события)](/functional/scenarii/vidy-scenariev.md)
* [Дополнительные условия](/functional/scenarii/dopolnitelnye-usloviya.md)
* [Действия в сценариях](/functional/scenarii/deistviya-v-scenariyakh.md)
* [Конструктор сообщений](/functional/scenarii/konstruktor-soobshenii.md)
* [Примеры сценариев](/functional/scenarii/primery-scenariev.md)
* [Проверка подписки Telegram](/functional/scenarii/proverka-podpiski-telegram.md)
* [Настройка ответов Instagram-бота](/functional/integrations/instagram/nastroika-otvetov-instagram-bota.md)

## Группы сценариев

Группы сценариев помогают объединять сценарии по бизнес-логике и управлять приоритетом их выполнения. Это особенно удобно, когда у вас много похожих сценариев в одном агенте.

### Как создать группу

Создание групп доступно на главной странице раздела **«СЦЕНАРИИ»** по кнопке **«НОВАЯ ГРУППА»**.

После нажатия откроется модальное окно, где можно:

1. Указать название группы.
2. Выбрать приоритет группы.
3. Добавить или удалить группу.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-a4fe55f7399134811902c178203fdd859802159f%2Fscenarii-groups-modal.png?alt=media" alt=""><figcaption></figcaption></figure>

### Приоритет группы и приоритет сценария

Если под одно событие подходят несколько сценариев, сначала учитывается **приоритет группы**, в которой находятся эти сценарии. При конфликте одинаковых сценариев фактически выполняются действия сценария из группы с более высоким приоритетом.

Внутри любого сценария также можно дополнительно настраивать поле **Приоритет выполнения** и управлять порядком запуска.

### Как добавить нужный сценарий в группу и сменить его приоритет

Откройте нужный сценарий и:

1. Выберите для него нужную группу в поле **"Группа сценария"**.
2. При необходимости измените поле **Приоритет выполнения** в той же карточке.

Такой сценарий запускается при выполнении события и условий, а затем выполняет свои действия с учётом выставленных приоритетов.

{% hint style="info" %}
Группы сценариев помогают структурировать сценарии и управлять приоритетом их выполнения.
{% endhint %}

<h2 align="center"><strong>Как настроить и включить сценарий</strong></h2>

Чтобы настроить и включить сценарий, выполните следующие шаги:

1. Зайдите в левом меню в раздел **"СЦЕНАРИИ"**
2. Нажмите кнопку **"ДОБАВИТЬ СЦЕНАРИЙ"** — откроется дополнительное меню. Выберите один из трёх способов:

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-2d6cc5b9a7b7a79d481ddd1381721113e2b02232%2Fscenarii-dobavit-menu.png?alt=media" alt=""><figcaption></figcaption></figure>

* **"ДОБАВИТЬ СЦЕНАРИЙ С БАЗОВЫМИ НАСТРОЙКАМИ"** — сценарий создастся с базовыми настройками. Затем выберите **условие** из списка доступных триггеров.
* **"ДОБАВИТЬ СЦЕНАРИЙ ПО ШАБЛОНУ"** — откроется окно **«Выберите шаблон сценария»**. Шаблоны сгруппированы по разделам **Общие**, **Instagram** и **Telegram**. Выберите готовый шаблон — сценарий (или группа сценариев) создастся уже с преднастройками, которые при необходимости можно изменить.
* **"СОЗДАТЬ ПО КОДУ ИЗ БУФЕРА ОБМЕНА"** — создаёт копию сценария по коду из буфера обмена. Сначала откройте нужный сценарий и скопируйте его код, затем снова нажмите **"ДОБАВИТЬ СЦЕНАРИЙ"** и выберите этот пункт. Будет создан идентичный сценарий со всеми условиями и действиями.

Если выбрали **"ДОБАВИТЬ СЦЕНАРИЙ ПО ШАБЛОНУ"**, откроется такое окно:

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-dba72957b2ae07ccf7989310efe29e3ddb405147%2Fscenarii-shablon-scenariya.png?alt=media" alt=""><figcaption></figcaption></figure>

Сейчас в окне доступны такие шаблоны:

**Общие**

* **Обращение по имени в начале диалога** — в начале диалога агент здоровается и обращается к клиенту по имени.
* **Очистка контекста при повторном обращении** — при повторном обращении агент очищает диалог и снова приветствует клиента по имени.

**Instagram**

* **Проверка подписки после приветствия** — группа из трёх сценариев: предложение материалов, запрос подписки по кнопке «ХОЧУ» и проверка подписки в Direct.
* **Ответ на комментарии в директ** — ответ в комментарии и директ по ключевому слову, на остальные комментарии агент молчит.
* **Не отвечать на реакции в Stories** — агент молчит, когда клиент ставит реакцию на Stories.

**Telegram**

* **Шаблонный ответ с кнопками** — по ключевому слову агент отправляет сообщение с inline-кнопками оценки от 1 до 10.

{% hint style="info" %}
Список шаблонов будет дополняться. Если подходящего шаблона нет, создайте сценарий с базовыми настройками и настройте его вручную.
{% endhint %}

3. Откройте созданный сценарий (нажмите на него), чтобы настроить действия, группу, поле **"Приоритет сценария"** и др.
4. Нажмите кнопку **"ДОБАВИТЬ УСЛОВИЕ"** и выберите одно или несколько дополнительных условий для срабатывания сценария (опционально). Если нужна развилка, настройте блоки **«Настройки действий при выполнении условий»** и **«Настройки действий при невыполнении условий»**. В обеих ветках можно добавить не только действия, но и свои дополнительные условия.
5. Нажмите кнопку **"ДОБАВИТЬ ДЕЙСТВИЕ"** и выберите одно или несколько действий, которые должны выполняться при срабатывании сценария.
6. Сохраните изменения.
7. Не забудьте проверить сценарий в тестовом чате или через реальный подключенный канал!

Теперь ваш сценарий готов к работе и будет автоматически запускаться при выполнении заданных условий!

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FYsGD7uCMasaUkqb1ltzk%2Fimage.png?alt=media&amp;token=7f7e6087-13cb-4795-a72d-ef9ae70f0b19" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Обратите внимание, что при добавлении ключевых слов и проверке семантического совпадения (в событии «Совпадение сообщения клиента по смыслу») происходит векторизация текста в OpenAI. Стоимость векторизации зависит от количества токенов в тексте и рассчитывается по цене 0.13 USD за 1М токенов, учитывайте это при добавлении ключевых слов или проверке семантического совпадения. В случае, если у вас установлен свой ключ OpenAI, то проверка семантического совпадения возможна только с положительным балансом на вашем аккаунте OpenAI.
{% endhint %}


---

# 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 dynamically by asking a question.

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

```
GET https://doc.nextbot.ru/functional/scenarii.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.