# Формы для чат-бота
* Перейдите в раздел «Маркетинг», а затем на вкладку «Формы для бота» * Вы окажетесь на странице со списком всех форм для бота, созданных в рамках текущего проекта. Здесь можно добавить новую форму, отредактировать существующую, а также скопировать теги, которые понадобятся для вызова или получения данных конкретной формы.
## Новая форма для бота * Нажмите «+ Форм для бота» в правом верхнем углу страницы со списком форм. * Откроется модальное окно, где обязательно нужно ввести название и придумать уникальный идентификатор формы. В последствии эту информацию можно будет отредактировать. * Нажмите «Создать», чтобы перейти к настройкам формы.
1. Название - наименование формы для отображения в общем списке и поиска; 2. Короткое описание - поле для дополнительной информации, отображается в общем списке рядом с названием (Необязательное поле); 3. Уникальный идентификатор - нужен для работы с определенной формой в контексте пользователя. Прекрасно 🎉 Новая форма создана, теперь ее нужно настроить.
Настройки: Общие настройки для формы## Настройки Общие настройки для формы
Язык - Язык интерфейса веб-формы. Заголовок для браузера - Название, которое отображается на вкладке браузера. Посадочный узел если форма заполнена - Сценарий, в который попадет пользователь, после сохранения формы. Посадочный узел для закрытия страницы без сохранения формы - Сценарий, в который попадет пользователь в случае отмены сохранения формы. Получать уведомления на email - Возможность получать на почту оповещения о каждой заполненной форме. > **Примечание:** Связанные сценарии не сработают, если закрыть веб-страницу с формой через интерфейс телефона или браузера. > **Примечание:** Кнопка «Сохранить изменения» опубликует внесенные изменения без дополнительного подтверждения. Учитывайте это, если ваша форма уже доступна для пользователей. Конструктор: Визуальный редактор веб-страницы с формой## Конструктор Визуальный редактор веб-страницы с формой Данные с форм: Список заполненных форм## Заполненные формы Список заполненных форм
**Экземпляр формы:** Последний сохраненный вариант формы, который напрямую связан с пользователем, который ее заполнил. > **Примечание:** У одного пользователя может быть только один сохраненный экземпляр формы. * В списке отображены все сохраненные формы и связанные с ними пользователи. * Чтобы отфильтровать формы по дате последнего изменения - введите необходимый интервал (от - до) и нажмите «Применить»\*\*\*\*справа вверху над списком. * **Дата создания** - Дата и время, когда пользователь первый раз заполнил форму форму * **Дата обновления** - Дата и время последнего сохраненного изменения * **Чат** - Пользователь, с которым связан экземпляр формы * **Кнопки действия:** * Переход к истории сообщений пользователя в чат-центре * Удалить экземпляр формы связанный с пользователем * Показать список полей и сохраненных значений **Данные форм** Нажмите **ᐯ**, чтобы посмотреть сохраненные значения для полей формы
**Экспорт форм** * Нажмите «Экспорт» слева над списком с экземплярами форм * Введите адрес электронной почты, на которую будет отправлен файл.
На почту придёт письмо с экспортированным файлом в формате **.CSV**
> **Примечание:** При экспорте не учитывается фильтрация списка экземпляров форм, файл будет содержать все заполненные формы. Webhook и API: Прием данных из форм на свой скрипт## Webhook и API Прием данных из форм на свой скрипт * При заполнении формы данные будут отправляться методом POST на адрес скрипта, который вы указали. Скоринг: Система оценки данных заполненных форм## Скоринг Система оценки данных заполненных форм **Категория скоринга** - Кастомный атрибут формы для расчета оценки **Правило скоринга** - Условие распределения оценки для категории скоринга **Оценка** - Количество баллов (Число) > **Примечание:** Скоринг позволяет настраивать правила распределения баллов для категорий скоринга Скоринг: Модель распределения баллов, в зависимости от сохраненных значений полей формы Аналитика: Подключение Google Analytics и Facebook Pixel## Аналитика Подключение Google Analytics и Facebook Pixel
#### Google Analytics Получайте события о заполненных формах в Google Analytics #### Facebook Pixel Добавив Pixel ID, вы начнете получать события о заполненных формах в бизнес-менеджер Facebook. ### Управление формами для бота в конструкторе Открытие формы по кнопке:
#### Скрыть ранее сохраненные значения 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
--- # 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/razdel-marketing/formy-dlya-chat-bota.md?ask= ``` 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.