Перейти к основному содержимому

Сценарии (доска с блоками)

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

Доска даёт три ключевые вещи:

  1. Видимость всей логики сразу — ни один блок не «теряется» в списке.
  2. Ветвление — кнопки и переходы рисуются стрелками.
  3. Скорость — Рецепты, Инструменты и буфер блоков.

Как открыть доску

Автоворонки → Цепочки → откройте цепочку → «Сценарий на доске» на нужном шаге (или кнопка Сценарий на доске в списке шагов).

Открытие доски сценария Скриншот 1. Кнопка «Сценарий на доске» в шаге цепочки.

«На этой платформе уже есть запущенные сценарии ботов»

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

Вопрос не формальный: без него на одно сообщение подписчика начинают отвечать сразу два бота — новый и забытый старый, — а причина такого поведения совершенно неочевидна.


Часть 1. Интерфейс доски

Тулбар снизу

КнопкаДействие
+ БлокДобавить новый блок на доску
ВставитьПоявляется, если в буфере есть скопированные блоки
РецептыСборка готового функционала одним действием (см. Часть 4)
ИнструментыМассовые операции над блоками (см. Часть 4)
НастройкиПараметры сценария: маркер старта, поведение по умолчанию
searchНайти блок или действие по тексту (см. ниже)
НазадВыйти к списку шагов цепочки (с напоминанием сохранить)
СохранитьЗафиксировать изменения. Без сохранения бот работает по старой версии

Тулбар доски

Скриншот 2. Панель инструментов доски.

Поиск по доске

Кнопка с лупой ищет по текстам, кнопкам, переменным, условиям и коду — и в блоках, и в их сценариях действий. Клик по найденному открывает нужный блок или нужное действие.

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

Запустить бота с этого блока

Наведите курсор на блок — во всплывающем меню первая кнопка play_circle_outline «Запустить бота с этого блока». Бот начнёт диалог не с начала сценария, а с выбранного блока: не нужно проходить десять шагов, чтобы проверить одиннадцатый.

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

Полотно (canvas)

  • Тащить блок — захват за заголовок.
  • Колёсико — масштабирование доски (zoom).
  • Колёсико + ПКМ / средняя кнопка — панорама полотна.
  • Стрелки между блоками — соединения. Создаются drag-and-drop из круглой точки (выход кнопки/блока) к следующему блоку.
  • Стартовый блок — отмечен флажком "СТАРТ", с него начинается диалог.

Часть 2. Добавление и удаление блоков

Добавить один блок

Кнопка «+ Блок» в тулбаре → на доске появится новый блок. Откройте его кликом, чтобы заполнить текст, кнопки, сценарий действий.

→ Подробно: Работа с блоками.

Добавить много блоков сразу

Инструменты«Добавление блоков» → укажите количество (до 1000) → опция «Добавить кнопки перехода» автоматически связывает их по цепочке.

Удобно для быстрого скелета сценария: 10 блоков опросника, или линейная воронка из 5 шагов.

Инструмент добавления блоков Скриншот 3. Массовое добавление блоков.

Удалить блоки

Инструменты«Удаление блоков» → отметьте нужные блоки. Опция «Удалить сценарии действий, привязанные к блокам» очищает и фоновую логику.

Удаление необратимо

Перед удалением воспользуйтесь «Копированием в буфер» — так блоки можно восстановить вставкой.

Назначить стартовый блок

Инструменты«Назначить блок стартовым». Старт — единственный блок, с которого бот начинает диалог. По умолчанию это первый созданный блок.


Часть 3. Соединения и ветвление

Связи между блоками рисуются стрелками. Они показывают, куда переходит бот после блока (или после нажатия кнопки в блоке).

Откуда идёт стрелка

ИсточникЧто значит
С самого блокаБот пойдёт к следующему блоку автоматически, без кнопки
С кнопки блокаПереход случится при нажатии конкретной кнопки
С «иначе» (по условию)Запасной переход, если условия других стрелок не сработали

Как нарисовать связь

  1. Наведите курсор на круглую точку у блока/кнопки — она подсветится.
  2. Зажмите ЛКМ и тяните до целевого блока.
  3. Отпустите — стрелка сохранится.

Как удалить связь

Кликните на стрелку → появится корзина → удалить. Или просто перетащите конец стрелки в пустую область.

Стрелки между блоками Скриншот 4. Соединения между блоками.

Поток без кнопок

Если в блоке нет кнопок — соединяйте сам блок со следующим переходом. Подписчик напишет ответное сообщение, и бот сразу пойдёт дальше.


Часть 4. Рецепты и Инструменты

