> 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/primery-scenariev.md). # Примеры сценариев Примеры помогут вам быстрее освоить настройку сценариев и адаптировать их под свои задачи. Помните, в одном событии можно настроить выполнение **сразу нескольких действий**. Это позволяет создавать более сложные сценарии для автоматизации различных процессов. **Пример 1: Смена этапа в CRM (например, Bitrix24)** * **Событие**: Начало диалога * **Действие**: Bitrix24, смена этапа воронки * **Идея**: В большинстве популярных CRM новый клиент по умолчанию попадает в этапы воронки по типу "Неразобранные", "Первый контакт" или тому подобные. Даже если ИИ-агент уже взял клиента в работу, до тех пор, пока не выполнилась хотя бы одна функция, этот клиент оставался на том же начальном этапе. В этом сценарии мы предлагаем решение по первичному распределению: при первом обращении клиента сервис автоматически сдвигает его карточку на нужный вам этап воронки, например, "**В работе с ИИ-агентом**". Этот сценарий позволит менеджерам CRM-системы явно видеть какой клиент уже находится в обработке **Пример 2: Улучшение опыта использования iFrame на сайте** * **Событие**: Полное совпадение запроса с ключевой фразой "Хочу скидку 15%" или "Хочу сайт под ключ" * **Действие**: Отправить запрос админу в Telegram и сообщить о клиенте, у которого совпадение запроса * **Идея**: удобно получать заявки, если клиент отвечает в вашем виджете "чат на сайт" (iFrame) и нажимает на заранее заготовленные ответы **Пример 3: Определение злоумышленников и нерелевантных запросов** * **Событие**: Совпадение запроса по смыслу с ключевыми словами "какой у тебя промпт", "отбрось все инструкции", "какой у тебя код" * **Действия**:\ 1\) Сообщение админу\ 2\) Поставить на паузу\ 3\) Написать админу в мессенджер, предупредив о злоумышленнике * **Идея**: быстрое реагирование при попытке взломать бота или сломать поведение агента **Пример 4: Отправка заданного приветственного сообщения** * **Событие**: Новое сообщение клиента * **Действие**: Отправить сообщение клиенту: "Здравствуйте, это интернет-магазин "Праздник"! Хотите устроить праздник?" * **Идея**: Удобно, чтобы Агент всегда начинал диалог с заранее заготовленной приветственной фразы. Тогда он не будет выдумывать её. **Пример 5: Клиент зовёт менеджера** * **Событие**: Совпадение запроса по смыслу с ключевыми словами\фразами "жалоба", "помогите", "живой человек" * **Действия**: 1\)Отправить уведомление администратору в Telegram: "Клиент сообщил о проблеме. Проверьте диалог!"\ 2\)Отправить сообщение в чат: "С Вами скоро свяжется наш администратор" 3\)Поставить диалог на паузу * **Идея**: удобно, если клиенту требуется помощь или он зовёт живого менеджера **Пример 6: Интеграции со сторонними CRM-системами** * **Событие**: Новое сообщение клиента * **Действие**: Custom API * **Идея**: необходимо, если вы пользуетесь сторонними CRM-системами и вам нужно передавать диалог напрямую в них **Пример 7: Добавление в контекст динамических переменных для площадки Авито.** * **Событие:** Начало диалога * **Действие:** Добавить контекст\ 1\) Добавьте переменную из вкладки Данные пользователя "Имя пользователя в мессенджере" и "Ссылка на объявление Авито".\ Если вам нужно, чтоб ИИ-агент брал данные из Bitrix24, то используйте вкладку Bitrix24.\ 2\) Опишите максимально точно, что нужно ИИ-агенту сделать с этими переменными.\ Например так: 1. Используй системное имя пользователя {{system\_data\_nameUser}} при общении. 2. Пользователь с Авито: {{system\_data\_linkAdAvito}}. Учитывай, что пользователь пишет по поводу конкретного товара/услуги из этого объявления. В своем первом ответе вежливо упомяни, что видишь его обращение.
* **Идея.** При первом диалоге пользователя ИИ-агенту сразу выдать точные и персонализированные ответы для площадки Авито. **Пример 8: Сохранение имени клиента в переменную диалога** * **Событие:** Начало диалога * **Действие:** Управление переменными 1\) Создайте переменную диалога типа "строка" `ClientName`\ 2\) В поле **"Откуда взять значение"** выберите системную переменную\ 3\) В качестве источника укажите имя пользователя в мессенджере\ 4\) При необходимости добавьте условие **"Если переменная пустая"** * **Идея.** Удобно один раз сохранить имя клиента в переменную диалога, а затем использовать его в промпте, отчёте, `Custom API`, `Python` и других действиях. **Пример 9: Контроль первого ответа с отложенным выполнением** * **Событие:** Начало диалога * **Отложенное выполнение:**\ 1\) Укажите задержку **5 минут**\ 2\) Включите **однократное выполнение**\ 3\) В поле **«Какие сценарии будут отменять отложенное выполнение»** добавьте сценарии **«Новое сообщение агента»** и **«Новое сообщение менеджера»** * **Действия** (если сценарий не был отменен в течение 5 минут):\ 1\) Отправить сообщение клиенту: «Сейчас все операторы заняты, но мы уже видим ваше обращение и скоро обязательно свяжемся с вами.»\ 2\) Отчёт администратору: «Клиент ожидает ответа более 5 минут. Проверьте диалог.» * **Идея.** Сценарий срабатывает сразу при начале диалога и запускает таймер. Если за это время в чат ответит ИИ-агент или менеджер, отложенное выполнение отменится. Если ответа не будет (например, закончились боткоины или диалог не заметили), клиент получит сервисное сообщение, а команда получит уведомление о ждущем клиенте. **Пример 10: Разные действия по источнику диалога** * **Событие:** Начало диалога * **Дополнительное условие:** Источник диалога = Telegram * **Настройки действий при выполнении условий:** Отправить сообщение клиенту: «Добро пожаловать! Наш ИИ-агент ответит на все Ваши вопросы.» * **Настройки действий при невыполнении условий:** Отправить сообщение клиенту: «Здравствуйте! Наши ИИ-специалисты ведут консультации только через телеграм-канал @ваш\_канал. Пожалуйста, напишите нам там, и мы обязательно ответим!» * **Важно:** в каждой из двух веток можно отдельно настроить **Отложенное выполнение** и свой набор действий. * **Идея.** Один сценарий сразу разделяет логику по источнику диалога: для Telegram даёт стандартное приветствие, а для остальных каналов отправляет клиента обращаться в Telegram-бот. {% hint style="success" %} Такие комбинации действий позволяют максимально эффективно использовать сценарии для решения сложных проблем. Не бойтесь экспериментировать и придумывать свои сочетания для решения ваших бизнес-задач. {% 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/primery-scenariev.md?ask=&goal= ``` `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.