# Конструктор анкет

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

> **Примечание:** Для лучшего понимания концепции анкет, начните думать про эти объекты, как о контейнере (или группе изолированных узлов), внутри которого вы можете создавать сколько угодно узлов для каждого из мессенджеров.

Процесс создания анкеты (или сценария) мало чем отличается от создания обычного узла в дереве узлов, который был описан в разделе Визуальный конструктор чат-ботов.

Быстрая навигация:

* Создание новой анкеты
* Таймаут анкеты
* Общие настройки анкеты
* Вопросы и скоринг
  * Вопросы анкеты
  * Условия для ответов
  * Скоринг ответов
  * Настройка скоринга у вопроса

<figure><img src="/files/8IvEenLz7ZmgxrMlzM9K" alt=""><figcaption></figcaption></figure>

### Создание новой анкеты

Нажмите на кнопку «Создать анкету».

<figure><img src="/files/B7raeWcLtbgohgDMTFOe" alt=""><figcaption></figcaption></figure>

Введите название анкеты.

<figure><img src="/files/QJ5MnAxJmvYU1nJ43QXL" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/QhPYWM6B17rmlVVK9XmA" alt=""><figcaption></figcaption></figure>

Главный экран анкеты вы можете увидеть при клике на кнопку «Подробнее».

<figure><img src="/files/KBlbPTkfYeqQigHCDcKg" alt=""><figcaption></figcaption></figure>

### Таймаут анкеты

В анкетах вы можете выставить таймаут (прерывание выполнения анкеты с переходом в «узел-заглушку») на взаимодействие с анкетой для одного и того же пользователя.

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

<figure><img src="/files/clcatyLGLt4sHWdLhGfZ" alt=""><figcaption></figcaption></figure>

Для создания таймаута, перейдите в настройки, кликнув на кнопку «Ред.» (здесь и далее, сокращение от слова «редактирование»).

<figure><img src="/files/YHH3JQ8EqMv61YxXCDQx" alt=""><figcaption></figcaption></figure>

1. Количество дней для перерыва показа анкеты одному и тому же пользователю;
2. Установка таймаута: дни, часы, минуты;
3. Выходной узел, если пользователь обратился к анкете во время таймаута;

### Общие настройки анкеты

<figure><img src="/files/iJ3JelgtS7HtsZM3DkAE" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/pH1RwDHoCPCR8SosGapp" alt=""><figcaption></figcaption></figure>

1. Название анкеты;
2. Сообщение, которое будет показано ПЕРЕД началом анкеты;
3. Сообщение, которое будет показано ПОСЛЕ завершения анкеты;
4. Список email адресов, на которые будет отправлены результаты заполнения анкет от каждого пользователя;
5. Узел, в который перейдет пользователь после заполнения анкеты;
6. Конфигурация HTTP запроса;
7. Изолированный Интеграционный слой анкеты;

### Вопросы и скоринг

<figure><img src="/files/hErGfVONfAoQgHEjcMAl" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/oodX9zsyeCkaxlEfbaQJ" alt=""><figcaption></figcaption></figure>

1. Строка поиска вопросов;
2. Переключение между мессенджерами;
3. Список категорий для скоринга;

#### Вопросы анкеты

Для создания нового вопроса, кликните на кнопку со знаком «+».

<figure><img src="/files/y0WmO8dJiwG7w8k8Ole7" alt=""><figcaption></figcaption></figure>

Узел-вопрос будет создан автоматически в дереве вопросов. У каждого вопроса есть контекстное меню, по нажатию на правую кнопку мыши.

<figure><img src="/files/FyMaGenOW6VWSzRkwj1p" alt=""><figcaption></figcaption></figure>

В контекстном меню вы можете выбрать:

* Создать новое условие для вопроса;
* Переименовать вопрос;
* Удалить вопрос;
* Дублировать вопрос;

> **Примечание:** Обратите внимание, что при дублировании вопроса происходит полное копирование всех его настроек, свойств и дизайна для всех мессенджеров, которые были настроены.