В тулбаре доски две кнопки. Они делают разное, поэтому и разделены.

  • Рецепты — собирают за вас готовый работающий функционал: блоки, сценарии действий и настройки под типовую задачу. Нужны, когда вы хотите получить результат, а не разбираться в настройках.
  • Инструментымассовые операции над блоками: добавить, удалить, скопировать, перенести тексты. Нужны, когда правка вручную утомительна.
Новый сценарий предлагает Рецепт сразу

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

Рецепты

РецептЧто соберёт
5Автодобавление получателя заявок при запускеБот сам добавит вас как получателя уведомлений
6Сохранение ответов в списокВсе ответы клиента в выбранных блоках складываются в список
7Отправка заявкиБлок отправки сводной заявки получателю
8Создание переменнойПеременная и её присвоение в выбранных блоках
9Добавить оплатуБлок приёма платежа со ссылкой
10Добавить кнопку приложения ТелеграмКнопка с WebApp/MiniApp
15Запись на услугуПриложение-календарь, блок выбора времени и запись с напоминанием
16Каталог и заказПриложение-каталог с товарами, обработка заказа и ссылка на оплату
17ИИ-консультантОтветы на вопросы нейросетью, по желанию — по вашему файлу
18Рассылка по сегментуОтправка сообщения всем подписчикам из списка
19Кэшбэк за отзывПриём артикула и скриншота, заявка в список, начисление баллов
20Приём заявки в CRMИмя, телефон и вопрос клиента → сделка с контактом в amoCRM или Битрикс24
21Личный кабинет в приложенииМини-приложение с данными подписчика
22Курс с уроками и домашкамиУроки по расписанию, проверка домашних заданий куратором, продажа доступа
23Яндекс ДоставкаРасчёт и оформление доставки
24Группа или канал Telegram/МАКСБот, который работает внутри группы или канала
25Цифровые товары с выдачей после оплатыОплата и автоматическая выдача файла или ключа
26Гугл Таблица: добавление, изменение, чтениеГотовая связка с Google Таблицами
27Передача данных между ботамиОдин бот отдаёт данные другому
28Отметка вариантов выбора галочкойМножественный выбор кнопками
29Чек-листСписок задач с отметками о выполнении
30Листание спискаПостраничный вывод длинного списка
31Получение курса валютДанные ЦБ РФ, Белоруссии, Казахстана, Узбекистана
32Отслеживание перехода по внешней ссылкеПример работы с действием «Ссылки»
33Установить бота из своего архиваФайл выгрузки бота: блоки лягут на доску, остальное — в проект
Рецепт из готового бота

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

Рецепт 33 делает то же самое с вашим архивом — файлом выгрузки бота из конструктора. Магазины, записи на услуги и лендинги так не переносятся: это отдельные модули со своей связкой цепочек, и половина такого бота на доске не заработает. Такие боты ставятся целиком в разделе «Готовые боты».

Инструменты

ИнструментКогда использовать
1Добавление блоковСкелет сценария из N одинаковых блоков
2Удаление блоковМассовая чистка — выбор галочками
3Копирование блоков в буферПеренести часть сценария в другой шаг/цепочку
4Назначить блок стартовымПоменять точку входа
11Очистить буфер блоковСбросить скопированные блоки
12Очистить буфер действийСбросить скопированные сценарии действий
13Сохранить сообщения сценария в списокЭкспорт текстов всех блоков в список (для перевода, бэкапа)
14Заменить сообщения сценария из спискаИмпорт текстов обратно (после перевода/правок)

Меню Рецептов и Инструментов Скриншот 5. Меню массовых операций.

Кейс: запись клиентов за один шаг

Рецепт 15 «Запись на услугу» собирает связку целиком:

  1. Укажите название услуги, её длительность и за сколько минут напомнить клиенту.
  2. Рецепт создаст приложение-календарь, блок с кнопкой «Выбрать время» и блок обработки записи с подключённым сценарием действий.
  3. Переход между блоками уже настроен по ответу webapp:calendar — после возврата из календаря клиент попадает в блок подтверждения.

Рабочее время по умолчанию — пн–пт с 09:00 до 18:00, слоты по часу. Изменить расписание можно в самом приложении на странице «Приложения».

Длительность учитывается

Длительность передаётся приложению параметром duration — календарь не предложит время, на которое услуга не помещается до конца рабочего дня.

Кейс: продажа товаров из бота

