> 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).

# Сценарии

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

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

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

Например:

* отправить фиксированное сообщение, если клиент написал определённую фразу;
* уведомить менеджера, если клиент просит связаться с человеком;
* по-разному реагировать на обращения из WhatsApp и Telegram;
* проверить данные клиента в CRM;
* не отвечать на обычные реакции в Instagram\* Stories;
* запустить Python-скрипт или передать данные во внешнюю систему;
* выполнить действие не сразу, а через заданное время.

## Как работает сценарий

Основная логика выглядит так:

[**Событие**](https://doc.nextbot.ru/functional/scenarii/sobytiya-scenariev.md) **→** [**Дополнительные условия**](https://doc.nextbot.ru/functional/scenarii/dopolnitelnye-usloviya.md) **→** [**Действия**](https://doc.nextbot.ru/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%2Fgit-blob-a718404a02fa5049f52bba8d7617c7cf73811c9d%2Fscenarii-kartochka-opisanie.png?alt=media" 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%2Fgit-blob-7b4acdad49b543f531fa4e8b1df776ea91603256%2Fscenarii-sobytiya-okno-klient.png?alt=media" 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%2Fgit-blob-ccc9f4377440b8143b37f6aba83cf87a931542f6%2Fscenarii-usloviya-okno.png?alt=media" alt="Окно Добавить условие: группа Диалог и начало группы Дата и время"><figcaption><p>Окно «Добавить условие»: условия выбираются отдельно от события.</p></figcaption></figure>

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

Например:

* сообщение пришло из Instagram\* Direct;
* сейчас нерабочее время;
* клиент подписан на Instagram\*;
* в CRM не заполнен телефон;
* ранее уже выполнился другой сценарий.

Если сценарий должен выполняться при каждом наступлении события, дополнительные условия можно не использовать.

### Действия

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-502fdc6513d0b59c383443c4ff40e60fb71b4d9d%2Fscenarii-deistviya-neskolko.png?alt=media" alt="Три действия в одной ветке: конструктор, отчёт администратору и пауза"><figcaption><p>В одной ветке сразу несколько действий: сообщение клиенту, отчёт администратору и пауза диалога.</p></figcaption></figure>

Определяют, что произойдёт после срабатывания сценария. В одном сценарии их может быть несколько.

Например:

* отправить сообщение;
* промолчать;
* поставить диалог на паузу;
* уведомить администратора;
* изменить переменную;
* вызвать функцию;
* выполнить Python-скрипт;
* передать данные в CRM или другой сервис.

## Как это выглядит на практике

### Пример 1

Допустим, вы хотите, чтобы если клиент вечером пишет в WhatsApp вопрос о стоимости доставки, он сразу получал сообщение, что менеджер ответит утром, а менеджеру приходило уведомление о новом обращении.

Для этого сценарий можно собрать так:

* **Событие:** сообщение клиента совпало по смыслу с фразами «сколько стоит доставка», «какая цена доставки», «сколько будет доставить».
* **Дополнительные условия:** источник диалога — WhatsApp, время обращения — нерабочее время агента.
* **Действия:** отправить клиенту подготовленное сообщение и отправить уведомление менеджеру.

В результате сценарий не будет срабатывать на похожие вопросы из других каналов или в рабочее время — только в нужной ситуации.

### Пример 2

Допустим, вы хотите, чтобы при первом обращении нового клиента агент всегда отправлял одно и то же приветствие.

Здесь дополнительные условия не нужны:

* **Событие:** начало диалога.
* **Действие:** через [Конструктор сообщений](https://doc.nextbot.ru/functional/scenarii/deistviya-v-scenariyakh/konstruktor-soobshenii.md) отправить заранее подготовленное приветствие.

Например:

> Здравствуйте! Я помогу подобрать подходящий вариант и отвечу на вопросы. Расскажите, пожалуйста, что вас интересует?

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

Событие и действие есть в каждом сценарии. Дополнительные условия нужны только тогда, когда сценарий должен срабатывать не всегда, а только в определённых обстоятельствах.

## Чем сценарии отличаются от функций

Сценарии и [функции](https://doc.nextbot.ru/functional/functions.md) решают разные задачи. Их можно использовать по отдельности или связывать между собой.

Главное отличие — **кто принимает решение о запуске действия**.

**Функция** выполняется, когда **ИИ-модель в ходе диалога понимает, что сейчас нужно выполнить определённую операцию**. Например, найти товар, проверить остаток, создать запись или получить данные из внешней системы.

**Сценарий** запускается не по решению ИИ. Система сама отслеживает заданное событие и проверяет условия. Если событие произошло и условия выполнены, указанные действия запускаются автоматически.

* **Функция:** ИИ определил, что для ответа или продолжения диалога нужно выполнить операцию.
* **Сценарий:** система зафиксировала событие X и при выполнении заданных условий запускает действие Y.

Сценарии и функции можно связывать. Например, одним из действий сценария может быть **вызов функции**, а в дополнительных условиях сценария можно проверить, выполнялась ли определённая функция ранее.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-f11fd3bd12e56491bba50da2009c003b8def8858%2Fscenarii-deistviya-funkciya.png?alt=media" alt="Действие Вызов функции с выбранной функцией"><figcaption><p>Действие «Вызов функции»: сценарий запускает функцию из списка агента.</p></figcaption></figure>

Отдельно настраивается [сценарий поведения после выполнения функции](https://doc.nextbot.ru/functional/functions/behavior-scenario.md): что делать сразу после того, как функция уже выполнилась.

## Как спроектировать сценарий <a href="#kak-sproektirovat-scenarii" id="kak-sproektirovat-scenarii"></a>

Сначала опишите логику обычным языком:

> Когда \[событие], если \[условия], нужно \[действия].

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

У вас появятся три ответа:

1. **Что должно произойти, чтобы начал выполняться сценарий?** Какое событие?
2. **Есть ли ещё условия у этого события, которые должны его ограничивать?** Если да — это дополнительные условия. Если нет — их не трогаем.
3. **Что нужно выполнить агенту, когда это событие наступит?** Это и будет действием.

{% hint style="info" %}
Сначала продумайте логику сценария, затем перенесите её в интерфейс по инструкции [«Как настроить сценарий»](https://doc.nextbot.ru/functional/scenarii/kak-nastroit-scenarii.md).
{% endhint %}

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

[**Как настроить сценарий.**](https://doc.nextbot.ru/functional/scenarii/kak-nastroit-scenarii.md) Как создать сценарий, указать событие, условия и действия и проверить запуск.

[**События сценариев.**](https://doc.nextbot.ru/functional/scenarii/sobytiya-scenariev.md) Какие события запускают сценарий и как выбрать тип совпадения текста.

[**Дополнительные условия.**](https://doc.nextbot.ru/functional/scenarii/dopolnitelnye-usloviya.md) Как ограничить срабатывание после события.

* [**Состояние данных в CRM.**](https://doc.nextbot.ru/functional/scenarii/dopolnitelnye-usloviya/sostoyanie-dannykh-v-crm.md) Как проверить поля контакта, сделки или лида.
* [**Проверка подписки Telegram.**](https://doc.nextbot.ru/functional/scenarii/dopolnitelnye-usloviya/proverka-podpiski-telegram.md) Как проверить подписку на канал или группу и настроить действия по результату.

[**Действия в сценариях.**](https://doc.nextbot.ru/functional/scenarii/deistviya-v-scenariyakh.md) Что может произойти после срабатывания.

* [**Конструктор сообщений.**](https://doc.nextbot.ru/functional/scenarii/deistviya-v-scenariyakh/konstruktor-soobshenii.md) Как отправить фиксированное сообщение, медиа или ответ ИИ с отдельными настройками.

[**Примеры сценариев.**](https://doc.nextbot.ru/functional/scenarii/primery-scenariev.md) Готовые сочетания событий, условий и действий для типовых задач.


---

# 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/scenarii.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.
