Формы
Форма - универсальное средство приема данных от пользователей.
Настройки формы
Глобальные настройки, распространяются на всю форму.
| Функция | Описание |
|---|---|
| Переименовать | Название формы которое видно только админам |
| Условия | Доступны все предлагаемые платформой Условия |
| Лимит интервала | Ограничивает частоту прохождения формы. Можно проходить форму, не чаще чем раз в N времени |
| Заголовок | Текст, который будет отображаться сверху каждого поля |
| Пропуски полей | Пропуск полей без необходимости вводить или выбирать ответ |
| Сохранять результаты | Сохранение результатов пройденных форм |
| Сохранять историю ввода | Удаление или сохранение пройденных результатов форм |
| Обработка команд | Реагирование бота на команды во время прохождения формы. |
Поля формы
Поддерживаются 4 типа полей:
Инфо
Информационный пост, позволяющий отображать произвольный текст с кнопкой "далее".
Выбор
Текст
Поле принимающее текстовые данные от пользователя. Поддерживает следующие типы данных:
| Поле | Описание |
|---|---|
| Строка | Поле для приема текстовых сообщений. |
| Число | Поле для приема числовых значений. |
| Телефон | Поля для приема телефонных номеров. |
| Ссылка | Поле для приема любого типа ссылок (не путать с mention). |
| Юзернейм | Поле для приема юзернеймов |
| Дата | Поле для указания даты |
| Почта | Поле для приема адресов электронных почт. |
Строка
Поле для приема текстовых сообщений.
Примеры:
тексткастомный текстлюбой прозвольный текст
| Настройка поля | Описание |
|---|---|
| Минимум и Максимум | Определяет количество символов которое будет принимать поле. |
| Регулярное выражение | Можно использовать регулярное выражение. Подробнее о regEx |
| Форматированный текст | Поддержка и сохранение введенного форматированного текста. |
Число
Поле для приема числовых значений.
Примеры:
112345664562456
| Настройка поля | Описание |
|---|---|
| Минимум и Максимум | Определяет диапазон чисел которые будет принимать поле. Например: от 1 до 100. |
| Дробное число | Позволяет вводить данные типа 110.1, 56.47. |
Телефон
Поля для приема телефонных номеров.
| Режим | Описание |
|---|---|
| Предоставить номер | Предоставление номера с помощью кнопки. |
| Ввести номер Текстом | Опция позволяет пользователю отправить номер текстом. |
Почта
Поле для приема адресов электронных почт.
Пример:
mail@mail.ruya@ya.rumail@gmail.com
Юзернеймы
Поле принимает @username пользователей
Ссылка
Поле для приема любого типа ссылок.
Примеры:
enotpro.appt.megoogle.comvk.ruи т.д.
Медиа
| Поле | Описание |
|---|---|
| Image | Поле для приема изображений. |
| Video | Поле для приема видео. |
| File | Поле для приема файлов типа файл |
| Audio | Поле принимает аудио. |
| Voice | Поле принимает голосовые записи |
| Media | Поле для приема файлов типа медиа. |
| Sticker | Поле принимает стикеры |
Изображения
Поле для приема изображений.
Тип файлов:
jpgbnp
и т.д.
Лог: update.message.photo`
Видео
Поле для приема видео.
Тип файлов:
avimp4mkvи т.д.
Лог: update.message.video
Медиа
Поле для приема медиа.
Тип файлов:
jpgbnp
и т.д.
Лог: update.message.photo
Тип файлов:
avimp4mkv
и т.д.
Лог: update.message.video
Тип файлов:
mp3wavflac
и т.д.
Лог: update.message.audio
Файл
Поле для приема файлов типа документ
Тип файлов:
.doc.pdf.zip
и т.д.
Лог: update.message.document
Аудио
Поле принимает аудио.
Тип файлов:
mp3wavflac
и т.д.
Лог: update.message.audio
Голосовое
Поле принимает голосовые записи*
Стикеры
Поле принимает стикеры
Настройки поля
Общие настройки полей
| Функция | Описание |
|---|---|
| Включено | Включение/выключение поля |
| Условия | Ограничение доступности поля |
| Имя | Изменить техническое название поля |
| Ключ | Название поля используемое в контексте и в переменных |
| Текст | Изменить текст поля |
| Пропуск | Добавляет кнопку "пропустить поле", которая позволяет пропустить поле, не заполняя. |
| Файл | Изменить изображение поля |
Триггеры поля
Триггеры срабатывающие в каждом поле.
| Триггер | Описание |
|---|---|
| Триггер Подготовки Поля | Срабатывает при запуске поля, но до отображения поля пользователю |
| Триггер Обработки Поля | Срабатывает после получения значения введенного пользователем и до его сохранения |
| Триггер Поля | Срабатывает после Триггера Обработки Поля. |
| Триггер Пропуска | Срабатывает при пропуске поля |
| Триггер Ошибки | Срабатывает если введены данные несоответствующие условиям поля |
Триггеры формы
Общие триггеры формы
| Триггер | Описание |
|---|---|
| Триггер Старт | Триггер срабатывает первым и единожды при запуске формы. |
| Триггер Поля До | Триггер срабатывает перед запуском поля. Например, если вам нужно произвести какие-то расчета для дальнейшей работы, или же загрузить какие-то данные. |
| Триггер Поля После | Триггер срабатывает после принятия данных в форме. |
| Триггер Кнопки | Триггер срабатывает при нажатии на кнопки (поля типа select, choose, branch) |
| Триггер лимита количества | Триггер срабатывает при превышении лимита количества прохождений формы. |
| Триггер лимит времени | Триггер для ограничения частоты прохождения формы. Если выставить 1 час - форму можно будет проходить не чаще, чем раз в 1 час. |
| Триггер Отмена | Триггер отмены срабатывает после нажатия на кнопку "Отменить форму" |
| Триггер Финиш | В триггере финиша работает реакция formResult, которая отображает данные пройденной формы. |
Особенности
Maximum file size to download is 20 MB