Рецепт 16 «Каталог и заказ»:

  1. Укажите название каталога, валюту и — если нужна оплата — платёжную систему.
  2. Рецепт создаст приложение-каталог с тремя тестовыми товарами, блок с кнопкой «Открыть каталог» и блок обработки заказа со сценарием действий.
  3. Переход настроен по ответу webapp:catalog. Сценарий заберёт состав и сумму заказа в переменные #{orderlist} и #{ordersum}.
  4. Если платёжная система выбрана — сценарий сразу сформирует ссылку на оплату, а на доску добавится блок ожидания платежа (он вызывается уведомлением от платёжной системы, входящих переходов у него быть не должно).

Тестовые товары замените своими на странице «Приложения».

Кейс: курс с уроками и проверкой домашних заданий

Рецепт 22 «Курс с уроками и домашками» собирает обучение целиком: продажу доступа, цепочку уроков, приём работ и проверку куратором.

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

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

Что получится:

ЧастьКак работает
На доскеТри блока: витрина курса, платёжная ссылка и приём оплаты
ЗапускЦепочка уроков стартует по тегу курс …: начал. Тег вешает блок приёма оплаты — им и открывается доступ
УрокКаждый урок — три блока подряд: текст урока, задание и приём работы
РасписаниеПервый урок приходит сразу после оплаты, следующие — через заданное число дней
С домашкамиСледующий урок приходит после сдачи работы: пока приём не завершён, очередь цепочки стоит
ПроверкаКуратор получает работу и отвечает «Принято» или «На доработку». Комментарий уходит ученику
ОплатаБлок приёма платежа пишет строку в список Оплаты: название курса и вешает стартовый тег
ФиналШаг «Курс пройден» ставит тег о прохождении

Создаются три списка: Ученики: название, Оплаты: название и Куратор.

Домашки включаются переменной

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

Куратор и платёжная система

Куратор назначается после установки: отправьте боту команду из блока курса на доске — тот, кто её выполнил, и станет получателем работ. Куратор хранится в списке Куратор.

Платёжная система подставляется из настроек рецепта. Если вы её не выбрали, откройте сценарий действий «название — оплата доступа» и укажите свою — иначе ссылка на оплату не сформируется. Рецепт предупредит об этом при установке.

Цепочки курса получают канал той цепочки, из которой применён рецепт: ученик получает уроки там же, где покупал доступ.

Кейс: консультант на нейросети

Рецепт 17 «ИИ-консультант» создаёт два связанных блока — «Вопрос» и «Ответ» — и сценарий действий, который отправляет вопрос подписчика нейросети.

  • Ключ OpenAI не нужен. Запросы идут через аккаунт Квесчи, оплата списывается с баланса. Свой ключ можно указать позже в самом действии.
  • Инструкция задаёт роль консультанта: о чём отвечать, каким тоном, что делать при незнании ответа.
  • База знаний (файл) — необязательна. Если выбрать файл, добавленный на странице Списки → Ответ по файлу, бот будет отвечать по его содержимому.
  • Контекст беседы можно выключить — тогда каждый вопрос обрабатывается отдельно и стоит дешевле.

После ответа бот возвращается к блоку вопроса, поэтому диалог не обрывается — подписчик может спрашивать дальше.

Кейс: рассылка по своей базе

Рецепт 18 «Рассылка по сегменту» отправляет сообщение всем подписчикам, записанным в список.

  1. Соберите базу рецептом 6 «Сохранение ответов в список» — он записывает ClientID, Messenger и BotID подписчика автоматически.
  2. В рецепте 18 выберите этот список и напишите текст.
  3. Рассылка уйдёт при прохождении блока, а число получателей вернётся в переменной #{bccount}.
Список должен содержать поля подписчика

Без ClientID, Messenger и BotID отправлять некому — такие списки в выборе помечены и недоступны.

Как запускать рассылку вручную

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

Кейс: кэшбэк за отзыв на маркетплейсе

