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

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

Никакого программирования. Всё, что умеет бот, собирается из готовых кубиков.

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

Где он находится#

Откройте бота и перейдите на вкладку Flow Settings. Это и есть конструктор: на весь экран, слева — набор шагов, посередине — холст, сверху — панель инструментов.

Конструктор сценариев: набор шагов слева, холст со схемой, панель сверху

  1. Набор шагов. Перетаскивайте отсюда на холст. Разбит на группы: Communication, Changes, Terms, Tracking, Additional.
  2. Start. Точка входа: отсюда бот начинает с каждым новым человеком. Удалить этот шаг нельзя.
  3. Развилка — шаг Condition. У него несколько выходов.
  4. Ветки после развилки. Слева — тем, кто уже вносил депозит, справа — всем остальным.
  5. Save. Пока не нажали — правок нет.
  6. Активный сценарий. Щелчок открывает список всех сценариев бота и переключает рабочий.

Если вы зашли сюда впервые, система сама создаст сценарий с именем default и поставит на холст единственный шаг — Start. Это точка входа: отсюда бот начинает разговор с каждым новым человеком.

Из чего состоит схема#

ЧастьЧто это
Шаг (карточка на холсте)Одно действие: отправить сообщение, подождать, поставить тег, проверить условие.
Стрелка (связь)Куда бот пойдёт после этого шага. Нет стрелки — бот останавливается.
StartПервый шаг. Удалить его нельзя: без него схеме неоткуда начаться.
ЗаметкаЖёлтый листок для себя. Бот его не видит, на диалог он не влияет.

Как собрать первый шаг#

  1. Слева, в наборе шагов, найдите группу Communication и перетащите на холст Send message.
  2. Соедините Start и новый шаг: потяните мышью от кружка снизу карточки Start к кружку сверху новой карточки.
  3. Дважды щёлкните по новой карточке — справа откроется окно редактора шага.
  4. Напишите текст сообщения и закройте окно.
  5. Нажмите Save в панели сверху.

Готово. Теперь каждому, кто напишет боту впервые, придёт это сообщение.

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

Какие бывают шаги#

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

Communication — что бот говорит

ШагЧто делает
Send messageОтправляет сообщение: текст, фото, видео, файл, голосовое, кружок. Здесь же кнопки. Самый большой и самый частый шаг — подробно.
AI ReplyОтвет, придуманный искусственным интеллектом по вашему описанию.
Custom pushДогоняющее сообщение, если человек замолчал.

Changes — что бот меняет в карточке человека

ШагЧто делает
Change tagСтавит или снимает теги.
Change flowПереводит человека в другой сценарий.
OperatorНазначает диалог конкретному сотруднику.
Change sale statusДвигает человека по воронке продаж.

Terms — куда бот сворачивает

ШагЧто делает
ConditionРазвилка: проверяет данные человека и пускает по одной из веток.
A/B routerРазвилка вслепую: делит людей в заданной пропорции, чтобы сравнить два варианта.
DelayПауза перед следующим шагом.

Tracking — что бот сообщает наружу

ШагЧто делает
Send eventОтправляет событие воронки: Subscribe, Registration, Deposit, Redeposit.
WebhookДёргает чужой адрес в интернете — связка со сторонними системами.

Additional

ШагЧто делает
NoteЗаметка для вас. На бота не влияет.

Настройки, которые есть у каждого шага#

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

Title — название шага. Обязательное. Именно оно видно на холсте и в проходимости шагов, поэтому «Вопрос про опыт» полезнее, чем «Сообщение 3». Без названия шаг не сохранится: поле подсветится красным.

Delay — пауза перед шагом. Четыре поля: дни, часы, минуты, секунды. Под ними система тут же показывает, сколько получилось всего, и дни складывает в часы: 30 дней 3 часа превращаются в 723 часа. Это удобно для проверки — легко ошибиться полем и вместо трёх минут поставить три часа.

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

Finish status — каким станет диалог после шага. Можно ничего не менять, а можно перевести:

ЗначениеЧто означает
NothingНе трогать статус. Обычный выбор.
autoДиалог ведёт бот.
manualДиалог передан живому сотруднику.
waitingЖдём ответа человека.
blockedДиалог заблокирован.
finishedРабота с человеком закончена.

У waiting появляется дополнительная галочка «не переходить к следующему шагу». С ней бот остановится и будет ждать, вместо того чтобы сразу идти дальше по стрелке.

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

Is start step of flow — сделать шаг стартовым. Отсюда начнётся сценарий. Стартовый шаг в схеме один.

У двух шагов общей части нет или она урезана: у Delay и Condition своей паузы не бывает — первый и так пауза, второй мгновенно проверяет условие и уходит по ветке.

Панель инструментов#

Сверху над холстом:

  • Название сценария — щелчок открывает список всех сценариев этого бота и переключает активный.
  • Поиск — начните печатать имя шага, и холст сам подъедет к нему. Удобно, когда шагов несколько десятков.
  • Save — сохранить. Без него правки не применяются.

Как проверить, что всё работает. Напишите своему боту в Telegram с личного аккаунта. Диалог появится во вкладке Messenger, и вы увидите ровно то, что получит настоящий клиент. Если вы уже писали этому боту раньше, сценарий сработает не сразу: он запускается для нового человека. Проще завести второй аккаунт для проверки.

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

Бот молчит. Проверьте по порядку: от Start идёт стрелка; сценарий сохранён; бот включён; на балансе компании есть деньги.

Бот отвечает не тем. Скорее всего, у бота выбран другой сценарий. Активный виден в панели сверху — там же его и меняют.

Часть людей проходит мимо шага. Так и должно быть, если выше по схеме стоит Condition или A/B router. Пройдите путь глазами от Start до нужного шага.