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

Работа с блоками

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

Каждый блок отвечает за один акт коммуникации:

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

Как открыть блок​

На доске сценария кликните по блоку → откроется редактор блока в полноэкранном режиме.

Открытие блока Скриншот 1. Редактор блока.

Часть 1. Содержимое блока​

Текст сообщения​

Главное поле блока. Поддерживает:

Для подстановки переменных и шаблонов используйте кнопку «Подстановки» под полем ввода.

Медиа​

В блок можно прикрепить:

  • Изображение (jpg, png, webp);
  • Видео (mp4, mov);
  • Аудио / голос (mp3, ogg, oga);
  • Документ (pdf, doc, xls и т.д.);
  • Стикер / GIF.

Медиа в блоке Скриншот 2. Прикрепление медиа.

В настройках кнопок (см. ниже) есть опции:

  • Сгруппировать медиа — несколько одинаковых медиа отправятся одним сообщением (альбомом). От 2 до 10 штук, для картинок и PDF.
  • Сообщение вместе с медиа — текст подпишется под медиа, а не отдельным сообщением.

Часть 2. Кнопки​

Кнопки — главный инструмент управления диалогом. Они исключают опечатки и явно ведут клиента дальше.

Типы кнопок​

ТипЧто делает
Ссылка (URL)Открывает внешний сайт / WebApp / MiniApp / Ссылку на оплату
ТегиДобавляет/Удаляет теги
БлокНажатие переводит на указанный блок сценария
ЗначениеПрисваивается в качестве ответа подписчика
НазадВозвращает сценарий на шаг назад
ЗавершитьЗавершение сценария

Настройки кнопок

Скриншот 3. Типы кнопок.

Настройки рядов и поведения​

Кнопка settings в правом верхнем углу блока открывает настройки для каждого мессенджера отдельно. Вкладки: Telegram, MAX, VK.

Настройки кнопок

Скриншот 4. Настройки кнопок по мессенджерам.

Telegram — основные опции​

ОпцияНазначение
Кнопок в рядуСколько кнопок в одной строке. Последнее значение применяется ко всем следующим рядам
Кнопки под сообщениемInline-клавиатура (по умолчанию). Если убрать — кнопки будут под полем ввода (reply-клавиатура)
Сгруппировать медиаАльбом из 2-10 однотипных медиа
Сообщение вместе с медиаТекст идёт подписью к медиа
Очистить клавиатуруУбрать кнопки под полем ввода (для запроса контакта/локации не использовать)
Запрос номера телефонаКнопка получит номер. Сохраняется в #{client_phone}
Запрос месторасположенияКоординаты в #{client_latitude} и #{client_longitude}
Заменить предыдущее сообщениеПредыдущее сообщение удаляется перед отправкой нового
Отключить предпросмотр ссылокУбирает превью URL в сообщении
Отключить звуковое уведомлениеТихая отправка
Защищённое сообщениеПодписчик не сможет переслать/сохранить
Приём трансляции геопозицииLive-локация — координаты обновляются в #{client_latitude}, #{client_longitude}. При обновлении вызывается блок с этой отметкой

MAX и VK​

Свои наборы настроек на отдельных вкладках. Делайте настройки для всех мессенджеров, в которых работает бот.

Кнопка контакта/локации — особый случай

Она всегда первая в ряду. Не сочетайте её с инлайн-клавиатурой («Кнопки под сообщением») — Telegram такое не поддерживает.

Часть 3. Ожидание ответа и переход «иначе»​

Свободный ввод от клиента​

Если в блоке предусмотрен текстовый ответ — бот его ждёт. Ответ становится доступен в шаблоне [Answer] или [AnswerN] (где N — номер блока) или [AnswerID(ID блока)].

Сохранить ответ в переменную/список можно через Сценарий действий → операцию «Ответ».

Запасной переход «иначе» (wronganswer)​

Если клиент написал не то, что ожидалось (не нажал кнопку, написал текст вне условий) — должен сработать запасной переход.