<figure><img src="/files/ufJ0UnzlNysGYYkRcaTY" alt=""><figcaption></figcaption></figure>

Далее, вам будут доступны следующие блоки:

1. Название узла;
2. Блок с выбором мессенджеров (для реализации дизайна);
3. Блок для реализации дизайна вопроса для каждого из мессенджеров;

<figure><img src="/files/v35DB2g7r0jaU4uyvSq7" alt=""><figcaption></figcaption></figure>

У каждого вопроса вы можете настроить следующие параметры (открываются по клику на первую кнопку «Общие» в блоке с мессенджерами):

1. Имя переменной (внутренняя информация платформы, нельзя изменить, присваивается при создании нового вопроса);
2. Разрешить/Запретить текстовый пользовательский ввод в ответе на этот вопрос;
3. Разрешить/Запретить отправку картинок/видео/файлов от пользователя в ответе на этот вопрос;
4. Разрешить/Запретить отправку *чужого* контакта от пользователя в ответе на этот вопрос (только для мессенджеров Telegram и Viber);
5. Разрешить/Запретить отправку *своего* контакта от пользователя в ответе на этот вопрос (только для мессенджеров Telegram и Viber);
6. Разрешить/Запретить отправку текущей геопозиции;
7. Значение, которое получит этот вопрос по умолчанию (*даже если пользователь ничего не ответит на него и/или вопрос будет пропущен программно*);
8. Позволяет сохранить значение (ответ), полученное от пользователя в качестве ответа на данный вопрос в переменную;
9. Позволяет указать сообщение, которое будет отправлено пользователю, в ответ на некорректные данные от него (разрешен только обычный текст);
10. Позволяет указать паттерн регулярного выражения, по которому будет проходить проверку пользовательский ответ;

#### Условия для ответов

<figure><img src="/files/yTA5gUF07NUGt0Bc2G4c" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/sua2WI3UKUgwqwxISbu7" alt=""><figcaption></figcaption></figure>

1. Название условия;
2. Условие, если последний ответ равен указанному значению;
3. Условие, если контекст равен cookies (**УСТАРЕВШЕЕ**);
4. Условие, если накопленный к тому моменту скоринг равен указанному значению;
5. Действие: если условие соблюдено, то переключиться на указанный вопрос этой анкеты;
6. Действие: если условие соблюдено, то остановить анкету и выйти в указанный узел чат-бота;
7. Сохранять/Удалить накопленные ответы пользователя в переменные;
8. Выполнить/Пропустить ли сценарий в изолированном интеграционном слое анкеты при выходе;

#### Скоринг ответов

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

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

<figure><img src="/files/BnMZBIqagiwuc1BBpE2E" alt=""><figcaption></figcaption></figure>

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

> **Примечание:** Это сделано специально, чтобы можно было гибко настраивать сценарии анкеты, ориентируясь сразу на несколько групп скоринга, без необходимости разделять сценарий на несколько атомарных анкет.

<figure><img src="/files/2Q1KD06BXFyK9YRBhzmT" alt=""><figcaption></figcaption></figure>

#### Настройка скоринга у вопроса

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

<figure><img src="/files/IM5FnRp1uI5fYAVPZMqL" alt=""><figcaption></figcaption></figure>

Настроить скоринг для вопроса вы можете в специальном блоке настроек.

1. Выбор вопроса;
2. В блоке с мессенджерами кликните на кнопку «Скоринг»;
3. В открывшимся меню настроек введите:
4. Ответ (фактический ответ от пользователя);
5. Категорию скоринга;
6. Действие со значением скоринга, накопленным на данный момент (сложить, вычесть, умножить, разделить);
7. Само значение скоринга для данного вопроса;

> **Примечание:** По клику на кнопку «Помощь» вы можете получить кратку справку по данному функционалу.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fstrk.io/knowledge_base/instructions/old/vizualnyi-konstruktor-chat-botov/konstruktor-anket.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.