ym88659208ym87991671
Настраиваем сценарий | Документация для разработчиков

Добавляем блоки на экран

Обновлено 16 июня 2025

Настроить сценарий чат-бота можно с помощью блоков.

Блок — это минимальная единица, из которой строится сценарий чат-бота. Блок задает действие, которое чат-бот совершит в процессе диалога с пользователем. Например:

  • вывод текста и изображений на экран;
  • перевод в режим ожидания действия пользователя, например, ввода фразы;
  • выполнение фоновых действий, например, HTTP-запросов.

Описание каждого из блоков Graph вы найдете в соответствующем подразделе.

Как работают блоки

Блоки добавляются на экран чат-бота.

При запуске чат-бот последовательно, сверху вниз выполняет все блоки, заданные на экране.

При работе с представленным экраном чат-бот будет действовать в следующей последовательности:

  1. Выведет сообщение «Привет!» из первого блока Текст.
  2. Выведет сообщение «Ты хочешь поучаствовать в нашей программе?» из второго блока Текст.
  3. Выполнит блок Интенты: будет ждать реакции пользователя и, в зависимости от ответа, выполнит следующее необходимое действие.

Связи блоков

Некоторые блоки обладают точкой выхода, которая позволяет соединять их с другими экранами. При достижении такого блока (и выполнении соответствующих условий), чат-бот переходит к связанному экрану и выполняет заданные на нем блоки.

В приведенном примере, после того как чат-бот скажет «Привет!» и «Ты хочешь участвовать в нашей программе?», чат-бот будет ждать реакции пользователя. Если пользователь скажет «да», то ответ пользователя попадет в интент Согласие, и чат-бот перейдет к связанному экрану.

Добавление блоков

Блоки можно добавлять как на новые, так и на уже существующие экраны.

Добавление блока новый экран

Чтобы добавить блок на новый экран сценария:

  1. Нажмите кнопку Добавить экран.

    Откроется список всех блоков.

  2. Выберите блок из списка и заполните его параметры.

  3. Сохраните блок.

Будет создан новый экран, с заданным блоком.

Добавление блока на существующий экран

Чтобы добавить блок на существующий экран:

  1. Наведите курсор на экран, куда требуется добавить блок.
  2. Нажмите кнопку Добавить блок.
  3. Выберите блок из списка и заполните его параметры.
  4. Сохраните блок.

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

Например, на экран с блоком HTTP-запрос нельзя добавить блоки Ввод текстаВвод числаНомер телефонаИнтенты и другие. Это связано с тем, что блок HTTP-запрос предполагает дальнейшие действия, после которых эти блоки станут недоступны.

Параметры блока

Блоки обладают параметрами, которые определяют логику чат-бота.

Например:

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

Изменение названия блока

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

Вы можете изменить название, чтобы лучше ориентироваться в сценарии чат-бота.

Для этого:

  1. Откройте блок.
  2. Нажмите на название блока.
  3. Укажите новое название.

Переменные

Во время работы чат-бота может понадобиться получить от пользователя или сторонней системы какие-нибудь данные. Чат-бот может использовать такие данные, чтобы, например, принять решение о следующих шагах в сценарии или передать эту информацию в сторонний сервис.

Некоторые блоки, например, Ввод числа или Ввод текста, создают переменные с определенным именем, куда сохраняют полученные в этом блоке данные. Так, блок Ввод числа сохранит в переменную $number число, которое ввел пользователь.

Эта переменная будет доступна на всех следующих экранах сценария в рамках текущей сессии пользователя. Как правило, при настройке блока вы указываете название переменной, а затем можете обратиться к ней на следующих шагах, поставив перед именем переменной знак $.

Управление блоками

Блоки можно копировать и вырезать, чтобы добавить их на уже существующие экраны. Связи блоков не копируются при этом.

Чтобы копировать или вырезать блок:

  1. Откройте меню в правой части блока.

  2. Выберите пункт Скопировать или Вырезать.

    Вы можете отменить вырезание блока с помощью клавиш CTRL+Z.

  3. Откройте меню в правом верхнем углу экрана, на который надо вставить блок.

  4. Выберите пункт Вставить блок.

Блок нельзя вставить на экран, если он содержит несовместимые блоки.

Если клиент был неактивен в течение 12 месяцев, его контекстные данные будут очищены.

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.