В блоке выберите «Блок при неправильном ответе» → укажите блок, куда увести клиента. Обычно — «Повтори вопрос» или «Я не понял».

Без «иначе» диалог зависает

Если в блоке кнопки + ожидание текста, а ни одно условие не сработало — бот молчит. Всегда настраивайте wronganswer для блоков-вопросов.

Wronganswer — запасной переход

Скриншот 5. Настройка запасного перехода.

Часть 4. Условия и проверки​

В блоке можно настроить условные переходы — стрелка пойдёт только при выполнении проверки.

Виды проверок​

  • Сравнение значений: #{age} > 18, [Answer1] = да.
  • Содержит / не содержит: [Answer1] INCLUDE доставка.
  • И: #{x} = 1 & #{y} > 5.
  • ИЛИ: #{x} = 1 | #{y} > 5.

Конструктор условия позволяет добавлять символы кнопками: +, -, *, /, (, ), &, |, =, !=, >, >=, <, <=, Содержит, НЕ содержит.

Конструктор условий

Скриншот 6. Конструктор условного перехода.

Несколько условий​

  • Выполняется первое истинное условие

Часть 5. Сценарий действий блока​

В блоке доступны две точки для подключения фоновой логики:

  • До отправки — действия выполняются перед показом сообщения клиенту. Используйте для расчётов, чтения списков, формирования персонального контента.
  • После отправки — действия после показа. Удобно для логов, постановки тегов, уведомлений менеджеру.

Кнопка «Добавить новый сценарий действий» под списком выбора сценария действий создаёт новый сценарий действий.

Сценарии действий до и после

Скриншот 7. Сценарий действий «до» отправки блока.

→ Подробно: Сценарии действий.

Часть 6. Задержка отправки​

У каждого блока можно задать задержку — за сколько отправить сообщение после предыдущего блока:

  • Сразу — без задержки;
  • Минуты / часы / дни — отложить.

Задержка отправки

Скриншот 8. Настройка задержки и времени отправки.

Опции расписания (вне сценария):

  • В любое время — отправить как только подошёл срок;
  • В заданное время — отправить только в окно (например, не ночью, а с 9 до 21).

Используйте задержки в рассылках-дожимах. В блоках основного диалога обычно «Сразу».

Часть 7. Архитектура блока​

Принцип 1. Один блок — одна задача​

Не пихайте 5 вопросов в один блок. Каждый вопрос — отдельный блок с отдельным ответом [Answer1], [Answer2].

Принцип 2. Кнопки лучше свободного ввода​

Где можно — давайте кнопки. Свободный ввод оставляйте для имени, телефона, email, комментариев.

Принцип 3. Используйте подстановку, а не статику​

Здравствуйте, [Name]! лучше, чем Здравствуйте, друг!. Клиент чувствует, что его «узнают».

Принцип 4. Тяжёлая логика — в сценарий действий​

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

Принцип 5. Запасной переход обязателен​

Каждый блок-вопрос должен иметь wronganswer. Не понимаете, куда уводить? Уведите на тот же блок — пусть переспросит.

Принцип 6. Настройки для каждого мессенджера​

Если бот работает в Telegram + MAX — заполните обе вкладки настроек кнопок. Конфигурация Telegram не переносится на MAX автоматически.

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

  • Пустой блок без перехода — диалог обрывается. Добавьте кнопку или авто-переход к следующему блоку.
  • Кнопка без целевого блока — нажатие = тишина. Нарисуйте стрелку на доске.
  • [Answer] вместо [Answer1] — [Answer] это последний ответ, а вам, возможно, нужен конкретный блок.
  • Не настроен wronganswer для вопросов — бот не реагирует на «неправильный» ответ.
  • Запрос контакта/локации + кнопки под сообщением — Telegram не позволит сочетание. Уберите одну опцию.
  • Группировка медиа разных типов — не сработает. Альбом только из одинаковых (только картинки или только PDF).
  • Подстановка переменной с ошибкой в имени — клиент получит пустоту. Проверяйте имя через кнопку «Подставить».

Что дальше​