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

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

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

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

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2Fu4hCrClnZ2T0wiEfFUp0%2F2708242623.png?alt=media&#x26;token=a92f1e3b-f150-4815-8cef-580d89b3eeb2" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FHi70AXH0ngVgfJ5tozQQ%2F2708242629.png?alt=media&#x26;token=45102a6b-d069-46aa-8474-2c9b613426ee" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FVO064YN6nbUP1CwBf2t2%2F2708242635.png?alt=media&#x26;token=c550c1ae-b85b-4bbf-8019-0ee76305c948" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FKkMnTyWwe9wxLEGBmFVE%2F2706473133.png?alt=media&#x26;token=9b611878-e5cc-4d1f-bbcf-e19f8fbdc383" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FQbeBJZFa5yDV3m6s7KAX%2F2706473139.png?alt=media&#x26;token=9dff830c-899c-4cf1-8741-5acafa429cbb" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FdQZLDvuekZs0KxPWjiEW%2F2708373734.png?alt=media&#x26;token=38e8fab9-476c-4dff-a982-79d66610390b" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FkEoRJjDVuU93EZM0lUIF%2F2708242649.png?alt=media&#x26;token=fc6b65a5-5ebc-4de5-8949-7a597e1b0e2d" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FiqONrPrZT8DgHZqdaXzS%2F2708209866.png?alt=media&#x26;token=5d546edb-9375-4a3d-925f-abb776652679" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FwIJpq6lR2pniHc7oOU1n%2F2708373744.png?alt=media&#x26;token=2c15ca67-e848-4cd5-83cf-58698321c098" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FdgxypWwLQsKT6CIdfZPA%2F2708373752.png?alt=media&#x26;token=2aaeecf9-09c7-4601-baff-6a400f348a91" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2Fg8alqAgqSxE1CqzIihva%2F2708242661.png?alt=media&#x26;token=789805ad-f512-49bc-8fa7-d5663ad9c7dc" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FiDxYCSLJnsoOTkbVVFXl%2F2708209874.png?alt=media&#x26;token=572a7214-cf5c-4831-94c2-d9227063f9f5" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2Fm2JiL8XM06f5MViwaqBG%2F2708373760.png?alt=media&#x26;token=3ad9d527-b7ab-4a64-bd00-538f4c947f28" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2F5sNUEnAQi6enrxrwvzXU%2F2706473155.png?alt=media&#x26;token=aad4e1fc-e989-4465-8c23-91c836b89adb" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FzvnwrhvPHCcvrF29ER8G%2F2708242671.png?alt=media&#x26;token=afbc310d-bd4c-4e89-bd9d-6824c0f0caeb" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FK7fYUBZw0FgiLzT8Y4ZQ%2F2708373772.png?alt=media&#x26;token=4091a587-41a7-40ba-904f-3be7b310006f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FGFRCQ4VykSIbaZ9vxAF5%2F2708373778.png?alt=media&#x26;token=d64b6969-0c6d-4dcc-bdb8-83469a6e60a6" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2F3sSxEfft2GIv1eoZKh93%2F2708209886.png?alt=media&#x26;token=de2c94fd-88ac-4968-af8b-e775ed68741c" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FFtv9oQmIdEGI9E9RNkEh%2F2708209892.png?alt=media&#x26;token=87f7513b-d779-4b2f-a306-0d7c6100034b" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FxEgM56B3P9IOZkSrXs2c%2F2708373788.png?alt=media&#x26;token=b246f233-3009-43aa-8171-e248f4c6c180" alt=""><figcaption></figcaption></figure>

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

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

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