Виджет предоставляет возможность размещения визуальных форм для сбора различных данных от пользователей. Это позволяет легко и эффективно организовать обратную связь, сбор информации и другие взаимодействия с клиентами.
Особенности использования форм:
- В блоке Вопрос обязательно должен быть текст, чтобы форма была активирована и правильно отображалась.
- Формы работают только в новом виджете, который доступен в личном кабинете.
- Можно создавать как собственные формы, так и использовать готовые шаблоны для упрощения процесса настройки и экономии времени.
- В формах можно настраивать валидацию данных через регулярные выражения. Подробнее о регулярных выражениях и способах их применениях читайте в статье Регулярные выражения.
¶ Подготовительные шаги
- Войдите в личный кабинет.
- Создайте сценарий бота.
- Создайте текстового бота, который будет отвечать вашим потенциальным клиентам в виджете.
- Разместите виджет на вашем сайте.
¶ Добавление формы обратной связи
-
Перейдите в раздел Сценарии ботов личного кабинета.
-
Нажмите на нужный сценарий. Откроется ранее созданный сценарий бота.
-
Перейдите к блоку Вопрос.
-
Откройте вкладку Действия в свойствах блока.
-
Выберите Добавить форму из выпадающего списка.
-
Выберите шаблон из выпадающего списка:
- Запрос имени и email — шаблон, который можно настроить по своему усмотрению. Собирает имя и адрес электронной почты пользователя.
- Запрос ФИО — шаблон, который можно настроить по своему усмотрению. Запрашивает полное имя пользователя, включая фамилию, имя и отчество.
- Запрос телефона — шаблон, который можно настроить по своему усмотрению. Собирает номер телефона пользователя.
- Запрос выбора — шаблон, который можно настроить по своему усмотрению. Собирает номер телефона пользователя.
- Создать свою — создание формы с нуля, добавляя произвольные поля и настраивая их по своему усмотрению.
Отобразится шаблон формы обратной связи, которую можно оставить или отредактировать.
- Введите произвольное название формы.
- (Опционально) Отредактируйте элементы формы. Для этого нажмите
в строке нужного элемента. - (Опционально) Нажмите +Добавить пункт, чтобы добавить новый элемент формы. Отобразится окно редактирования элемента.
- (Опционально) Зажмите
в нужной строке элемента и перетащите, чтобы изменить порядок в будущей форме обратной связи.
Отобразится пустой шаблон формы обратной связи, который необходимо отредактировать.
- Введите произвольное название формы.
- Отредактируйте элемент формы. Для этого нажмите в строке элемента.
- Выберите тип элемента.
При выборе типа Кнопка укажите только текст кнопки.
- Укажите переменную в поле Имя.
- Выберите тип данных из выпадающего списка.
- Введите название элемента, который будет отображаться клиенту. Название должно быть коротким и информативным.
- (Опционально) Введите короткое описание элемента, которое будет отображаться в поле элемента.
- Укажите, является ли поле обязательным для заполнения. По умолчанию поле считается обязательным.
- Введите пояснение к флажку, которое будет отображаться рядом с ним.
- (Опционально) Нажмите Добавить правило валидации.
- Добавьте код для проверки регулярного выражения в поле Значение. Более подробно о регулярных выражениях и их примерах читайте в статье Регулярные выражения.
- Введите текст в поле Сообщение, который будет отображаться, если введенное значение не соответствует шаблону регулярного выражения.
- Нажмите Готово.
- Нажмите +Добавить пункт, чтобы добавить новый элемент формы. Отобразится окно редактирования элемента.
- Повторите действия с шага 8 при необходимости.
Чтобы взаимодействовать с формой, добавьте хотя бы одну кнопку. При нажатии на нее отправляется сообщение в чат. Таких кнопок может быть несколько, но все они будут выполнять только действие по отправке сообщения в чат.
- (Опционально) Зажмите в нужной строке элемента, чтобы изменить порядок в будущей форме обратной связи.
¶ Удаление ненужной формы
- Перейдите в раздел Сценарии ботов личного кабинета.
- Нажмите на нужный сценарий. Откроется редактор сценария бота.
- Нажмите на блок Вопрос, в котором есть форма. Откроются свойства блока.
- Перейдите на вкладку Действия.
- Нажмите на
в секции Использовать форму. Форма будет удалена. - Сохраните сценарий.
¶ Использование переменных из формы в сценарии
У каждого элемента формы обратной связи есть своя переменная. Чтобы посмотреть имя переменной, нажмите напротив интересующего элемента. Имя переменной указано в поле Имя.
Для извлечения данных, собранных через форму, используйте переменную вида {clientMetadata.values.имя_переменной}. Это позволяет удобно обрабатывать и интегрировать полученные данные в дальнейшие процессы.