timeline-arrowСценарии

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

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

Как это работает?

Сценарий запускается, когда происходит определённое событие (например, клиент отправляет сообщение). После этого выполняется одно или несколько действий, которые вы настроили.

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

Виды сценариев

Сценарии срабатывают при определённых событиях (триггерах). Доступны следующие виды:

  • Начало диалога — выполняется при старте диалога, когда к агенту обратится новый клиент

  • Новое сообщение клиента — активируется после каждого сообщения клиента

  • Новое сообщение агента — срабатывает, когда агент отправляет ответ

  • Сообщение от менеджера — запускается, если в чат было отправлено сообщение от менеджера

  • Повторное обращение клиента — выполняется, если клиент вернулся в диалог спустя указанное количество дней с момента своего предыдущего сообщения

  • Полное совпадение запроса — работает при точном совпадении сообщения с ключевыми словами/фразами

  • Частичное совпадение запроса — активируется, если сообщение содержит часть ключевых слов

  • Совпадение запроса по смыслу — срабатывает при смысловой близости сообщения к заданной фразе (уровень совпадения можно регулировать)

  • Достижение лимита расходов на пользователя — выполняется при достижении лимита расходов на пользователя, настроенных для этого агента

  • Ошибка отправки сообщения — выполняется, если агент не смог отправить ответ клиенту из-за ошибки мессенджера или интеграции

circle-info

Когда вы добавляете ключевые слова или проверяете их смысловое совпадение, система отправляет ваш текст в OpenAI для обработки (векторизации). Эта услуга платная. Стоимость зависит от длины текста. Цена — 0,13 USD за 1 000 000 токенов.

Если у вас свой ключ OpenAI: Проверять совпадение можно только при положительном балансе на вашем счёте в OpenAI.

circle-info

Если вы хотите предложить какой-либо сценарий, которого вам не хватает, пожалуйста, нажмите кнопку "Не нашли нужного сценария?" в списке.

Дополнительные Условия для срабатывания

Вы можете добавить дополнительные условия для более точного управления срабатыванием Сценариев. Например, настроить запуск Сценария «Начало диалога» только в нерабочее время агента или задать последовательность выполнения Сценариев, когда один активируется только после завершения другого. Система поддерживает множество вариантов и комбинаций условий — экспериментируйте с настройками для достижения нужной логики работы.

Виды условий:

  • Нерабочее время агента — срабатывает только в нерабочее время по расписанию агента

  • День недели — срабатывает в выбранные вами дни недели

  • Текущее время — срабатывает определённый диапазон времени

  • Источник диалога — срабатывает в зависимости от источника диалога

  • Проверка подписки Telegram — Проверяет есть ли у пользователя подписка на Telegram канал/группу

  • Выполнена функция — срабатывает, если выбранные функции выполнились

  • Выполнен сценарий — срабатывает, если выбранные сценарии выполнились

Действия в сценариях

После срабатывания сценария можно выполнить одно или несколько действий. Доступны следующие варианты:

  • Добавить контекст — добавление контекста в диалог с клиентом

  • Заблокировать пользователя — клиент будет заблокирован

  • Отправить сообщение — агент отправляет заготовленное текстовое сообщение клиенту

  • Промолчать — агент пропускает ответ, ничего не отправляя

  • Включить\выключить Функцию — включение\выключение функции в рамках диалога

  • Включить\выключить Сценарий — включение\выключение сценария в рамках диалога

  • Пауза диалога — диалог будет поставлен на паузу

  • Возобновление диалога — диалог будет снят с паузы

  • Переключить ИИ-агента — меняет активного агента для общения с клиентом

  • U-ON Travel — отправка данных в U-ON Travel

  • Bitrix24 — отправка данных в Bitrix24

  • amoCRM — отправка данных в amoCRM

  • Kommo — отправка данных в amoCRM

  • EnvyCRM — отправка данных в EnvyCRM

  • custom API — отправка запроса на сторонние API для выполнения сложных операций

  • Отчёт администратору — отправка отчёта или уведомления в Telegram или WhatsApp

  • Python-скрипт — выполнение произвольного питон-скрипта для реализации уникальных бизнес-логик

  • Отправить отложенное сообщение — после выполнения этого действия через указанное время будет отправлено сообщение

  • Вызов функции — вызывает функцию из списка созданных функций для этого агента

circle-exclamation

