> 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="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FFIP8b3INX5VVW2Mg9aZN%2F2943582213.png?alt=media&amp;token=60684ca8-2f41-4cba-a280-978407125296" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2Fl6tBrnSaMcClnLpxuP5u%2F2943418377.png?alt=media&amp;token=69f5ee49-204d-4cee-90f7-d4410d6b0018" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FEeyNm5nEUxa7mmvH7Zfb%2F2943680513.png?alt=media&amp;token=c7e1fe9b-3b37-4f9e-8529-fa8466db4d04" 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%2FJGNz6vPuAJY78s0g5L86%2F2943746051.png?alt=media&amp;token=ec1628c3-5fab-4392-b3dc-feffcd824f3d" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2F9yeODRzvVb57OoW1zbtD%2F2943582221.png?alt=media&amp;token=1dc01b4b-6400-41a5-89ac-93e5167ae624" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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

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

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

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FaA69YB2cVu3rnV3HEZ1j%2F2944008198.png?alt=media&amp;token=79cd5820-9367-4a13-a083-62a37456d9e9" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FRNNw1GdbvecqL2psBUSR%2F2944335873.png?alt=media&amp;token=33569573-5ea1-4780-adb9-c4eef529cd5c" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2Fi47qb6WwDa6HuwmAsEx7%2F2946727937.png?alt=media&amp;token=c586d4d7-6c74-4100-81f7-3191c84d5e19" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2Fd9FSU5EoEUQmZTAamodn%2F2944303107.png?alt=media&amp;token=e3b44376-e53e-4396-8151-01de28488aa0" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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

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

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

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

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

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2Fm7JVIdlV0z45qrjBZLQl%2F2943975429.png?alt=media&amp;token=ad59107e-f25a-4885-9441-f7589b0d1e1e" alt=""><figcaption></figcaption></figure>

#### Google Analytics

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

#### Facebook Pixel

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

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

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

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FPNggQtIfL2tOf2Opg3EA%2F2944630785.png?alt=media&amp;token=c19cce4c-9144-40d3-a72d-a513f73bc016" 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="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2Fyc2ndO1eaioxiM95h5vj%2F2944598020.png?alt=media&amp;token=d9764a59-2a26-468e-b55f-26bb6f49b6dd" alt=""><figcaption></figcaption></figure>