Документация / Сценарии

Конструктор сценариев

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

Работа на холсте

Перетащите узлы из палитры на холст и соедините их, перетаскивая от коннектора одного узла к другому. Выбор узла открывает его настройки — у каждого типа узла своя форма (триггер по ключевому слову спрашивает режим совпадения, триггер по расписанию — интервал и время, HTTP-узел — URL и метод).

Редактируемый черновик приватен: подписчики всегда видят только опубликованный сценарий. Это разделение означает, что вы можете безопасно дорабатывать работающего бота — для вашей аудитории ничего не меняется, пока вы не нажмёте «Опубликовать».

Семейства узлов

СемействоУзлыДля чего это нужно
ТриггерыКоманда (/start…) · Ключевое слово (содержит / точное совпадение / regex) · Нажатие кнопки · Инлайн-запрос · Присоединение участника · Расписание (ежечасно → ежегодно, произвольные интервалы) · Входящий вебхук · Заказ оплаченОткуда начинается сценарий. Каждому сценарию требуется хотя бы один триггер.
СообщенияТекст · Медиа (фото / видео / документ / аудио) · Инлайн-клавиатура · Клавиатура ответа · Опрос · Местоположение · Редактировать сообщение · Удалить сообщение · Индикатор набора текстаЧто отправляет бот. Кнопки несут значения, которые могут снова войти в сценарии в качестве триггеров нажатия кнопки.
ЛогикаУсловие · Switch (многовариантное ветвление) · A/B-разделение · Задержка · Шлюз · Переход (к другому узлу) · Установить переменную · КонецВетвление и темп. A/B-разделения делят аудиторию на помеченные группы, чтобы последующие сценарии могли нацеливаться на каждую из них.
ДанныеHTTP-запрос · Вопрос (собрать ответ) · RSS-лента · Установить атрибут · Уведомить вебхукВзаимодействие с внешним миром: запросы к API, сохранение атрибутов подписчиков, отправка событий.
РостГлубокая ссылка · Капельная кампания · Принадлежность к сегменту · Передача операторуПривлечение и удержание. Капельная кампания отправляет последовательность по времени; сегменты питают рассылки.
МагазинКаталог · Товар · Корзина · Оформление заказа · ЗаказыПродавайте физические или цифровые товары прямо в чате с историей заказов по каждому подписчику.
ИИОтвет ИИГенерирует ответ на основе контекста разговора. Доступно для продуктов с пометкой «поддержка ИИ».
БронированиеПодтвердить бронирование · Отменить бронирование · Список бронированийСценарии в стиле записи на приём: резервируйте слоты и управляйте ими прямо из чата.
МедиаQR-кодСоздавайте QR-коды прямо в сценарии, например для билетов и платёжных реквизитов.

Какие узлы открывает ваша линейка

Заблокированные узлы отображаются в палитре со значком и объяснением в один клик о том, что необходимо. Если вы попытаетесь использовать заблокированный тип узла через API, вы получите понятную ошибку, а не тихий отказ.

ВозможностьДоступность
Базовые узлы (триггеры, сообщения, базовая логика, данные)Все линейки
Расширенные узлы — A/B-разделение, Switch, HTTP-запрос, капельная кампания, сегмент, входящий вебхук, расписание, инлайн-запрос, опросЛинейка Professional и выше
Узлы магазина — каталог, товар, корзина, оформление заказа, заказыЛинейка Professional и выше
Передача живому операторуЛинейка Enterprise
Ответ ИИПродукты с пометкой «поддержка ИИ» (Core и выше на Startup)

Предпросмотр, журналы, публикация, откат

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

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

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

Впервые здесь? Наше быстрое начало проведёт вас через создание первого бота от начала до конца примерно за десять минут.

Читать дальше

Приём медиа: запрашиваем фото и файлы

Шаг «Запросить файл или фото» приостанавливает диалог, пока подписчик не пришлёт фото или документ. Файл загружается в медиатеку воркспейса, а ссылка попадает в переменную — прикрепите её к передаче человеку, чтобы мастер, оценщик или рекрутер видел ровно то, что прислал клиент, или уйдите внешним вебхуком во внешнюю систему.\nЕсли загрузка не удалась, бот переспрашивает, а не продолжает с пустым значением — потерянное фото никогда не превратится в пустое поле дела. Входящие файлы сами по себе не запускают ни одного триггера: они отвечают только на ожидающий шаг запроса.

Рефералы, листы ожидания, языки и журнал комиссий

Шаги роста закрывают механику распространения Telegram-ботов: «Реферальное приглашение» отправляет каждому подписчику личную ссылку (награды следуют вашим настройкам, а при выключенных рефералах шаг честно об этом говорит), а «Запись в лист ожидания» добавляет людей в очередь с живой позицией — продвижение делается рассылкой по сегменту листа.\n«Маршрутизатор языков» ветвится по языку Telegram каждого подписчика, поэтому один бот может обслуживать международную аудиторию языковыми поддеревьями. Для маркетплейсов «Запись комиссии» пишет долю продавца с каждой продажи в журнал, который вы выгружаете и закрываете, — учёт ведёт бот, движение денег держите вы.