Примеры некоторых сценариев

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

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

Пример 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}}. Учитывай, что пользователь пишет по поводу конкретного товара/услуги из этого объявления. В своем первом ответе вежливо упомяни, что видишь его обращение.

  • Идея. При первом диалоге пользователя ИИ-агенту сразу выдать точные и персонализированные ответы для площадки Авито.

circle-check

Как настроить и включить сценарий

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

  1. Зайдите в левом меню в раздел "СЦЕНАРИИ".

  2. Нажмите кнопку "ДОБАВИТЬ СЦЕНАРИЙ".

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

  4. Откройте созданное условие (нажмите на него), чтобы настроить действия.

  5. Нажмите кнопку "ДОБАВИТЬ УСЛОВИЕ" и выберите одно или несколько условий для срабатывания сценария (опционально).

  6. Нажмите кнопку "ДОБАВИТЬ ДЕЙСТВИЕ" и выберите одно или несколько действий, которые должны выполняться при срабатывании сценария.

  7. Сохраните изменения.

  8. Не забудьте проверить сценарий в тестовом чате или через реальный подключенный канал!

Обратите внимание:

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

  • Другие сценарии, например, как "Совпадение по смыслу", можно создавать в неограниченном количестве. Это позволяет настроить множество комбинаций для работы вашего бизнеса.

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

circle-exclamation

Проверка подписки Telegram

Опция «Проверка подписки Telegram» позволяет автоматически проверять, подписан ли пользователь в группе/канале Telegram, и в зависимости от результата выполнять дополнительные действия (например, отправить сообщение пользователю).

Используйте эту опцию, если ваш сценарий строится вокруг подписки:

  1. Бот должен проверять, состоит ли человек в нужном канале/группе.

  2. Нужно подтвердить факт оплаты, если клиент получает доступ через платную подписку в Telegram.

  3. Важно запускать разные ветки сценария в зависимости от того, подписан пользователь или нет (например, дать доступ к урокам только подписчикам, а остальным предложить подписаться).

Как подготовить группу/канал

Перед настройкой сценария нужно получить ID нужной Telegram‑группы или канала.

  • Добавьте вашего Telegram‑бота в эту группу/канал.

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

  • После получения прав администратора в этой группе/канале отправьте команду get_id_group.

  • Скопируйте полученный ID — он понадобится при настройке условия.

Важный нюанс про ID группы

Обратите внимание: ID группы изменится, если в настройках Telegram группы вы поменяете «Тип группы» (с частной на публичную или наоборот). Можно работать со всеми типами групп telegram.

К примеру, была у вас группа "Частная" ID группы: 5689545, вы сменили на другой тип "Публичная" ID группы изменился: -10045658978.

После изменения типа группы/канала:

  • Повторно отправьте команду get_id_group в вашу группу.

  • Получите новый ID и обновите его в настройках проверки подписки в NEXTBOT.

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

Настройка сценария в NEXTBOT

  1. Откройте раздел «Сценарии» и создайте новый сценарий, например который запускается при старте диалога с новым пользователем. Назовите сценарий для удобства "Проверка telegram подписки"

  2. В блоке «Дополнительные условия» включите опцию «Проверка подписки Telegram».

  3. В блоке Условия нажмите на кнопку "Добавить группу/канал". В поле «Группа/канал» вставьте ID, который вы получили командой get_id_group. Либо: Это поле так же принимает ссылку на группу/канал вида: "@groupName", или ссылка "t.me/groupName.

  4. В параметре «Ожидание» выберите нужный статус:

    • «Пользователь подписан» или

    • «Пользователь не подписан»

Чтобы бот сообщал пользователю, что он не подписан на группу, настройте условие «Пользователь не подписан» и добавьте действие «Отправить сообщение».

  • В качестве текста сообщения можно указать, например: «Вы не подписаны на нашу группу. Пожалуйста, подпишитесь, чтобы получить доступ к материалам».

  • После этого при обращении нового пользователя к ИИ‑агенту бот проверит подписку и, если пользователь не состоит в группе, отправит указанное сообщение.

Как выдать боту права администратора

  1. В вашей Telegram-группе в правом верхнем углу нажимаем на "троеточие" и выбираем "Управление группой"

  2. Во вкладке "Администраторы" нажмите "Добавить администратора" и добавьте вашего Telegram бота.

  3. Готово

Last updated

Was this helpful?