Рецепт 19 «Кэшбэк за отзыв» создаёт три связанных блока — «Артикул товара», «Скриншот отзыва», «Заявка принята» — и сценарий действий.

  1. Бот спрашивает артикул (ответ сохраняется в переменную #{cbarticle}) и скриншот отзыва (ссылка попадает в #{media_url}).
  2. Заявка пишется в созданный список «Заявки на кэшбэк» со статусом.
  3. Получателю заявок уходит уведомление со всеми данными.
  4. Если включено «Начислять сразу, без проверки» — баллы падают на баланс подписчика немедленно; иначе заявка ждёт ручной проверки.
Нужен получатель заявок

Уведомление уходит на переменные #{clientid}, #{messenger}, #{botid} — их заполняет рецепт 5 «Автодобавление получателя заявок при запуске». Примените его первым, иначе уведомление уйдёт в пустоту.

Проверка отзыва — ручная

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

Кейс: заявки из бота попадают в CRM

Рецепт 20 «Приём заявки в CRM» создаёт цепочку блоков — «Имя клиента», «Телефон», по желанию «Вопрос клиента», «Заявка принята» — и сценарий действий, который создаёт сделку с привязанным контактом.

  1. Выберите подключённую CRM, а затем воронку и этап — они подставляются списком из состава полей вашей CRM. ID вводить не нужно.
  2. Ответы клиента сохраняются в переменные #{leadname}, #{leadphone} и #{leadcomment}.
  3. В CRM создаётся сделка «Заявка из бота: имя» с контактом, а полный текст заявки пишется примечанием — менеджер видит всё в одном месте.
  4. Получателю заявок уходит уведомление.
Куда попадёт телефон

В Битрикс24 телефон ложится в поле контакта — оно там стандартное. В amoCRM телефон — дополнительное поле, поэтому конструктор ищет его в составе полей по названию. Если поле не нашлось, в уведомлении об этом скажут, а телефон всё равно попадёт в примечание сделки — менеджер его увидит.

Состав полей подтягивается при подключении CRM. Если он не загружен, откройте Интеграции → «Связь с ботом» и нажмите «Обновить состав полей».

Нужен получатель заявок

Как и в остальных рецептах, уведомление уходит на переменные #{clientid}, #{messenger}, #{botid} — их заполняет рецепт 5. Примените его первым.

Сделка на каждое обращение — без рецепта

Если сделка нужна при первом обращении любого подписчика, а не после заполнения формы, рецепт не нужен: включите переключатель в Интеграции → «Связь с ботом».

Кейс: перевод бота на другой язык

  1. Инструмент 13 — сохранить тексты в список.
  2. Откройте список, переведите столбец с текстом.
  3. Инструмент 14 — загрузить переведённые тексты обратно.

Кейс: копия логики в другую цепочку

  1. Откройте сценарий-источник.
  2. Инструмент 3 — скопировать выбранные блоки.
  3. Откройте сценарий-приёмник, нажмите «Вставить» в тулбаре.

Часть 5. Буфер блоков и копирование

Буфер живёт между сценариями всей автоворонки. Скопированные блоки доступны:

  • из любой цепочки;
  • между шагами одной цепочки;
  • между ботами в пределах автоворонки.

Вставка через кнопку «Вставить» в тулбаре (появляется, только если в буфере что-то есть).

Очистка буфера — Инструмент 11 (блоки) или 12 (действия).


Часть 6. Сохранение сценария

Доска не сохраняется автоматически. Кнопка «Сохранить» в тулбаре — обязательна.

  • Несохранённый сценарий клиент не получит — бот работает по предыдущей версии.
  • При выходе («Назад») система переспросит, если есть несохранённые изменения.
  • Сценарий можно копировать между ботами через списки (Инструменты 13/14).

Часть 7. Архитектура сценария

Принцип 1. Один сценарий — один диалог

Не пихайте в одну доску всю логику бота. Каждый сценарий = один связный разговор: «приветствие», «выбор товара», «оплата», «получение адреса доставки».

Принцип 2. Кнопки вместо текста, где можно

  • Кнопки исключают опечатки и непредсказуемые ответы.
  • Свободный ввод оставляйте для имени, телефона, email, комментариев.
  • Используйте InsertButton и шаблон [Answer1] для ссылки на ответ.

Принцип 3. «Иначе»-ветка обязательна

В каждом блоке-вопросе должна быть запасная стрелка «иначе» — что делать, если клиент написал не то. Иначе бот зависнет.

Принцип 4. Старт всегда один

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

Принцип 5. Длинные сценарии разбивайте на более мелкие

Если на доске больше 30-40 блоков — пора разрезать сценарий на 2-3. Маленькие сценарии быстрее открываются и проще отлаживаются.

Принцип 6. Каждое сложное действие — в сценарий действий

Запросы к API, расчёты, работа со списками — не делайте через множество блоков. Один блок + сценарий действий справится лучше.


Частые ошибки

  • «Сохранил, но не работает» — забыли сохранить именно доску (в тулбаре), а сохранили только настройки цепочки.
  • Несколько стартовых блоков — бот выбирает случайный. Назначьте стартовый через Инструмент 4.
  • «Висячая» кнопка без стрелки — клиент нажал, ничего не произошло. Проверьте, что у каждой кнопки есть переход.
  • Блок-сообщение без выхода — диалог обрывается. Добавьте переход к следующему блоку или к финальному «Спасибо».
  • Очень много блоков на одной доске — лагает интерфейс. Разделите на шаги цепочки.
  • Массовую операцию применили не к тем блокам — отменить нельзя. Перед массовыми операциями сохраняйтесь и копируйте в буфер.

Что дальше