> For the complete documentation index, see [llms.txt](https://docs.fstrk.io/knowledge_base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fstrk.io/knowledge_base/instructions/old/razdel-marketing/formy-dlya-chat-bota.md).

# Формы для чат-бота

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

* Перейдите в раздел «Маркетинг», а затем на вкладку «Формы для бота»
* Вы окажетесь на странице со списком всех форм для бота, созданных в рамках текущего проекта. Здесь можно добавить новую форму, отредактировать существующую, а также скопировать теги, которые понадобятся для вызова или получения данных конкретной формы.

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

## Новая форма для бота

* Нажмите «+ Форм для бота» в правом верхнем углу страницы со списком форм.
* Откроется модальное окно, где обязательно нужно ввести название и придумать уникальный идентификатор формы. В последствии эту информацию можно будет отредактировать.
* Нажмите «Создать», чтобы перейти к настройкам формы.

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

1. Название - наименование формы для отображения в общем списке и поиска;
2. Короткое описание - поле для дополнительной информации, отображается в общем списке рядом с названием (Необязательное поле);
3. Уникальный идентификатор - нужен для работы с определенной формой в контексте пользователя.

Прекрасно 🎉 Новая форма создана, теперь ее нужно настроить.

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

Настройки: Общие настройки для формы## Настройки

Общие настройки для формы

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

Язык - Язык интерфейса веб-формы.

Заголовок для браузера - Название, которое отображается на вкладке браузера.

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

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

Получать уведомления на email - Возможность получать на почту оповещения о каждой заполненной форме.

> **Примечание:** Связанные сценарии не сработают, если закрыть веб-страницу с формой через интерфейс телефона или браузера.

> **Примечание:** Кнопка «Сохранить изменения» опубликует внесенные изменения без дополнительного подтверждения. Учитывайте это, если ваша форма уже доступна для пользователей.

Конструктор: Визуальный редактор веб-страницы с формой## Конструктор

Визуальный редактор веб-страницы с формой

Данные с форм: Список заполненных форм## Заполненные формы

Список заполненных форм

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

**Экземпляр формы:** Последний сохраненный вариант формы, который напрямую связан с пользователем, который ее заполнил.

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

* В списке отображены все сохраненные формы и связанные с ними пользователи.
* Чтобы отфильтровать формы по дате последнего изменения - введите необходимый интервал (от - до) и нажмите «Применить»\*\*\*\*справа вверху над списком.
* **Дата создания** - Дата и время, когда пользователь первый раз заполнил форму форму
* **Дата обновления** - Дата и время последнего сохраненного изменения
* **Чат** - Пользователь, с которым связан экземпляр формы
* **Кнопки действия:**
* Переход к истории сообщений пользователя в чат-центре
* Удалить экземпляр формы связанный с пользователем
* Показать список полей и сохраненных значений

**Данные форм**

Нажмите **ᐯ**, чтобы посмотреть сохраненные значения для полей формы

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

**Экспорт форм**

* Нажмите «Экспорт» слева над списком с экземплярами форм
* Введите адрес электронной почты, на которую будет отправлен файл.

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

На почту придёт письмо с экспортированным файлом в формате **.CSV**

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

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

Webhook и API: Прием данных из форм на свой скрипт## Webhook и API

Прием данных из форм на свой скрипт

* При заполнении формы данные будут отправляться методом POST на адрес скрипта, который вы указали.

Скоринг: Система оценки данных заполненных форм## Скоринг

Система оценки данных заполненных форм

**Категория скоринга** - Кастомный атрибут формы для расчета оценки

**Правило скоринга** - Условие распределения оценки для категории скоринга

**Оценка** - Количество баллов (Число)

> **Примечание:** Скоринг позволяет настраивать правила распределения баллов для категорий скоринга

Скоринг: Модель распределения баллов, в зависимости от сохраненных значений полей формы

Аналитика: Подключение Google Analytics и Facebook Pixel## Аналитика

Подключение Google Analytics и Facebook Pixel

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

#### Google Analytics

Получайте события о заполненных формах в Google Analytics

#### Facebook Pixel

Добавив Pixel ID, вы начнете получать события о заполненных формах в бизнес-менеджер Facebook.

### Управление формами для бота в конструкторе

Открытие формы по кнопке:

<figure><img src="/files/5quYpAuUXugg6xmxifyV" alt=""><figcaption></figcaption></figure>

#### Скрыть ранее сохраненные значения

initial: True / False

По умолчанию True

#### Удаление данных формы

\- тег для удаления (окончательно) данных, которые пользователь заполнял ранее

#### Предзаполнить форму

```
{% createobj test_name %}

{
  "field_name_1": "value_1",
  "field_name_2": "value_2" 
}

{% endcreateobj %}
```

default

#### Скрываем старые данные и подставляем новые

#### Получение данных формы

* здесь хранятся данные заполненной формы

Доступные свойства:

* data.data - Данные формы (Ключ: Значение)
* data.default - Последние сохраненные дефолтные значение (лучше вырезать - не нужно)
* data.created\_at - Дата первого заполнения формы (Попросить Лешу поправить)
* data.updated\_at - Дата последнего заполнения формы
* data.scoring

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